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?
| Feature | Description |
|---|---|
| Local Inference | Run models on your machine for sensitive workloads and air-gapped deployments |
| No Cloud Inference Fees | Local models require no API subscription; optional cloud providers have their own pricing |
| 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
Copyright(C) 2024-2026 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: MIT
1 maintainer
Metadata
1 maintainer
Release files for amd-gaia 0.24.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| amd_gaia-0.24.1.tar.gz | 2.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| amd_gaia-0.24.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.9 MB
Release files / amd_gaia-0.24.1.tar.gz
| Download URL | amd_gaia-0.24.1.tar.gz |
|---|---|
| Size | 2.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a85aebe714acf09c5ee266f96c3f0ab681349b2dbb14d203e3c6dd4b3e15c47c
|
|
BLAKE2b-256 checksum How to use checksums |
a61eb74bf85b66ec1e67b4724efe76e4e7e91661f1de4d571e44158cac48df34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency logRelease files / amd_gaia-0.24.1-py3-none-any.whl
| Download URL | amd_gaia-0.24.1-py3-none-any.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e5d6e9da031a26a4bf97929f319e16e843f43aedeeeaf308b4f8c39d2aa14cd
|
|
BLAKE2b-256 checksum How to use checksums |
042315a5ddd4d19ea559c95e76e55e4987c484c10a6326932d12e55227c63154
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 16, 2026.
Transparency log
