{"id":51288200,"url":"https://github.com/sho0pi/gaia","last_synced_at":"2026-06-30T08:02:07.120Z","repository":{"id":364257780,"uuid":"1261176782","full_name":"Sho0pi/gaia","owner":"Sho0pi","description":"🌍 An AI agent that forges specialist subagents on demand, stores them for reuse, and grows to you over time.","archived":false,"fork":false,"pushed_at":"2026-06-26T10:59:21.000Z","size":4403,"stargazers_count":2,"open_issues_count":62,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-26T11:06:11.678Z","etag":null,"topics":["ai-agent","google-adk","mem0"],"latest_commit_sha":null,"homepage":"https://gaia-agent.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sho0pi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-06T10:42:14.000Z","updated_at":"2026-06-26T10:38:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Sho0pi/gaia","commit_stats":null,"previous_names":["sho0pi/gaia"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Sho0pi/gaia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sho0pi%2Fgaia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sho0pi%2Fgaia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sho0pi%2Fgaia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sho0pi%2Fgaia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sho0pi","download_url":"https://codeload.github.com/Sho0pi/gaia/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sho0pi%2Fgaia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34957627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","google-adk","mem0"],"created_at":"2026-06-30T08:02:06.097Z","updated_at":"2026-06-30T08:02:07.110Z","avatar_url":"https://github.com/Sho0pi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gaia\n\n[![gaia-agent.com](https://img.shields.io/badge/gaia--agent.com-0F172A?style=flat\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAeGVYSWZNTQAqAAAACAAEARoABQAAAAEAAAA+ARsABQAAAAEAAABGASgAAwAAAAEAAgAAh2kABAAAAAEAAABOAAAAAAAAAEgAAAABAAAASAAAAAEAA6ABAAMAAAABAAEAAKACAAQAAAABAAAADqADAAQAAAABAAAADgAAAACOfw3NAAAACXBIWXMAAAsTAAALEwEAmpwYAAACmmlUWHRYTUw6Y29tLmFkb2JlLnhtcAAAAAAAPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iWE1QIENvcmUgNi4wLjAiPgogICA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPgogICAgICA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIgogICAgICAgICAgICB4bWxuczp0aWZmPSJodHRwOi8vbnMuYWRvYmUuY29tL3RpZmYvMS4wLyIKICAgICAgICAgICAgeG1sbnM6ZXhpZj0iaHR0cDovL25zLmFkb2JlLmNvbS9leGlmLzEuMC8iPgogICAgICAgICA8dGlmZjpYUmVzb2x1dGlvbj43MjwvdGlmZjpYUmVzb2x1dGlvbj4KICAgICAgICAgPHRpZmY6WVJlc29sdXRpb24+NzI8L3RpZmY6WVJlc29sdXRpb24+CiAgICAgICAgIDx0aWZmOlJlc29sdXRpb25Vbml0PjI8L3RpZmY6UmVzb2x1dGlvblVuaXQ+CiAgICAgICAgIDxleGlmOlBpeGVsWURpbWVuc2lvbj4xMjQ8L2V4aWY6UGl4ZWxZRGltZW5zaW9uPgogICAgICAgICA8ZXhpZjpQaXhlbFhEaW1lbnNpb24+MTI0PC9leGlmOlBpeGVsWERpbWVuc2lvbj4KICAgICAgICAgPGV4aWY6Q29sb3JTcGFjZT4xPC9leGlmOkNvbG9yU3BhY2U+CiAgICAgIDwvcmRmOkRlc2NyaXB0aW9uPgogICA8L3JkZjpSREY+CjwveDp4bXBtZXRhPgqvVIrFAAAB/0lEQVQoFaWSu2tUQRTGvzMz9+7eXbK7bNZkTZQQEBRiaTob0cLGRgVRsEwrdiIETKFNYkjjvxBLESwsLQSxsJDVYAoFCxsNkrD37n3N4zh3zUMsdYbDnGG+3znfDAP846C/ufaTNxebfdzsd/PTJya0m2+JwUyoNu/NX3j7p/YIXHmlWmiuUc/diWat6HczzLcNTrUlZiWXXUWrt49fekBEriogDqp0f7SWhQvv2jIXeRpznKW8myX8M9lzQ52ErsbLmzsv7x/oxx1nrgzO2LZ+V3azZjFdME9naEwWmOoUmGtZnmsQTjYC6tVUKhUtLvWuflJVBZmV1ylQTR04h8iSbTiM6gY7oQErDePdacqZ681mVLprHnk4BoOUFoy0EIGDSBgcOxSRhQ01rNTkJxfEcDWLNrmFqtkYVIklCAEZ+EtHzDQEOGLSoUMsPSxKcsKy8C4mha24fTClAaS8IUNve+ThOvsCgKs7mMAi9XaFj5o28Ma3KnD8qtLQMxR6JDMhREaQKYFSf5pVYWFyg7Qsxe4wzr8Xw+eH4Iev57adM6vC1UAFhA9AM2C8LWMYWpPxFuMsW/+y+PjjIVgln7e/PdIcr1li44QSLODbOoLyGUqDOF5P1fuVSluNo5/ze4+Jyy/O553RLTMVn+Vje0BnuIV68hRLG6/3Jf+3/AKwAunY2GH4ZwAAAABJRU5ErkJggg==\u0026logoColor=white)](https://gaia-agent.com)\n[![Docs](https://img.shields.io/badge/docs-0F172A?style=flat\u0026logo=astro\u0026logoColor=white)](https://docs.gaia-agent.com)\n[![CI](https://img.shields.io/github/actions/workflow/status/Sho0pi/gaia/ci.yml?branch=master\u0026style=flat\u0026logo=githubactions\u0026logoColor=white\u0026label=CI\u0026labelColor=0F172A)](https://github.com/Sho0pi/gaia/actions/workflows/ci.yml)\n[![License](https://img.shields.io/github/license/Sho0pi/gaia?style=flat\u0026logo=opensourceinitiative\u0026logoColor=white\u0026label=license\u0026labelColor=0F172A\u0026color=0F172A)](LICENSE)\n[![Python](https://img.shields.io/badge/python-3.11+-0F172A?style=flat\u0026logo=python\u0026logoColor=white)](https://www.python.org/)\n\n\u003e I hate python — here is Gaia, the best agent you will ever use.\n\nGaia builds its own specialists. Hand it a task and it grabs the right **soul** (a subagent) for the\njob, or forges a new one and keeps it around for next time — so it gets sharper the more you use it.\nIt remembers you, runs long jobs in the background, and you talk to it on Telegram, WhatsApp, or your\nterminal.\n\n## Install\n\n```bash\ncurl -fsSL https://gaia-agent.com/install.sh | bash\n```\n\nOne line: sets up a self-contained gaia in `~/.gaia/venv` (every feature included), links the `gaia`\ncommand, and walks you through `gaia setup`. Installs the **latest release**; add `--ref main` for the\nbleeding edge. macOS + Linux (Windows: use WSL).\n\n```bash\ngaia                # chat in your terminal\ngaia start          # run the connectors in the background\ngaia update         # upgrade in place\ngaia uninstall      # remove it (asks before deleting your data)\n```\n\n### From source (dev)\n\n```bash\ngit clone https://github.com/Sho0pi/gaia.git \u0026\u0026 cd gaia\nuv sync --all-extras --all-groups\necho \"GEMINI_API_KEY=your-key\" \u003e\u003e ~/.gaia/.env\nuv run gaia\n```\n\nTelegram/WhatsApp and everything else: **[docs.gaia-agent.com](https://docs.gaia-agent.com)**.\n\n## Built on\n\nGaia leans on a lot of great open-source work, each under its own license:\n[google-adk](https://github.com/google/adk-python) (runtime),\n[a2a-sdk](https://a2a-protocol.org),\n[mem0](https://github.com/mem0ai/mem0) (memory),\n[python-telegram-bot](https://github.com/python-telegram-bot/python-telegram-bot) /\n[pywa](https://github.com/david-lev/pywa) /\n[neonize](https://github.com/krypton-byte/neonize) (connectors),\n[Typer](https://typer.tiangolo.com) + [Textual](https://textual.textualize.io) (CLI),\ndocs on [Astro Starlight](https://starlight.astro.build), all run with\n[uv](https://docs.astral.sh/uv/). Gaia's own code is [MIT](LICENSE).\n\n## Develop\n\n```bash\nuv sync --all-extras --all-groups   # install\nuv run ruff check --fix .       # lint\nuv run mypy src                 # types\nuv run pytest                   # tests\n```\n\nArchitecture and conventions are in [AGENTS.md](AGENTS.md); how to contribute in\n[CONTRIBUTING.md](CONTRIBUTING.md). The docs site is in [`docs/`](docs/) — its reference pages are\ngenerated by [`scripts/gen_reference.py`](scripts/gen_reference.py).\n\n---\n\n## ⚠️ Disclaimer\n\nGaia runs LLM-driven actions on your machine: shell commands, a browser, your files, messages sent as\nyou. Models get things wrong and can be tricked, so it can do dumb or destructive things. Run it at\nyour own risk.\n\nIt's provided **as-is, with no warranty**, and the authors aren't liable for anything it does — that\nis the [MIT License](LICENSE), and it's the binding text. You own what you point it at and what it\ndoes, so read [SECURITY.md](SECURITY.md) and keep it on least privilege.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsho0pi%2Fgaia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsho0pi%2Fgaia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsho0pi%2Fgaia/lists"}