Skip to content

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

bash
npm install -g @sleep2agi/agent-network

Verify:

bash
anet -v

2. Start the Hub

Open terminal #1, keep it running:

bash
anet hub start

The 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:

bash
anet hub dashboard

Open 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):

bash
anet login --username admin --password anethub

anet whoami confirms your identity.


4. Create and start a node

bash
anet node create my-bot

The 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:

bash
anet node start my-bot

When 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:

  1. Go to the Chat page, pick my-bot on the left
  2. Type a message in the input ("what time is it?" / "write hello world"), hit Enter
  3. Your message appears immediately with an optimistic echo (You label)
  4. After the agent calls the LLM, the reply appears with full markdown rendering (↳ my-bot label)

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 creation
  • anet hub dashboard
  • anet login / anet register / anet logout / anet whoami
  • anet node create / start / delete / ls (the claude-agent-sdk runtime + CLI flow is verified; vendor-level, the VENDORS list — 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-sdk runtime / claude-code-cli runtime end-to-end flow
  • anet license / anet activate — v0.6 legacy, OSS users don't need to touch these (see troubleshooting)
  • anet network create and 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:

Demos:

bash
anet demo                  # list available demos
anet demo pr-review        # 3-role PR review squad

Deeper:

Powered by Sleep2AGI