amd-gaia 0.17.1

GAIA is a lightweight agent framework designed for the edge and AI PCs.

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 →

---

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 Qwen3-VL-4B
• Plugin System — Distribute agents via PyPI with auto-discovery
• Web UI Packaging — Generate modern interfaces for your agents

---

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: [e-mail]
• Discord: Join our community
• Issues: GitHub Issues

---

License

MIT License

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