Getting Started (5 steps)
The minimum path for a brand-new user — 5 steps, 5 minutes. One command + one verification per step.
Already have anet installed?
Skip this page and go to the Upgrade Guide (usually anet upgrade + anet project restart to restart cwd nodes).
Prerequisite: Node.js ≥ 22.13.0 (commhub-server and agent-node are auto-fetched via bunx / npx on first use — you don't install them manually).
1. Install the CLI
npm install -g @sleep2agi/agent-networkVerify:
anet -v2. Start the Hub
Open terminal #1, keep it running:
anet hub startThe hub listens on http://127.0.0.1:9200 by default, the SQLite DB lives at ~/.commhub/commhub.db, and the default admin account admin / anethub is created automatically.
Change the password before going public
The default admin / anethub is for local quickstart only. Any --host 0.0.0.0 public deployment must anet passwd to a strong password immediately.
Stop / status
anet hub status / anet hub stop (no more lsof + kill).
3. Start the Dashboard + log in
Open terminal #2, keep it running:
anet hub dashboardOpen http://localhost:3000 in your browser and log in with admin / anethub.
In terminal #3, log the CLI in too (so subsequent anet node ... commands carry the credentials):
anet login --username admin --password anethubanet whoami confirms your identity.
4. Create and start a node
anet node create my-botThe wizard asks: runtime → (only for claude-agent-sdk) vendor → model → API key.
Easiest path for newcomers — pick claude-code-cli manually
The wizard defaults to highlighting claude-agent-sdk; pressing Enter all the way lands you on the vendor + API-key path. If you've already done claude auth login, manually picking claude-code-cli is the zero-config fastest path.
The 4-runtime comparison: Runtime — Four runtimes comparison.
Start the node:
anet node start my-botWhen you see SSE connected, the node is online. Keep the terminal running.
Ctrl+C during vendor selection can leave a half-baked node
Clean a half-baked node with anet node delete <alias> (run once without --force to see the will-delete preview, then add --force to actually delete).
5. Use it — dispatch a task from the Dashboard
Back in your browser at http://localhost:3000:
- Go to the Chat page, pick
my-boton the left - Type a message in the input ("what time is it?" / "write hello world"), hit Enter
- Your message appears immediately with an optimistic echo (
Youlabel) - After the agent calls the LLM, the reply appears with full markdown rendering (
↳ my-botlabel)
Refresh the page — chat history is preserved.
✅ 5 steps done.
Verified vs not verified
Verified (current stable)
All 5 steps above pass the release gate. Detailed test reports: Changelog + test reports.
anet hub start+ automatic default account creationanet hub dashboardanet login/anet register/anet logout/anet whoamianet node create / start / delete / ls(theclaude-agent-sdkruntime + CLI flow is verified; vendor-level, theVENDORSlist — Anthropic / MiniMax / InternLM / Xiaomi MiMo — is verified-with-real-call)- Dashboard Chat (markdown / Enter-to-send / optimistic echo / source labels / error fallback / persistent history)
Not verified (use at your own risk)
codex-sdkruntime /claude-code-cliruntime end-to-end flowanet license/anet activate— v0.6 legacy, OSS users don't need to touch these (see troubleshooting)anet network createand cross-user network sharing — code merged but no E2E regression- One-shot install script
setup-anet.sh— not end-to-end verified, audit before use, see One-shot install (experimental)
No hosted service
The project direction is Apache 2.0 open source + self-host + courses / consulting, no SaaS. For production deployments see Docker / Production.
Next steps
Advanced:
- Multi-agent coordination — peer agents auto-coordinate via
get_all_status/send_task/get_task - Batch node management with
anet project up/restart/down— start/stop every node under cwd in one command; zero-keyboard recovery after reboot - LAN-shared hub —
anet hub start --host 0.0.0.0lets other machines join
Demos:
anet demo # list available demos
anet demo pr-review # 3-role PR review squadDeeper:
- CLI command reference
- Agent Node config — config.json fields +
/loopscheduler - Multi-model config — DeepSeek / Kimi / Claude / MiniMax / self-hosted
- Architecture overview
- Upgrade Guide — any older version → latest with a single
anet upgrade