GAIA Γαῖα · what it connects to
Gaia runs on the apps you already text on, the models you already pay for, and the tools every soul inherits the moment it's forged. Bring your own keys, self-host the whole thing.
I · Channels
One command pairs a channel. Gaia answers from your server while you message from your phone.
Inline chat in your shell. Always on, always admin.
Pair a bot via BotFather and text Gaia from your phone.
Scan a QR and message Gaia like any other contact.
Channels, DMs, and slash commands. On the roadmap.
Workspace events and app actions. On the roadmap.
II · Models
Set a provider with gaia model or the llm block in gaia.yaml. Give each soul its own.
The default provider, with a free-tier embedding model out of the box.
GPT models with text-embedding-3-small for memory. Attach an API key, or sign in with your ChatGPT subscription via gaia model --oauth.
Claude family models as a first-class provider.
One key, hundreds of models routed through a single gateway.
Run open-weight models on your own box with Ollama.
III · Built-in tools
A real toolset, not a sandbox. Every call is gated by a capability ACL, so guests, users, and admins reach exactly what they should.
Sandboxed reads and writes, scoped per soul.
Run real commands, gated to the user role and above.
Search, fetch, and screenshot live pages.
Recall and persist what matters across sessions.
Hand work to specialist souls and stitch results back.
Wake up on a timer and run jobs in the background.
IV · Skills & MCP
Plain-text playbooks. A SKILL.md folder under ~/.gaia/skills/ teaches a soul something once, then sticks. Gaia loads them on demand, so it only reads the full text when a skill is actually relevant.
Wire up any custom Model Context Protocol server through gaia tools and its capabilities become tools your souls can call. The browser itself can run on a playwright-mcp backend.
V · Run anywhere
Self-hosted by design. State lives in ~/.gaia/, nothing phones home but the model call you set up.
Plant a goal
Free and open source. Bring your keys, pick your channels, and let Gaia forge the souls that use them.