GAIA Logo GAIA: AI Agent Framework for AMD Ryzen AI

GAIA CLI Tests Latest Release PyPI GitHub downloads OS - Windows OS - Linux Python 3.10+ License: MIT Discord

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.

Get Started →

Download for Windows Download for macOS Download for Linux

See the installation guide for setup instructions.

Note (Email agent): the Email agent installs with gaia hub install email, which fetches a binary sidecar into your GAIA agents directory — no PyPI wheel and no Node.js toolchain required. An npm client is also published for embedding the agent in a JS/TS app.

from gaia.agents.base.agent import Agent
from gaia.agents.base.tools import tool
class MyAgent(Agent):
 """A simple agent with custom tools."""
 def _get_system_prompt(self) -> str:
 return "You are a helpful assistant."
 def _register_tools(self):
 @tool
 def get_weather(city: str) -> dict:
 """Get weather for a city."""
 return {"city": city, "temperature": 72, "conditions": "Sunny"}
agent = MyAgent()
result = agent.process_query("What's the weather in Austin?")
print(result)

See the full quickstart guide →

• Agent Framework — Base class with tool orchestration, state management, and error recovery
• Agent UI — Privacy-first desktop app with chat, file browser, document indexing, and tool execution
• RAG System — Document indexing and semantic search for Q&A over 50+ file formats
• Voice Integration — Whisper ASR + Kokoro TTS for speech interaction (P0 enabling technology)
• Vision Models — Extract text from images with Qwen3-VL-4B
• MCP Integration — Connect to any MCP server for external tool access
• Plugin System — Distribute agents via PyPI with auto-discovery

A C++17 port of the GAIA base agent framework is available under cpp/. 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.

#include <gaia/agent.h>
class MyAgent : public gaia::Agent {
protected:
 std::string getSystemPrompt() const override {
 return "You are a helpful assistant.";
 }
};

C++ build and usage instructions →

pip install amd-gaia

For complete setup instructions including Lemonade Server, see the Quickstart Guide .

• Quickstart — Build your first agent in 10 minutes
• SDK Reference — Complete API documentation
• Guides — Chat, Voice, RAG, and more
• FAQ — Frequently asked questions

See the full Release Notes on the documentation site, or browse GitHub Releases.

To publish a new release (e.g. v0.17.0), create a release PR that updates these 3 files:

Then merge and tag:

git tag v0.17.0 && git push origin v0.17.0

CI validates all three files are consistent with the tag before publishing to GitHub Releases and PyPI.

We welcome contributions! See our Contributing Guide for details.

• Build agents in your own repository using GAIA as a dependency
• Improve the framework — check GitHub Issues for open tasks
• Add documentation — examples, tutorials, and guides

• Email: gaia@amd.com
• Discord: Join our community
• Issues: GitHub Issues

MIT License

Copyright(C) 2024-2026 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: MIT