Skip to content

amd/gaia

Repository files navigation

GAIA Logo GAIA: AI Agent Framework for AMD Ryzen AI

GAIA Build Installer GAIA CLI Tests Latest Release PyPI GitHub downloads OS - Windows OS - Linux Python 3.10+ License: MIT Discord

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 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


License

MIT License

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