curl -fsSL https://gaia-agent.com/install.sh | bashGaia is your everyday AI agent - for anything, on WhatsApp, Telegram, or your terminal. Hand it a task and it grabs the right soul (a specialist subagent) for the job, or its soul smith forges a new one on the fly and keeps it for next time, so it gets sharper the more you use it. It remembers you across channels (it never asks twice) and runs long jobs in the background.
Most agents are a single fixed assistant with a goldfish memory. Gaia isn't:
| a typical agent | Gaia | |
|---|---|---|
| Specialists | one agent for everything | a soul smith forges a task-specific soul on the fly, and reuses it next time |
| Memory | resets every session | long-term memory that grows day by day, one identity across every channel |
| Long jobs | blocks while it works | runs them in the background as missions, pings you when done |
| Reach | a browser tab | WhatsApp, Telegram, or your terminal |
- 🤖 Souls, not one-offs - a task gets the right specialist, forged the first time and reused every time after.
- 🧠 Two-tier memory - short-term session state + long-term mem0 that grows day by day.
- 💬 Meet it where you are - Telegram, WhatsApp, or a terminal chat: one identity, shared memory across channels.
- ⌨️ Drive it from the terminal - inspect souls, tasks, users, memory, and config from the
gaiaCLI. - 📖 Teach it skills - reusable
SKILL.mdplaybooks Gaia loads on demand. - 🚀 Grows day by day - Gaia mines its own usage to propose new skills and souls.
curl -fsSL https://gaia-agent.com/install.sh | bashOne line: sets up a self-contained gaia in ~/.gaia/venv (every feature included), links the gaia
command, and walks you through gaia setup. Installs the latest release; add --ref main for the
bleeding edge. macOS + Linux (Windows: use WSL).
gaia # chat in your terminal
gaia start # run the connectors in the background
gaia update # upgrade in place
gaia uninstall # remove it (asks before deleting your data)git clone https://github.com/Sho0pi/gaia.git && cd gaia
uv sync --all-extras --all-groups
echo "GEMINI_API_KEY=your-key" >> ~/.gaia/.env
uv run gaiaTelegram/WhatsApp and everything else: docs.gaia-agent.com.
Gaia leans on a lot of great open-source work, each under its own license: google-adk (runtime), a2a-sdk, mem0 (memory), python-telegram-bot / pywa / neonize (connectors), Typer + Textual (CLI), docs on Astro Starlight, all run with uv. Gaia's own code is MIT.
uv sync --all-extras --all-groups # install
uv run ruff check --fix . # lint
uv run mypy src # types
uv run pytest # testsArchitecture and conventions are in AGENTS.md; how to contribute in
CONTRIBUTING.md. The docs site is in docs/ - its reference pages are
generated by scripts/gen_reference.py.
Gaia runs LLM-driven actions on your machine: shell commands, a browser, your files, messages sent as you. Models get things wrong and can be tricked, so it can do dumb or destructive things. Run it at your own risk.
It's provided as-is, with no warranty, and the authors aren't liable for anything it does - that is the MIT License, and it's the binding text. You own what you point it at and what it does, so read SECURITY.md and keep it on least privilege.