OpenHuman — 搭建 · 部署

🖥️ 系统要求

以下为从源码构建时的开发依赖。普通用户直接下载安装包无需额外配置。

🟩

Node.js

>= 24.0.0

前端构建运行时（Vite + React）

📦

pnpm

10.10.0

Monorepo 包管理器，精确版本锁定

🦀

Rust Toolchain

1.93.0+

需要 rustfmt + clippy 组件

🔧

CMake + Ninja

系统安装

Tauri 原生模块编译依赖

🔍

ripgrep (rg)

系统安装

代码搜索工具，智能 grep 功能依赖

🪟

平台构建工具

视平台而定

macOS: Xcode CLT · Windows: MSVC · Linux: gcc/clang

⬇️ 安装方式

✅

推荐普通用户使用。访问 tinyhumans.ai/openhuman，下载对应平台的安装包（DMG / EXE），安装后即可使用，无需任何额外配置。

下载地址

# 官网下载（推荐）
https://tinyhumans.ai/openhuman

# macOS  → openhuman-v0.54.0-aarch64.dmg
# Windows → openhuman-v0.54.0-x64-setup.exe

ℹ️

一行命令安装，脚本会自动检测平台架构（x64 / ARM），下载并配置到 /usr/local/bin。

macOS / Linux — Shell 脚本

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

ℹ️

在 PowerShell（管理员）中运行，脚本会下载并静默安装。

Windows — PowerShell

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

1

克隆仓库（含子模块）

bash

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive

2
安装 Node 依赖
bash
```
pnpm install
```

3

启动开发模式（桌面 App）

bash

# 仅前端 Web UI
pnpm dev

# 完整桌面 App（Tauri + Rust 后端）
pnpm --filter openhuman-app dev:app

4
构建生产版本
bash
```
pnpm --filter openhuman-app build
```
输出到 app/src-tauri/target/release/bundle/

⚙️ 配置文件

OpenHuman 使用 config.toml 管理所有运行时配置，位于用户数据目录下。

config.toml — 核心配置示例

# 内存后端 (默认 SQLite，可切换 agentmemory)
[memory]
backend = "sqlite"    # 或 "agentmemory"

# 自动拉取间隔（分钟）
[scheduler]
autofetch_interval_mins = 20

# LLM 模型路由
[inference]
default_provider = "openai"  # openai / anthropic / local
local_model_path = ""

# 语音配置
[voice]
tts_provider = "elevenlabs"
stt_model    = "whisper"

# 存储路径（可自定义）
[storage]
vault_dir  = "~/.openhuman/vault"   # Obsidian 兼容 Markdown 目录
db_path    = "~/.openhuman/memory.db"

配置项	默认值	说明
`memory.backend`	`sqlite`	本地 SQLite（FTS5 + 向量表）或外部 agentmemory 服务
`scheduler.autofetch_interval_mins`	`20`	定时从所有已连接账户拉取新数据的间隔
`inference.default_provider`	`openai`	主 LLM 提供商，支持 openai / anthropic / local / openai_oauth
`voice.tts_provider`	`elevenlabs`	文字转语音服务，ElevenLabs 提供唇形同步
`storage.vault_dir`	`~/.openhuman/vault`	Obsidian 兼容的 Markdown 笔记目录

🔗 第三方集成（118+）

首次启动后，通过「Settings → Integrations」一键 OAuth 授权，OpenHuman 即可自动同步以下服务的数据到本地 Memory Tree。

📧Gmail

📅Google Calendar

📄Google Drive

💬Slack

🐙GitHub

📝Notion

💳Stripe

📋Linear

🎯Jira

💬Discord

📱Telegram

💬WhatsApp

📊Airtable

🔵Microsoft Teams

📧Outlook

+102更多...

🔒

隐私保证：所有数据均存储在本地 SQLite 数据库（~/.openhuman/memory.db），不上传第三方服务器。OAuth Token 通过 AES-GCM + Argon2 加密存储在本地 credentials 模块中。

🛠️ 开发环境完整配置

macOS 一键准备（Homebrew）

# 安装系统依赖
brew install cmake ninja ripgrep

# 安装 Rust 工具链
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup component add rustfmt clippy

# 安装 Node.js 24 (via nvm 或 fnm)
brew install fnm
fnm install 24
fnm use 24

# 安装 pnpm
npm i -g pnpm@10.10.0

# 克隆并安装
git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman && git submodule update --init --recursive
pnpm install

📟 命令参考

pnpm dev

启动 Web UI 开发服务器（Vite HMR）

pnpm --filter openhuman-app dev:app

完整桌面 App 开发模式（Tauri + Rust）

pnpm typecheck

TypeScript 类型检查

pnpm format:check

代码格式校验（Prettier）

pnpm --filter openhuman-app build

构建生产安装包

cargo test --workspace

运行全部 Rust 单元测试

cargo clippy --workspace

Rust lint 检查

cargo fmt --all

Rust 代码格式化

安装 · 配置 · 运行

🖥️ 系统要求

⬇️ 安装方式

⚙️ 配置文件

🔗 第三方集成（118+）

🛠️ 开发环境完整配置

📟 命令参考