https://github.com/sho0pi/gaia
🌍 An AI agent that forges specialist subagents on demand, stores them for reuse, and grows to you over time.
https://github.com/sho0pi/gaia
ai-agent google-adk mem0
Last synced: 25 days ago
JSON representation
🌍 An AI agent that forges specialist subagents on demand, stores them for reuse, and grows to you over time.
- Host: GitHub
- URL: https://github.com/sho0pi/gaia
- Owner: Sho0pi
- License: mit
- Created: 2026-06-06T10:42:14.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-06-26T10:59:21.000Z (29 days ago)
- Last Synced: 2026-06-26T11:06:11.678Z (29 days ago)
- Topics: ai-agent, google-adk, mem0
- Language: Python
- Homepage: https://gaia-agent.com
- Size: 4.2 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 62
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# gaia
[](https://gaia-agent.com)
[](https://docs.gaia-agent.com)
[](https://github.com/Sho0pi/gaia/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.python.org/)
> I hate python — here is Gaia, the best agent you will ever use.
Gaia builds its own specialists. Hand it a task and it grabs the right **soul** (a subagent) for the
job, or forges a new one and keeps it around for next time — so it gets sharper the more you use it.
It remembers you, runs long jobs in the background, and you talk to it on Telegram, WhatsApp, or your
terminal.
## Install
```bash
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).
```bash
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)
```bash
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](https://docs.gaia-agent.com)**.
## Built on
Gaia leans on a lot of great open-source work, each under its own license:
[google-adk](https://github.com/google/adk-python) (runtime),
[a2a-sdk](https://a2a-protocol.org),
[mem0](https://github.com/mem0ai/mem0) (memory),
[python-telegram-bot](https://github.com/python-telegram-bot/python-telegram-bot) /
[pywa](https://github.com/david-lev/pywa) /
[neonize](https://github.com/krypton-byte/neonize) (connectors),
[Typer](https://typer.tiangolo.com) + [Textual](https://textual.textualize.io) (CLI),
docs on [Astro Starlight](https://starlight.astro.build), all run with
[uv](https://docs.astral.sh/uv/). Gaia's own code is [MIT](LICENSE).
## Develop
```bash
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](AGENTS.md); how to contribute in
[CONTRIBUTING.md](CONTRIBUTING.md). The docs site is in [`docs/`](docs/) — its reference pages are
generated by [`scripts/gen_reference.py`](scripts/gen_reference.py).
---
## ⚠️ 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](LICENSE), and it's the binding text. You own what you point it at and what it
does, so read [SECURITY.md](SECURITY.md) and keep it on least privilege.