AgentHub 用来统一管理你自己机器上的 Codex、Claude、Kimi、OpenCode 等本地 agent runtime。
你可以把 server 跑在笔记本、本地工作站或 VM 上，通过 Tailscale private mode 或 HTTPS public relay 接入；然后在 Web、Android、Windows 桌面端统一控制多台电脑、多条终端 session、多个 agent backend。
AgentHub 不是托管 SaaS，也不是任意远程 shell。agent 继续运行在你的机器上，使用你的文件、工具和运行环境；AgentHub 负责会话收件箱、控制界面、worker 接入和审计记录。
架构关系和部署形态见：架构图
- 统一会话收件箱。 把本机和远程机器上的 Codex、Claude、Kimi、OpenCode 会话放到同一个入口。
- 多机器控制。 Windows 和 Linux worker 都可以接入，消息、健康检查和任务会路由到对应机器。
- 手机和桌面都能用。 Web、Android APK、Windows 桌面端都可以接入同一个 AgentHub server；其中 Android APK 首启会先要求填写 server URL。
- Tailscale-first 私有模式。 不需要把 worker 端口暴露到公网，也能从手机控制本机 agent。
- Public relay 公开入口。 如果你有域名和 HTTPS 反代，也可以把 Web/App 入口放到公网，worker 仍然可以只走私网或出站连接。
- 配置优先。 语音识别、服务器地址、worker 根目录、provider 密钥都走配置，不写死维护者环境。
- 只有一台主力电脑。 直接在 Windows、macOS 或 Linux 上跑 AgentHub server，通过 Tailscale 地址让手机和桌面端接入；worker 可以和 server 在同一台机器上。
- 一台云端 VM + 多台本地电脑。 VM 提供稳定 HTTPS 入口，本地 Windows / Linux worker 通过 Tailscale private mode 或 public relay 接入，适合长期在线和多机器协作。
- 手机查看和轻量控制。 Android APK 首启填写你的 server URL，之后用同一个账号查看 session、发回复、处理审批和查看状态。
- 不想暴露 worker。 只把 Web/API 入口暴露给 HTTPS，worker 继续通过 Tailscale 或出站连接通信，不开放 SSH、数据库或 worker 端口。
- 给工程 agent 部署。 把 Deployment brief template 填好，再让 Codex / Claude Code 按 AI deployment runbook 执行。
小技巧：
- 本机 server 场景下，Android 里优先填 Tailscale DNS 或
100.x.y.z地址，避免局域网 IP 变化。 - 公网 VM 场景下，Web/App 入口必须使用 HTTPS；普通公网
http://不应该用于登录态。 - worker 可以和 server 同机，也可以分布在多台电脑上；AgentHub 只负责任务路由和状态同步，agent runtime 仍然使用 worker 本机环境。
- iOS client 和 macOS desktop 当前不是 first-party 支持面，但
CONTRIBUTING.md已经放了贡献提示词和约束，欢迎社区补齐。
如果你想最快部署，优先从这两个文件开始，让另一个 agent 或实施人员直接照着执行：
这条路径适合：
- 你想把部署交给 Codex、Claude Code 或其他工程 agent
- 你不想自己手动拼接安装命令和配置项
- 你要在本机、Tailscale 或 VM 三种模式之间快速切换
部署完成后：
- Android APK 首启先填写 AgentHub server URL
- 然后进入对应站点的登录页
- 不是免登录，而是先选自己的 server，再登录自己的账号
适合已经在用 Tailscale，只想先让手机或桌面端接管本机 agent 的场景。
copy .env.example .env
python -m venv .venv
.\.venv\Scripts\python -m pip install -r apps/api/requirements.txt
npm install
npm run api:dev
npm run web:dev打开 http://localhost:5173，用 AGENTHUB_BOOTSTRAP_TOKEN 创建第一个 owner，然后在 Android 或 Windows 桌面端填入本机或 Tailscale 地址。
适合需要长期在线、worker bundle 下载、公网入口或 public relay 的场景。
sudo bash scripts/install-selfhost-linux.sh \
--domain agenthub.example.com \
--install-root /opt/agenthub \
--admin-email you@example.com| 端 | 状态 | 说明 |
|---|---|---|
| Web self-host | 已支持 | 主控制台和 API |
| Android APK | 已支持 | 首启先配置 server URL，再进入登录 |
| Windows desktop | 已支持 | Electron 客户端，首启配置服务器 |
| Windows worker | 已支持 | bundle + PowerShell 安装脚本 |
| Linux worker | 已支持 | bundle + shell/systemd 安装脚本 |
| iOS client | 欢迎社区贡献 | CONTRIBUTING.md 里已有可直接开工的提示词 |
| macOS desktop | 欢迎社区贡献 | CONTRIBUTING.md 里已有可直接开工的提示词 |
- English README
- Architecture diagrams
- Local server mode
- Self-host quickstart
- Tailscale private mode
- Configuration reference
- Branding and logo source
- Deployment
- Security model
- Testing
- OSS release flow
- Open-source launch checklist
- Contributing
npm run web:build
npm run desktop:build
npm run desktop:package:win
npm run mobile:build:debug
npm run mobile:build:release生成可下载的 worker bundles：
.\.venv\Scripts\python.exe scripts\build-worker-bundle.py --output-root .runtime\worker-bundlesnpm run api:test
npm run web:test
npm run web:build
npm run desktop:test
npm run mobile:test
.\.venv\Scripts\python.exe scripts\audit-public-export.py公开仓不应该包含私有生产域名、部署凭据、本地数据库、运行日志、签名密钥或生成出的 release 产物。