OpenHuman Installation Guide: Windows, macOS, Linux

OpenHuman is an open-source desktop personal AI assistant. It offers three installation methods: installer package, one-command terminal installation, and building from source. This guide covers all platforms.

Windows Installation

Download the Windows EXE installer from the official website and double-click to run.

Double-click the .exe file after download
If Windows shows a security warning, click "Run anyway"
The installer completes in about 1-2 minutes
An OpenHuman icon will appear on your desktop

Requires Windows 10+ and at least 4GB RAM.

macOS Installation

Download the macOS DMG package, double-click to mount, and drag OpenHuman into the Applications folder.

On first launch, go to System Settings → Privacy & Security to allow the app
Supports both Apple Silicon (M1/M2/M3) and Intel chips
Requires macOS 12+

Linux One-Command Installation

Run a single command to install:

curl -fsSL https://get.openhuman.cn | bash

The script auto-detects your Linux distribution, installs dependencies, and configures the runtime environment.

Building from Source

Clone the repository and build manually:

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
npm install -g pnpm@10.10.0
pnpm install
pnpm dev

Requires Node.js 24+ and the Rust toolchain (OpenHuman uses Tauri with a Rust backend). First build takes 10-15 minutes.

Post-Installation Setup

After installation, OpenHuman shows a guided setup:

OAuth connect your Gmail, GitHub, Notion, and other accounts
Configure model API keys (optional — built-in models work out of the box)
Enable Auto-fetch for automatic data sync
Set up voice and desktop mascot preferences

From installation to first conversation: about 5 minutes.

Troubleshooting

App won't open after installation

Check system requirements (Windows 10+ / macOS 12+ / Linux kernel 5.x+). If met, try re-downloading the installer.