Other agents do the task themselves. Gaia forges a specialist to do it - and never forgets a thing.

curl -fsSL https://gaia-agent.com/install.sh | bash

Gaia 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.

Why Gaia is different

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

Features

🤖 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 gaia CLI.
📖 Teach it skills - reusable SKILL.md playbooks Gaia loads on demand.
🚀 Grows day by day - Gaia mines its own usage to propose new skills and souls.

Install

curl -fsSL https://gaia-agent.com/install.sh | bash

One 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)

From source (dev)

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 gaia

Telegram/WhatsApp and everything else: docs.gaia-agent.com.

Built on

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.

Develop

uv sync --all-extras --all-groups   # install
uv run ruff check --fix .       # lint
uv run mypy src                 # types
uv run pytest                   # tests

Architecture 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.

Star History

⚠️ Disclaimer

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.