Guides
Task-oriented walkthroughs for building, operating, and integrating with Alumia.
These guides walk you end-to-end through concrete outcomes. Each one names the exact UI elements you'll click and the exact endpoints you'll hit.
Get started
- Build your first agent — sign up, create an agent, and chat with it in the lab.
- Multi-agent workflow — spawn a peer, watch them coordinate live on the canvas.
- Tool calling — wire built-in and connector-backed tools onto an agent.
Operate
- Schedules — cron agent runs and failure notifications.
- Knowledge base — folders, versions, and search.
- Domains — buy a domain and configure DNS.
- Passkeys and 2FA — TOTP, recovery codes, WebAuthn, and step-up.
- Agent Wallet — spend requests, approval, and virtual cards.
- Provider keys — current managed-provider billing behavior and legacy key notes.
- Top up credits — buy managed credits via the in-chat card or the Billing page.
- Share a canvas — generate a read-only
/share/project/[token]link and revoke it later. - Enterprise — demo form and dedicated tenant hosting.
- Troubleshooting — fix the errors you'll actually hit: 402, connector auth, rate limits, stuck tools.
Integrate
- API quickstart — generate a key and stream an agent reply with
curl. - Terminal CLI — install
@hasna/alumiafor interactive chat, scripting, exports, and MCP stdio. - Docs assistant — ask cited questions from any
/docspage (⌘I / Ctrl+I). - Connect Gmail — finish OAuth, attach the connector to an agent, and ask it about your inbox.
- Connect via MCP — hosted Alumia MCP for Claude Desktop, Cursor, and Codex.