OpenHuman Guide
← Back to Guides

OpenHuman Installation Guide — All Methods (Homebrew / apt / MSI / Script)

OpenHuman is an open-source desktop AI assistant for macOS, Windows, and Linux. Install via your system package manager, download an installer, or use the one-liner script.

⚡ Installation priority

  1. System package manager (Homebrew / apt / AUR) — most secure, uses built-in signing
  2. Download installer (DMG / EXE / DEB) — easiest, one-click install
  3. One-liner script (curl | bash / irm | iex) — convenient but check safety notes
  4. Build from source — for developers and early adopters

System Requirements

  • OS: macOS 12+ / Windows 10+ / Linux Kernel 5.x+
  • RAM: 4GB+ recommended, 16GB+ for large mailboxes or local models
  • Disk: 2GB+ free space

On first launch, your OS may prompt for permissions (Accessibility on macOS, mic/camera for Meeting Agent). You can adjust these anytime under Settings → Automation & Channels.

Method 1: System Package Manager (Recommended)

macOS — Homebrew

brew tap tinyhumansai/openhuman
brew install openhuman

Linux (Debian/Ubuntu) — Signed apt repo

# Install prerequisites
sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates

# Add the signing key
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg

# Add the repository
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list

# Install
sudo apt-get update
sudo apt-get install -y openhuman

Linux (Arch Linux) — AUR

yay -S openhuman-bin

Method 2: Download Installer

Visit tinyhumans.ai/openhuman and pick your platform:

macOS (DMG)

Download the .dmg file, mount it, and drag OpenHuman into Applications. Apple Silicon (M1-M4) and Intel both supported.

Windows (MSI)

Download the signed .msi installer and double-click to run. The installer completes in about 1-2 minutes.

Linux (DEB / AppImage)

  • DEB: For Debian/Ubuntu. Download and run sudo dpkg -i *.deb.
  • AppImage: Universal format. chmod +x and run.

⚠ Note: AppImage may crash on Wayland (see Issue #2463). Prefer the DEB package.

All installers are also available on GitHub Releases.

Method 3: One-liner Script

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

⚠ Security note: These scripts are served live from raw.githubusercontent.com without separate signature verification. Prefer the package manager method for signed installation. GPG verification for scripts is under development (PR #2620).

Method 4: Build from Source

Prerequisites

  • Git, Node.js 24+, pnpm 10.10.0
  • Rust 1.93.0 (rustfmt + clippy), CMake, Ninja, ripgrep
  • Platform-specific Tauri build dependencies

Build steps

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
pnpm dev          # Web UI dev mode
# or: pnpm --filter openhuman-app dev:app  # Desktop app mode

First Launch

  1. Sign in: "Sign in! Let's Cook" screen supports social login and custom backend RPC.
  2. Connect integrations: One-click OAuth for Gmail, GitHub, Notion, and 118+ services.
  3. Auto-sync: Auto-fetch pulls data every 20 minutes into your Memory Tree.
  4. Voice setup: Configure mic and TTS if desired.

🔐 Sign-in ≠ data access

Signing in authenticates your account. It does not grant OpenHuman access to your data. Each integration requires explicit OAuth approval. Your Memory Tree, wiki, and config stay on your machine.

How to Uninstall

  • Homebrew: brew uninstall openhuman then brew untap tinyhumansai/openhuman
  • Debian: sudo apt-get remove openhuman
  • Windows: Control Panel → Programs → Uninstall OpenHuman
  • Script: Remove ~/.openhuman (or %LOCALAPPDATA%\\openhuman)