coding

GAIA: AI Agent Framework for AMD Ryzen AI

GAIA is AMD's open-source framework for building intelligent AI agents that run locally by default on AMD Ryzen AI hardware. Local inference keeps your data private, avoids cloud usage fees, and supports air-gapped deployment with hardware-accelerated performance.

The terminal UI also supports optional Fireworks AI and AMD LLM Gateway chat through Lemonade. Use /provider to connect and choose a model; cloud chat sends conversation history to the selected provider. See AI provider setup.

---

Download

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.

---

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: [email protected]
• 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