GAIA: AI Agent Framework for AMD Ryzen AI

April 14, 2026 · View on GitHub

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

See the installation guide for setup instructions.

Why GAIA?

Feature	Description
100% Local	All data stays on your machine—perfect for sensitive workloads and air-gapped deployments
Zero Cloud Costs	No API fees, no usage limits, no subscriptions—unlimited AI at no extra cost
Privacy-First	HIPAA-compliant, GDPR-friendly—ideal for healthcare, finance, and enterprise
Ryzen AI Optimized	Hardware-accelerated inference using NPU + iGPU on AMD Ryzen AI processors

Build Your First Agent

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 →

Key Capabilities

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

C++ Framework

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 →

Quick Install

pip install amd-gaia

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

System Requirements

Requirement	Minimum	Recommended
Processor	AMD Ryzen AI 300-series	AMD Ryzen AI Max+ 395
OS	Windows 11, Linux	-
RAM	16GB	64GB

Documentation

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

Releases

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

Release Process

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

#	File	What to change
1	`src/gaia/version.py`	Set `__version__ = "0.17.0"`
2	`docs/releases/v0.17.0.mdx`	Create release notes (see format guide)
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"`

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.

Contributing

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

Contact

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

License

MIT License