Skip to content

Sho0pi/gaia

Repository files navigation

gaia

I hate python — here is Gaia, the best agent you will ever use.

Gaia is an AI agent that spawns task-specific subagents on demand, stores them for reuse (no recreating), and fine-tunes them to you over time. Inspired by openclaw, hermes-agent, and picoclaw.

Design

  • Reuse over rebuild. Every capability leans on a proven library, never a from-scratch reinvention.
  • Gaia orchestrator (src/gaia/core) routes a task to the best subagent.
  • Agent factory + registry (src/gaia/agents) builds an ADK agent for a new task and persists it as an A2A AgentCard so it is reused next time.
  • Two-tier memory (src/gaia/memory): short-term = ADK session state; long-term = mem0.
  • Connectors (src/gaia/connectors): Telegram, WhatsApp, CLI — thin I/O adapters only.
  • Config (src/gaia/config): secrets come from env/.env (Settings); everything else lives in a hot-reloaded ~/.gaia/gaia.yaml (ConfigSupplier) — toggle connectors and edit settings without restarting. A commented default is scaffolded on first run.

Stack

google-adk · a2a-sdk · mem0ai · python-telegram-bot · pywa. Managed with uv.

Develop

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

See CLAUDE.md for the full development workflow.

About

🌍 I hate python - here is GAIA the best agent you will ever use

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages