Bazilion documentation

Bazilion is a personal, open-source, local-first multi-agent runtime. It runs as a small daemon on your own machine, owns a workspace under ~/.bazilion, and lets you build agent templates, spawn whole teams from them, and let those agents share files, memory, and messages — all under your own control, with your own provider keys.

It is not a hosted platform. It is a daemon, a CLI, and a web UI you run yourself, published under the MIT license.

Getting started Install the daemon, boot it, and finish first-run setup.

Core concepts Profiles, profile groups, groups, memory, and the mailbox.

Tools & integrations Browser automation, MCP servers, file handling, and built-in tools.

Configuration Providers, secrets, tokens, and the on-disk layout.

How the pieces fit

Profiles become agents

A profile is an agent template — SOUL.md, IDENTITY.md, tools, skills mode, and a default model. Spawning a profile creates a live agent.

Profile groups spawn teams

An ordered set of profile-backed members spawned transactionally into one collaboration group, with per-member names, models, and reasoning levels.

A mailbox between them

Agents coordinate through a durable mailbox: send_message, read_inbox, and wait_for_reply in the loop, plus CLI, API, and web surfaces.

Shared memory, indexed

Each group has one memory rooted at <group>/memory, indexed with qmd (BM25 over markdown) so every agent in the group can search it.