GAIA：面向 AMD Ryzen AI 的 AI Agent 框架

GAIA 是 AMD 推出的开源框架，用于构建在 AMD Ryzen AI 硬件上** 100% 本地运行**的智能 AI Agent。在享受硬件加速性能的同时，确保数据隐私、免除云端成本，并可在物理隔离（air-gapped）的环境中部署。

立即开始 →

为什么选择 GAIA？

特性	描述
100% 本地化	所有数据均保留在您的机器上——非常适合敏感工作负载和物理隔离部署
零云端成本	无 API 费用、无使用限制、无订阅费——以零额外成本获取无限 AI 能力
隐私优先	符合 HIPAA 和 GDPR 标准——适用于医疗保健、金融和企业环境
Ryzen AI 优化	利用 AMD Ryzen AI 处理器上的 NPU + iGPU 实现硬件加速推理

构建您的第一个 Agent

from gaia.agents.base.agent import Agent
from gaia.agents.base.tools import tool

class MyAgent(Agent):
    """一个带有自定义工具的简单 Agent。"""

    def _get_system_prompt(self) -> str:
        return "You are a helpful assistant."

    def _register_tools(self):
        @tool
        def get_weather(city: str) -> dict:
            """获取指定城市的实时天气。"""
            return {"city": city, "temperature": 72, "conditions": "Sunny"}

agent = MyAgent()
result = agent.process_query("What's the weather in Austin?")
print(result)

查看完整的快速入门指南 →

核心能力

Agent 框架 — 提供工具编排、状态管理和错误恢复的基础类
RAG 系统 — 用于问答的文档索引和语义搜索功能
语音集成 — 基于 Whisper ASR + Kokoro TTS 实现语音交互
视觉模型 — 通过 Qwen3-VL-4B 从图像中提取文本
插件系统 — 支持通过 PyPI 分发带有自动发现功能的 Agent
Web UI 打包 — 为您的 Agent 生成现代化的交互界面

C++ 框架

GAIA 基础 Agent 框架的 C++17 版本可在 cpp/ 中找到。它实现了相同的 Agent 循环、工具注册表和 MCP 客户端接口，且不依赖任何 Python 环境——非常适合嵌入原生应用程序或资源受限的环境中。

#include 

class MyAgent : public gaia::Agent {
protected:
    std::string getSystemPrompt() const override {
        return "You are a helpful assistant.";
    }
};

C++ 构建与使用说明 →

快速安装

pip install amd-gaia

有关包括 Lemonade Server 在内的完整设置说明，请参阅 快速入门指南。

系统要求

要求	最低配置	推荐配置
处理器	AMD Ryzen AI 300 系列	AMD Ryzen AI Max+ 395
操作系统	Windows 11, Linux	-
内存	16GB	64GB

文档

快速入门 — 10 分钟内构建您的第一个 Agent
SDK 参考 — 完整的 API 文档
指南 — 聊天、语音、RAG 等
常见问题 (FAQ) — 常见问题解答

版本发布

请在文档网站查看完整的版本说明 (Release Notes)，或浏览 GitHub Releases。

发布流程

若要发布新版本（例如 v0.17.0），请创建一个发布 PR 并更新以下 3 个文件：

#	文件	修改内容
1	`src/gaia/version.py`	设置 `__version__ = "0.17.0"`
2	`docs/releases/v0.17.0.mdx`	创建发布说明（查看格式指南）
3	`docs/docs.json`	更新版本索引

amd/gaia