AgentHub
Install Mode Chooser

先选一种安装模式

先决定 AgentHub server 跑在哪里,再抄对应命令。默认推荐顺序是:本机模式起步,Docker 模式复现,VM 模式长期在线。

本机模式

适合只有一台主力电脑,先让手机或桌面端接管本机 agent。默认 Web 入口 `43073`,API 端口 `43080`。

什么时候选它

你已经在本机开发,想最快看到 Web 控制台,并通过 Tailscale 让手机或另一台电脑接入。

最短命令

copy .env.example .env
python -m venv .venv
.\.venv\Scripts\python -m pip install -r apps/api/requirements.txt
npm install
npm run local:dev

Docker 模式

适合已经在用 Docker,希望用容器把 API 和 Web 反代栈收进一条 compose,而不是自己装 Python / Node / nginx。

什么时候选它

你想要一个可复现的单机栈,先跑起来,再决定是否需要 HTTPS、VM 或更正式的反向代理。

最短命令

cp .env.example .env
docker compose -f deploy/docker-compose.selfhost.yml up -d --build

VM 模式

适合长期在线、HTTPS、公网入口、worker bundle 下载和 public relay。默认就是正式 self-host 形态。

什么时候选它

你已经有域名和 Linux VM,或者要给多台 worker 和多台客户端提供一个稳定入口。

最短命令

curl -fsSL https://myagenthub.dev/install.sh | bash -s -- \
  --domain agenthub.example.com \
  --install-root /opt/agenthub \
  --admin-email you@example.com

装 worker 或交给别的 agent

Server 起来以后,worker 直接走 `npx agenthub-worker`。如果你想把整套部署交给别的工程 agent,就用 runbook 和 deployment brief。