Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

GAIA Logo GAIA: Local AI Agents for AMD Ryzen AI

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

GAIA is AMD's open-source agent factory. It uses coding-agent skills, evals and an auto-fix loop to improve and build agent harnesses 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.

Anyone can build an agent harness with GAIA. The GAIA agent is the one we built to show what it can do: conversation, documents, data, web, memory and skills in one agent.

I want to... Start here
Use GAIA: run the flagship agent in the desktop app or terminal Install GAIA, then the GAIA agent guide
Build with GAIA: make an agent harness with skills, evals and the SDK Composing skills, Agent evals, SDK reference

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. To make GAIA refuse every cloud AI model, run gaia config set network_policy local_ai_only.

Get Started →


Download

Download for Windows Download for macOS Download for Linux

One download for users: on Windows, one installer offers the desktop app, the terminal, or both. See Install GAIA for every platform, and its For developers section for script, pip/uv and source installs.

Email: the GAIA agent reads and searches your Gmail or Outlook inbox once you connect the Google or Microsoft connector — see Email. There is no separate email agent to install.


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

The SDK is the base layer under the GAIA agent. A minimal harness is a class with a prompt and tools:

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 Factory — Skills, an eval benchmark, and gaia eval agent --fix, which patches failing scenarios and re-runs them (guide)
  • Agent SDK — 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
  • Skills — Extend the GAIA agent with a SKILL.md, no code required (guide)

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 — Install GAIA and build a first harness 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 Add "releases/v0.17.0" to the Releases tab pages array

Then run python util/release_versions.py --stamp. It writes every version field that follows version.py, including the docs.json navbar label, the Agent UI package, and the Terminal UI's hub manifest; lint fails if one drifts. Commit what it changed with the PR, 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


License

MIT License

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

Metadata

Release files for amd-gaia 0.27.0rc2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for amd-gaia 0.27.0rc2
File Size Uploaded Provenance Actions
amd_gaia-0.27.0rc2.tar.gz 5.8 MB With provenance Details for amd_gaia-0.27.0rc2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for amd-gaia 0.27.0rc2
File Interpreter ABI Platform Actions
amd_gaia-0.27.0rc2-py3-none-any.whl Python 3 none any Details for amd_gaia-0.27.0rc2-py3-none-any.whl

Total release size: 11.9 MB

Release files / amd_gaia-0.27.0rc2.tar.gz

Download URL amd_gaia-0.27.0rc2.tar.gz
Size 5.8 MB
Tags Source
SHA-256 checksum
How to use checksums
9720f5e0d1a8581cc5d8636e249230a365aec692a5539b1ce1b3154c613450a4
BLAKE2b-256 checksum
How to use checksums
0e8e977e9b37de332c5d8493e13a4c5ee9c51edaa3e8a8b708f2afac42f91782
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 19, 2026.

Transparency log

Release files / amd_gaia-0.27.0rc2-py3-none-any.whl

Download URL amd_gaia-0.27.0rc2-py3-none-any.whl
Size 6.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
34037bc10cb05603d27cecae2fbfdee79d72981444e813c0e11ba4e932ea0b8d
BLAKE2b-256 checksum
How to use checksums
ed91d1c5282efc76da873bc5c3be223029ed8b70d6b4a375c4d2eb376928dd72
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 19, 2026.

Transparency log

Security for amd-gaia 0.27.0rc2

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for amd_gaia-0.27.0rc2.tar.gz

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 Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page