Files
openhuman/docs
..

OpenHuman

The Tet

tinyhumansai%2Fopenhuman | Trendshift OpenHuman - An open source AI harness built with the human in mind | Product Hunt OpenHuman - An open source AI harness built with the human in mind | Product Hunt

OpenHuman - An open source AI harness built with the human in mind | Product Hunt OpenHuman - An open source AI harness built with the human in mind | Product Hunt

OpenHuman 是你的个人 AI 超级智能:一颗记得一切的大脑、一位出色的编排者、一名深度研究员。本地优先,简洁而强大。

DiscordRedditX/Twitter文档关注 @senamakel(作者)

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇩🇪 Deutsch | 🇵🇰 اردو

早期测试版 最新版本 GitHub Stars 许可证 English 日本語 한국어 Deutsch اردو

早期测试版:正在积极开发中,可能存在不完善之处。

🎉 发布仅一周内,OpenHuman 便登顶 GitHub 全站趋势榜第一名,并连续九天保持榜首。

安装

tinyhumans.ai/openhumanGitHub Releases 页面下载安装包。若在终端中安装,推荐使用下面的原生软件包路径,它们会尽可能利用你的操作系统包管理器或原生安装器。

推荐安装方式(原生软件包)

以下路径使用原生安装器。Homebrew 和 MSI 自带常规的签名/完整性校验;Debian/Ubuntu 通过 apt-get 安装发布的 .deb 并解析系统依赖。

macOSHomebrew tap):

brew tap tinyhumansai/core
brew install openhuman

LinuxDebian/Ubuntu — 发布版 .deb):

# Download OpenHuman_<version>_amd64.deb or OpenHuman_<version>_arm64.deb
# from https://github.com/tinyhumansai/openhuman/releases/latest, then:
# Replace amd64 with arm64 on arm64 hosts.
sudo apt-get install -y --no-install-recommends ./OpenHuman_*_amd64.deb

LinuxArch — AUR):openhuman-bin AUR 配方已收录在仓库中。发布后,Arch 用户可以通过 yay -S openhuman-bin 安装。

**Windows**从最新发布页下载已签名的 .msi 并运行。

**手动安装 .dmg / .deb / .AppImage / .msi**直接从最新发布页获取适用于你平台的安装包。

**Linux**AppImage 在 Wayland 下启动时可能崩溃、缺少 libgbm.so.1 等宿主系统库,或在基于 Arch 的发行版上报 sharun: Interpreter not found! 错误——原因和环境变量绕过方案见 #2463。上面的 .deb 软件包让 apt 解析运行时依赖,在 Debian/Ubuntu 上可避免这些故障。

备选:脚本安装(无完整性校验)

警告——未经校验的安装方式。这些脚本直接从 raw.githubusercontent.com 实时提供,且附带独立签名,因此 curl … | bashirm … | iex 无法检测脚本字节是否被篡改。请尽量优先使用上面的原生软件包路径。如果你必须使用脚本安装,请参阅下方"已验证脚本安装"。

# macOS or Linux x64
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

在 Debian/Ubuntu 上,install.sh 会优先解析最新发布的 .deb 并通过 apt-get 安装,由 apt 处理运行时依赖。设置 OPENHUMAN_INSTALLER_LINUX_PACKAGE=appimage 可强制使用 AppImage 路径。

已验证脚本安装的现状

目前尚未提供带独立签名的脚本安装路径。Issue #2620 在原生软件包路径成为首选方案后已关闭,但当前发布资产中不包含用于执行前脚本校验的 install.sh.asc / install.ps1.asc。请将脚本安装路径视为未经校验,并尽可能优先使用上面的原生软件包选项。

什么是 OpenHuman

OpenHuman 是大多数助手所不具备的三样东西的集合:一颗大脑,为你的世界构建持久的本地记忆;一位出色的编排者,在持久化的图上调度成群的智能体;以及一名深度研究员,在你话音未落之前就已扫遍你的数据和整个网络。每条要点都链接到文档中更详细的说明。

