GAIA is a lightweight agent framework designed for the edge and AI PCs.
Project description
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.
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
- RAG System — Document indexing and semantic search for Q&A
- Voice Integration — Whisper ASR + Kokoro TTS for speech interaction
- Vision Models — Extract text from images with Qwen2.5-VL
- Plugin System — Distribute agents via PyPI with auto-discovery
- Web UI Packaging — Generate modern interfaces for your agents
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
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-2025 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file amd_gaia-0.14.2.tar.gz.
File metadata
- Download URL: amd_gaia-0.14.2.tar.gz
- Upload date:
- Size: 1.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
438eb425887a37702f320646ca9d01929c3d7d9fdd23a89a6efa9bc058d31fe8
|
|
| MD5 |
4ff6728b42351aa989bbf1684178cf8f
|
|
| BLAKE2b-256 |
bbf7b7d6709b79954e1d8eda75223d0e511f93a8a629a10f421ed2bda01b6fe2
|
File details
Details for the file amd_gaia-0.14.2-py3-none-any.whl.
File metadata
- Download URL: amd_gaia-0.14.2-py3-none-any.whl
- Upload date:
- Size: 1.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b15dfabdef6d4df39e8f1a33cecd49da38baf5f3da078c3ed07ecf03b3f2b06
|
|
| MD5 |
edff0ecd64cc6d184509068ba594fcb3
|
|
| BLAKE2b-256 |
a5bc09355eb0786cf594b64d5eff58086ffcf7ac8e21351171e6220a17bd6970
|