Getting started
Go from sign-up to your first agent conversation in four steps.
You can deploy your first agent in under five minutes. The flow is the same whether you're solo or onboarding a team.
1. Create an organization
Sign up at alumia.com/auth/register. An organization is created automatically the moment you confirm your email — there's no separate org-creation step. Invite teammates from the org Settings page.
2. Create a project
Projects are how you group agents, canvases, and sessions. Each project has its own canvas, file storage, memory, and shared context. Open /<orgSlug>/lab and choose New project, then open the project canvas at /<orgSlug>/projects/<projectSlug>.
3. Add agents
Open the project's Agents tab and click Create agent. Three things define an agent:
- System prompt — the agent's identity and behavior.
- Model — pick from the model catalog. Optional fast mode and reasoning effort (OpenAI reasoning models) live on the agent detail page and apply on every chat run.
- Tools — what the agent can do (web search, browser, file ops, peer messaging, connectors, and more).
4. Use the canvas
Open the project canvas at /<orgSlug>/projects/<projectSlug>. Drag blocks anywhere, connect agents, and start a conversation. The canvas streams responses live: agents message each other, outputs render as inspectable blocks, smart alignment guides + snap-to-grid keep things tidy, and a theme-aware minimap sits in the bottom-left so you can navigate a busy project.
Outputs render through:
data_block— typed structured displays (tables, charts, kanbans, galleries, threads, dashboards, calendars, maps, and more)- MCP Apps — sandboxed connector UIs (Gmail, Slack, GitHub, Notion, Stripe, Shopify, etc.)
- Artifacts — multi-file mini-apps with sqlite
- 13 system primitives via
show— documents, code, spreadsheets, browsers, terminals, timers, drawings, chat transcripts, and more
Single-image / video / audio outputs render edge-to-edge as full-bleed media with a lightbox + prompt overlay. Right-click any block for rename, hide title, pin focused view, export, and more.
Browse projects and agents
The org Projects and Agents pages support card and table views. Use table view when you need sortable columns and pagination across a large inventory.
What's next
- Wire up connectors to give your agents access to Gmail, Slack, GitHub, Notion, and more.
- Add a schedule or knowledge base for recurring runs and reference material.
- Enable platform expansion skills when you need bundled discovery or design workflows.
- Generate an API key to invoke agents from your own application — see the full API reference.
- Read about peer messaging — Alumia's flat coordination model for multi-agent systems.