OpenHuman 从源码编译安装教程 — 体验最新特性

如果预编译的安装包无法满足你，或者你想体验最新开发特性——你可以从 GitHub 源码自行编译 OpenHuman。本文详细说明每个平台的编译步骤。

⚠️ 从源码编译主要用于尝鲜和二次开发。普通用户请使用官方安装包。

前提条件

Node.js：24+（推荐 24 LTS）
pnpm：10.10+
Rust：1.80+（安装 rustup）
Git

安装 Rust 工具链

如果还没安装 Rust：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Windows 用户建议从 rustup.rs 下载安装器。

macOS 额外依赖

需要安装 WebKit2GTK 和其他系统库：

brew install gtk+3 webkit2gtk

Linux 额外依赖

# Ubuntu/Debian
sudo apt-get install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

# Arch Linux
sudo pacman -S webkit2gtk base-devel curl wget file openssl appmenu-gtk-module gtk3

Windows 额外依赖

安装 Visual Studio Build Tools 或 Visual Studio 2022（勾选"使用 C++ 的桌面开发"工作负载）。

克隆并编译

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
npm install -g pnpm@10.10.0
pnpm install
pnpm tauri dev   # 开发模式
# 或
pnpm tauri build # 生产构建

编译时间

首次编译（含 Rust 依赖下载）：约 15-25 分钟
增量编译：约 2-5 分钟
生产构建：约 10-15 分钟

更新到最新

cd openhuman
git pull --rebase
pnpm install
pnpm tauri build

开发注意事项

dev 模式有热更新，修改前端代码后自动刷新
Rust 后端修改后需要手动重启
编译错误多数是因为缺少系统依赖或 Rust 版本不匹配
Windows 使用 MSVC 工具链，Linux 使用 GCC