Skip to main content
This tab is for changing GAIA’s code. To just run GAIA, see Self-Hosting. To use it, see the Docs.

​
The path

Read these in order the first time.
1

Set up GAIA for development

Install the tools and start GAIA.
2

Take the project tour

Where each part lives.
3

Learn the everyday loop

Run GAIA locally, test your change, read the logs and open a pull request.

​
Go deeper when you need to

Architecture

The processes, databases and AI agents, and how they connect.

Conventions

Code style, commit messages and the design system.

Bots

Build and run the Discord, Slack, Telegram, WhatsApp and iMessage bots.

Commands

Every mise task, on one page.

​
Get help