🧠 大脑

  • 记忆树 + Obsidian Wiki:你的数据被压缩为带评分的 Markdown 树,存储在你本机的 SQLite 中,并镜像为一个你可以打开和编辑的 Obsidian 仓库。没有向量浓汤式的黑箱。
  • 100+ OAuth 集成、5,000+ MCP 服务器、90,000+ Skills:一键接入 Gmail、Notion、GitHub、Slack 以及你技术栈中的其他服务。自动拉取每 20 分钟为大脑输送养分——它在今天早上就已经拥有明天的上下文。
  • 潜意识:一个后台循环,持续比对你的世界的变化、推进你的目标,并为你撰写晨间简报——在你停止输入之后,思考仍在继续。
  • 目标与待办:长期目标、持久化的会话级目标,以及每个对话共享的看板。
  • TokenJuice:工具输出在触达模型之前先被压缩——信息不变,token 最多减少 80%。没有它,这么大的一颗大脑将贵得用不起。

🕸️ 编排者

  • Workflows (新):智能体提出自动化方案;你在画布上审阅并保存。持久化、触发器驱动、审批把关的运行,基于开源的 tinyflows
  • 能把事情做完的执行框架 (新):基于开源 tinyagents 的检查点式图运行——卡住的智能体会被引导回正轨,中止的会交回根因,每次运行都可回放并附带真实的每次调用成本。
  • 常驻的分脑 (新):一个快速反应智能体负责分流入站流量,一个深度推理核心负责向工作者舰队分派任务,由潜意识统一调度。
  • 智能体经济:在 tiny.place 上的 @handle、Signal 加密的智能体间编排、x402 USDC 赏金与交易——密钥永不落盘。

🔬 深度研究员与实干家

  • SuperContext:在模型读取你的第一条消息之前,一个研究侦察器会先扫描你的记忆和文件。没有冷启动。
  • 开箱即用:网络搜索、抓取器、编码工具集、真正的浏览器、带进程内 Whisper 的原生语音——以及为每个工作负载挑选合适 LLM 的模型路由,一个订阅,本地 AI 可选
  • 会议智能体 (新):带着一张脸和一副嗓音加入 Meet、Zoom、Teams 和 Webex——根据日历自动入会、实时输出转写字幕、被点名时回答、归档摘要和行动项。
  • 图像与视频生成 (新)Seedream/SeedEdit 图像和 Seedance/Veo 视频,直接输出到你的工作区,同一份订阅。
  • 17 个消息渠道Telegram、Discord、Slack、WhatsApp、Signal、iMessage……外加原生邮件IMAP IDLE + SMTP)。无论你在哪里,智能体都能找到你。

🧍 人性化、私密、属于你

  • 简洁、UI 优先、人性化:从安装到拥有一个可用的智能体仅需几次点击——无需配置文件,无需终端。它还有一张脸:一个会说话、会回应、记得你的吉祥物。
  • 隐私与安全:设备端加密数据、审批关卡、操作系统钥匙串密钥、可选沙箱——以及 (新) 隐私模式:一个开关,任何推理都不会离开你的机器,由 Rust 核心强制执行。
  • 主题与主题工作室:五套主题系列,外加完整的可视化编辑器,可导出为 JSON。

从源码贡献

新贡献者?从 CONTRIBUTING.md 了解 fork/PR 工作流和本地验证命令,或使用 CONTRIBUTING-BEGINNERS.md 中可直接复制粘贴的 AI 智能体提示词。快速路径:

  1. 安装 Git、Node.js 24+、pnpm 10.10.0、Rust 1.93.0rustfmt + clippy)、CMake、Ninja、ripgrep,以及各平台桌面构建的前置依赖。
  2. Fork 并克隆仓库,然后运行 git submodule update --init --recursive 之后再执行 pnpm install,确保内置的 Tauri/CEF 源码就位。
  3. 使用 pnpm dev 进行纯 Web UI 开发,pnpm --filter openhuman-app dev:app 用于桌面壳,在提交 PR 之前运行针对性的检查如 pnpm typecheckpnpm format:checkcargo check -p openhuman --lib

更多文档:架构 · 环境搭建 · 云端部署

几分钟内建立上下文,而非数周

OpenHuman 是首个能在几分钟内了解你的智能体框架。灵感来源于 Karpathy 的 LLM 知识库。大多数智能体从零开始。Hermes 通过观察你的工作来学习;OpenClaw 等待插件输送上下文。无论哪种方式,你都需要花费数天甚至数周时间,智能体才能对你的技术栈有足够的了解从而真正发挥作用。

OpenHuman 上下文构建示意图

OpenHuman 将你的所有文档、邮件和聊天记录进行摘要和压缩,并创建一个记忆图谱,让你的智能体记住关于你的一切。

