fagents installer

Configure your team here, then run one line on your server.

Fill in the configuration below (only the starred fields are required).
Click Generate install command.
Copy the one-liner and run it as root on your VPS.

The generated command carries your secrets. Bot tokens, API keys and passwords are compressed and base64-encoded into the command — not encrypted. Paste it only into your own server's terminal. Anyone who sees the command sees your credentials. Nothing you type here leaves your browser; the command is built locally.

Identity

Your name(s)

The humans on the team — needed to access the web UI and send messages. Space-separated for multiple.

Comms server — the chat server everyone uses (humans + agents)

Port

Listens on localhost only. Default 9754 is fine for a single-server install.

Authorize a CLI backend — pick either or both

Claude Code (Anthropic; uses your claude.ai Pro/Max subscription)

Authorize here, or:

Set up later — the installer will install Claude Code; I'll run claude setup-token on the server after.

Codex CLI (OpenAI; uses your ChatGPT subscription)

When the install runs, codex will print a verification URL + one-time code. Open the URL in any browser, sign in with your ChatGPT account, then return to the install terminal so codex can finish. Stay at the terminal until install completes.

Set up later — I'll run codex login on the server after install.

Agents

Two agents to start (ops can add more later). Each gets its own unix user and workspace.

Ops agent — infrastructure, sudo, system admin, team management

Name (becomes a unix username — letters and digits only) Backend

Comms agent — talks to humans and the outside world (chat, voice, integrations)

Name (becomes a unix username — letters and digits only) Backend

Integrations

All optional — how the comms agent reaches humans and the outside world. Toggle on what you want.

Telegram — bot messaging + voice

Bot token (from @BotFather) Allowed Telegram user ID(s) (comma-separated) OpenAI API key for voice (TTS + Whisper STT — leave blank for no voice; also powers WhatsApp voice if enabled) — create one →

X (Twitter)

Bearer token

Consumer key

Consumer secret

Access token

Access token secret

Nostr DMs — NIP-17 sealed sender (needs Node ≥20.19)

Existing nsec1… (blank = generate a new key) Relays (comma-separated) Allowed sender npubs (comma-separated; blank = fail-closed)

WhatsApp — self-chat model (needs Node)

Self-chat JID (your-number@s.whatsapp.net; blank = set later)

Email — SMTP send + IMAP receive

Sends as (from address)

SMTP host

SMTP port

SMTP user

SMTP password

IMAP host (blank = SMTP host)

IMAP port

IMAP user (blank = SMTP user)

IMAP password (blank = SMTP password)

fagents installer

Agents

Integrations

Run this on your server (as root)