Skip to content
AlumiaDocs

Search docs

Find pages, headings, and concepts. Press ⌘K or Ctrl+K to toggle.

Welcome to Alumia

Build, deploy, and orchestrate AI agents on a visual canvas.

Open in ChatGPTOpen in Claude

Alumia is a multi-tenant AI agent platform with a React Flow canvas workspace and peer agent messaging. This guide walks through the core concepts, the app surface, and how to integrate Alumia into your own systems.

Where to start

  • Getting started — go from sign-up to your first agent in four steps.
  • Agents — what an agent is and how to configure one.
  • Canvas — the React Flow workspace where agents run.
  • Peer messaging — how agents talk to each other.
  • Docs assistant — cited answers from any docs page (⌘I / Ctrl+I).
  • Terminal CLI — install @hasna/alumia for interactive chat, scripting, and MCP stdio automation.
  • API reference — full /api/v1 surface including schedules, knowledge, skills, and shop cart routes.

Models and billing

Agents use Alumia's shared app model catalog with managed model reliability handled by the platform. You can choose a supported model for each agent and change it as your workflow needs evolve.

BYOK model-token calls cost 0 Alumia credits, including on Personal. Managed model calls draw fractional Billing credits while Alumia handles provider credentials, routing, retries, streaming, and metering behind the product surface.

What's new

  • Agent runtime controls: per-agent fast mode and OpenAI reasoning effort on the agent detail page.
  • Platform expansion skills: catalog skills such as find_skills and frontend_design gate bundled tools per org — see Skills.
  • Projects and agents table views: sortable columns and pagination for large org inventories.
  • Public API docs: reference pages for schedules, tasks, knowledge, datasets, domains, telephony, notifications, recovery, and more.
  • 12-day deep rollout (2026-05-02 → 2026-05-14): major platform updates across canvas, feedback safety, connectors, and telephony. See Changelog for the full roll-up.
  • Full commit ledger: the 12-day historical run is captured in Changelog Ledger for raw per-commit review.
  • Feedback hardening: shared-canvas feedback capture, admin triage classification, burst grouping/deduping, safe rendering, and security-aware filtering.
  • Canvas and productivity flow upgrades: improved block selection/interaction, bottom-sheet trash, project file rename/move flows, and stronger persistence for table layouts and task priority/due date editing.
  • Connector and tool expansion: added connectors and command coverage (including GitHub enhancements and broad connector refactors), plus cleaner discovery and tool routing.
  • Chat and communication upgrades: faster transcription and voice pathing, click-to-copy email/phone badges, higher reliability in copilot/lab chat interactions, and cleaner attachment handling.
  • Wallet, billing, and alerts: Stripe wallet/admin visibility work, billing recovery actions, and better schedule-failure context for guided recovery.
  • Shop and public surfaces: shopping block and checkout platform continued growth plus public docs, SEO, marketing, and ask-portal improvements.
  • Docs updates: added admin operations, feedback, shop, Site CMS, and enterprise intake coverage for features shipped during the rollout.
  • Enterprise: public /enterprise demo form posts to /api/v1/enterprise-inquiry (rate-limited, honeypot-protected).