GAIA: AI Agent Framework for AMD Ryzen AI

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?

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

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:

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

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