OpenHuman Guide
← Back to Guides

How to Build OpenHuman from Source — Developer Install Guide

Building OpenHuman from source is for developers who want to customize the app, contribute to the project, or try pre-release features.

Prerequisites

  • Git — version control
  • Node.js 24+ — JavaScript runtime
  • pnpm 10.10.0+ — package manager
  • Rust 1.93.0+ with rustfmt and clippy
  • CMake & Ninja — C/C++ build tools
  • ripgrep (rg) — code search
  • Platform-specific Tauri build dependencies (see Tauri docs)

Clone & build

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 dev mode

Production build

pnpm build # or: pnpm --filter openhuman-app build:app

Common issues

  • pnpm not found: Install via npm install -g pnpm
  • Rust errors: Ensure rustup is up to date: rustup update
  • Tauri build fails: Check platform-specific prerequisites
  • Missing submodules: Run git submodule update --init --recursive