OpenHuman 跳过了等待期。连接你的账户,让自动拉取以 20 分钟为周期将数据拉到本地,然后由记忆树将所有内容压缩为 Markdown 文件,智能存储在一个 Karpathy 风格的 Obsidian wiki 中。

仅需一次同步,智能体就拥有了你收件箱、日历、仓库、文档、消息的完整(压缩后的)上下文。无需训练期,无需"给它几周时间"。它成为你,由你掌控。

已经在其他编码智能体中自托管 agentmemoryOpenHuman 提供可选的 Memory 后端来代理它——在 config.toml 中设置 memory.backend = "agentmemory",同一个持久化存储将同时服务于 OpenHuman 和 Claude Code、Cursor、Codex、OpenCode。详见 agentmemory 后端页面。

编排器,而非聊天机器人

最深层的区别不在于任何单一功能,而在于执行模型。Claude Code、OpenClaw 和 Hermes 都是一个智能体跑一个循环。OpenHuman 是一个**编排器**

  • 图,而非循环——每一轮对话都会在 tinyagents 上编译为带检查点的状态机图:可暂停等待人工介入、可在重启后存活、可从运行中途恢复。
  • 子智能体舰队——专家子智能体可派生至三层深,空闲工作者被复用,熔断器把卡住的智能体变成根因报告。
  • 看得见的工作流——智能体提出的 tinyflows 图,在画布上审阅:持久化、触发器驱动、审批把关。
  • 常驻的分脑——一个快速反应智能体负责分流,一个深度核心负责推理,由潜意识循环统一调度。
  • 智能体对智能体,端到端加密——实例之间通过 Signal 协议 E2E 会话相互编排,采用基于同意的配对机制和 x402 支付。没有任何服务器能看到明文。
  • 下一步:RLM——模型在沙箱化 REPL 中自行编写编排代码,运行在同一套图引擎和信任模型之上。

OpenHuman vs 其他智能体框架

高层次对比(产品持续演进,请以各厂商最新情况为准)。OpenHuman 的设计目标是减少供应商碎片化、将工作流知识保留在设备上、为智能体提供对你数据的持久记忆,而不仅仅是对话。

Claude Cowork OpenClaw Hermes Agent OpenHuman
开源 🚫 闭源 MIT MIT GNU
易上手 桌面 + CLI ⚠️ 终端优先 ⚠️ 终端优先 清爽 UI,几分钟上手
成本 ⚠️ 订阅 + 附加项 ⚠️ 自带模型 ⚠️ 自带模型 单一订阅 + TokenJuice
记忆 对话范围 ⚠️ 依赖插件 自学习 🚀 记忆树 + Obsidian 仓库,可选 agentmemory 后端
集成 ⚠️ 少量连接器 ⚠️ 自行接入 ⚠️ 自行接入 🚀 100+ OAuth · 5k+ MCP · 90k+ Skills
自动拉取 🚫 🚫 🚫 20 分钟同步到记忆
编排 ⚠️ 子任务 ⚠️ 单循环 ⚠️ 单循环 🚀 智能体图 + 检查点 + E2E 加密的 A2A
工作流 🚫 ⚠️ 脚本 ⚠️ 脚本 🚀 可视化、持久化、智能体提议、审批把关
会议 🚫 🚫 🚫 🚀 加入 Meet/Zoom/Teams/Webex,能发言,实时转写
消息渠道 🚫 ⚠️ 少数几个 ⚠️ 少数几个 17 个,含原生邮件(IMAP/SMTP
纯本地模式 🚫 仅云端 ⚠️ 自带本地 ⚠️ 自带本地 一键强制的隐私模式
可观测性 🚫 不透明 ⚠️ 日志 ⚠️ 日志 可回放的运行日志 + 每次调用的成本核算
API 碎片化 🚫 额外密钥 🚫 自带密钥 🚫 多供应商 一个账户
模型路由 🚫 单一模型 ⚠️ 手动 ⚠️ 手动 内置
原生工具 仅代码 仅代码 仅代码 代码 + 搜索 + 抓取 + 浏览器 + 语音 + 媒体生成

在 GitHub 上为我们加星

致力于 AGI 和人工意识?为仓库加星,帮助更多人找到这条路。

Star History Chart

贡献者名人堂

贡献一份力量,进入名人堂。贡献者可获得免费周边以及我们 Discord 的专属访问权限。

OpenHuman contributors