{"id":27644740,"url":"https://github.com/amd/gaia","last_synced_at":"2026-04-11T01:59:06.096Z","repository":{"id":283385150,"uuid":"903960898","full_name":"amd/gaia","owner":"amd","description":"Run LLM Agents on Ryzen AI PCs in Minutes","archived":false,"fork":false,"pushed_at":"2025-03-20T00:15:08.000Z","size":13370,"stargazers_count":11,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-20T01:19:53.285Z","etag":null,"topics":["ai","amd","genai","ryzenai"],"latest_commit_sha":null,"homepage":"https://github.com/amd/gaia","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/amd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-16T01:25:56.000Z","updated_at":"2025-03-20T00:15:12.000Z","dependencies_parsed_at":"2025-03-20T01:30:11.357Z","dependency_job_id":null,"html_url":"https://github.com/amd/gaia","commit_stats":null,"previous_names":["amd/gaia"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Fgaia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Fgaia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Fgaia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Fgaia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amd","download_url":"https://codeload.github.com/amd/gaia/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250540995,"owners_count":21447427,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","amd","genai","ryzenai"],"created_at":"2025-04-24T00:58:38.935Z","updated_at":"2026-04-11T01:59:06.083Z","avatar_url":"https://github.com/amd.png","language":"Python","funding_links":[],"categories":["ai","Official Resources"],"sub_categories":[],"readme":"# \u003cimg src=\"https://raw.githubusercontent.com/amd/gaia/main/src/gaia/img/gaia.ico\" alt=\"GAIA Logo\" width=\"64\" height=\"64\" style=\"vertical-align: middle;\"\u003e GAIA: AI Agent Framework for AMD Ryzen AI\n\n[![GAIA CLI Tests](https://github.com/amd/gaia/actions/workflows/test_gaia_cli.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests \"Check out our cli tests\")\n[![Latest Release](https://img.shields.io/github/v/release/amd/gaia?include_prereleases)](https://github.com/amd/gaia/releases/latest \"Download the latest release\")\n[![PyPI](https://img.shields.io/pypi/v/amd-gaia)](https://pypi.org/project/amd-gaia/)\n[![GitHub downloads](https://img.shields.io/github/downloads/amd/gaia/total.svg)](https://github.com/amd/gaia/releases)\n[![OS - Windows](https://img.shields.io/badge/OS-Windows-blue)](https://amd-gaia.ai/docs/quickstart \"Windows installation\")\n[![OS - Linux](https://img.shields.io/badge/OS-Linux-green)](https://amd-gaia.ai/docs/quickstart \"Linux installation\")\n[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue?logo=python\u0026logoColor=white)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289DA?logo=discord\u0026logoColor=white)](https://discord.com/channels/1392562559122407535/1402013282495102997)\n\n**GAIA** is AMD's open-source framework for building intelligent AI agents that run **100% locally** on AMD Ryzen AI hardware. Keep your data private, eliminate cloud costs, and deploy in air-gapped environments—all with hardware-accelerated performance.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://amd-gaia.ai/docs/quickstart\"\u003e\u003cstrong\u003eGet Started →\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Download\n\n[![Download for Windows](https://img.shields.io/badge/Download-Windows-0078d4?style=for-the-badge\u0026logo=windows)](https://github.com/amd/gaia/releases/latest)\n[![Download for macOS](https://img.shields.io/badge/Download-macOS-000000?style=for-the-badge\u0026logo=apple)](https://github.com/amd/gaia/releases/latest)\n[![Download for Linux](https://img.shields.io/badge/Download-Linux-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black)](https://github.com/amd/gaia/releases/latest)\n\nSee the [installation guide](https://github.com/amd/gaia/blob/main/docs/guides/install.mdx) for setup instructions.\n\n---\n\n## Why GAIA?\n\n| Feature | Description |\n|---------|-------------|\n| **100% Local** | All data stays on your machine—perfect for sensitive workloads and air-gapped deployments |\n| **Zero Cloud Costs** | No API fees, no usage limits, no subscriptions—unlimited AI at no extra cost |\n| **Privacy-First** | HIPAA-compliant, GDPR-friendly—ideal for healthcare, finance, and enterprise |\n| **Ryzen AI Optimized** | Hardware-accelerated inference using NPU + iGPU on AMD Ryzen AI processors |\n\n---\n\n## Build Your First Agent\n\n```python\nfrom gaia.agents.base.agent import Agent\nfrom gaia.agents.base.tools import tool\n\nclass MyAgent(Agent):\n    \"\"\"A simple agent with custom tools.\"\"\"\n\n    def _get_system_prompt(self) -\u003e str:\n        return \"You are a helpful assistant.\"\n\n    def _register_tools(self):\n        @tool\n        def get_weather(city: str) -\u003e dict:\n            \"\"\"Get weather for a city.\"\"\"\n            return {\"city\": city, \"temperature\": 72, \"conditions\": \"Sunny\"}\n\nagent = MyAgent()\nresult = agent.process_query(\"What's the weather in Austin?\")\nprint(result)\n```\n\n**[See the full quickstart guide →](https://amd-gaia.ai/docs/quickstart)**\n\n---\n\n## Key Capabilities\n\n- **Agent Framework** — Base class with tool orchestration, state management, and error recovery\n- **RAG System** — Document indexing and semantic search for Q\u0026A\n- **Voice Integration** — Whisper ASR + Kokoro TTS for speech interaction\n- **Vision Models** — Extract text from images with Qwen3-VL-4B\n- **Plugin System** — Distribute agents via PyPI with auto-discovery\n- **Web UI Packaging** — Generate modern interfaces for your agents\n\n---\n\n## C++ Framework\n\nA C++17 port of the GAIA base agent framework is available under [`cpp/`](cpp/README.md). It implements the same agent loop, tool registry, and MCP client interface without any Python dependency — suitable for embedding in native applications or resource-constrained environments.\n\n```cpp\n#include \u003cgaia/agent.h\u003e\n\nclass MyAgent : public gaia::Agent {\nprotected:\n    std::string getSystemPrompt() const override {\n        return \"You are a helpful assistant.\";\n    }\n};\n```\n\n**[C++ build and usage instructions →](cpp/README.md)**\n\n---\n\n## Quick Install\n\n```bash\npip install amd-gaia\n```\n\nFor complete setup instructions including Lemonade Server, see the **[Quickstart Guide](https://amd-gaia.ai/docs/quickstart)**.\n\n---\n\n## System Requirements\n\n| Requirement | Minimum | Recommended |\n|-------------|---------|-------------|\n| **Processor** | AMD Ryzen AI 300-series | AMD Ryzen AI Max+ 395 |\n| **OS** | Windows 11, Linux | - |\n| **RAM** | 16GB | 64GB |\n\n---\n\n## Documentation\n\n- **[Quickstart](https://amd-gaia.ai/docs/quickstart)** — Build your first agent in 10 minutes\n- **[SDK Reference](https://amd-gaia.ai/docs/sdk)** — Complete API documentation\n- **[Guides](https://amd-gaia.ai/docs/guides)** — Chat, Voice, RAG, and more\n- **[FAQ](https://amd-gaia.ai/docs/reference/faq)** — Frequently asked questions\n\n---\n\n## Releases\n\nSee the full [Release Notes](https://amd-gaia.ai/docs/releases) on the documentation site, or browse [GitHub Releases](https://github.com/amd/gaia/releases).\n\n### Release Process\n\nTo publish a new release (e.g. `v0.17.0`), create a release PR that updates these 3 files:\n\n| # | File | What to change |\n|---|------|----------------|\n| 1 | `src/gaia/version.py` | Set `__version__ = \"0.17.0\"` |\n| 2 | `docs/releases/v0.17.0.mdx` | Create release notes (see [format guide](https://amd-gaia.ai/docs/releases)) |\n| 3 | `docs/docs.json` | **(a)** Add `\"releases/v0.17.0\"` to the Releases tab pages array, **(b)** update the navbar label to `\"v0.17.0 · Lemonade X.Y.Z\"` |\n\nThen merge and tag:\n\n```bash\ngit tag v0.17.0 \u0026\u0026 git push origin v0.17.0\n```\n\nCI validates all three files are consistent with the tag before publishing to [GitHub Releases](https://github.com/amd/gaia/releases) and [PyPI](https://pypi.org/project/amd-gaia/).\n\n---\n\n## Contributing\n\nWe welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details.\n\n- **Build agents** in your own repository using GAIA as a dependency\n- **Improve the framework** — check [GitHub Issues](https://github.com/amd/gaia/issues) for open tasks\n- **Add documentation** — examples, tutorials, and guides\n\n---\n\n## Contact\n\n- **Email**: [gaia@amd.com](mailto:gaia@amd.com)\n- **Discord**: [Join our community](https://discord.com/channels/1392562559122407535/1402013282495102997)\n- **Issues**: [GitHub Issues](https://github.com/amd/gaia/issues)\n\n---\n\n## License\n\n[MIT License](./LICENSE.md)\n\nCopyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.\nSPDX-License-Identifier: MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famd%2Fgaia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famd%2Fgaia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famd%2Fgaia/lists"}