GAIA：AMD Ryzen AI 本地智能体框架

项目简介

GAIA 是 AMD 开源的 agent factory（智能体工厂）。它借助编程智能体的 skills、评测（evals）与自动修复循环，来构建和改进能在 AMD Ryzen AI 硬件上默认本地运行的 agent harness。本地推理让数据留在自己的机器上，省去云端调用费用，也支持离线（air-gapped）部署并获得硬件加速。

任何人都可以用 GAIA 构建自己的 agent harness；GAIA agent 是官方提供的示范智能体，把对话、文档、数据、网页、记忆和 skills 集成在一个智能体里。

主要功能

• Agent Factory：提供 skills、评测基准与 gaia eval agent --fix，可自动修补失败的场景并重新运行。
• Agent SDK：基类内置工具编排、状态管理与错误恢复。
• Agent UI：隐私优先的桌面应用，包含聊天、文件浏览、文档索引与工具执行。
• RAG 系统：支持 50+ 文件格式的文档索引与语义检索问答。
• 语音交互：Whisper ASR + Kokoro TTS。
• 视觉模型：用 Qwen3-VL-4B 从图片中提取文字。
• MCP 集成：可连接任意 MCP server 获取外部工具能力。
• Skills：写一个 SKILL.md 即可扩展 GAIA agent，无需写代码。
• C++ 框架：cpp/ 下提供 C++17 移植版，实现同样的 agent loop、工具注册表和 MCP 客户端接口，不依赖 Python，适合嵌入原生应用或资源受限环境。
• 终端与脚本用法：用 gaia -p "<prompt>" 单次运行，--output-format json 输出 JSON，失败时返回非零退出码，便于接入 CI。

安装与使用

快速安装：

pip install amd-gaia

Windows 用户只需一个安装包，即可选择安装桌面应用、终端，或两者都装。脚本、pip/uv 与源码安装方式见安装指南。

Email agent 通过 gaia hub install email 安装，它会把一个二进制 sidecar 下载到 GAIA agents 目录，不需要 PyPI wheel 或 Node.js 工具链。

用 SDK 构建一个最小 harness：

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

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

完整入门流程见 Quickstart，API 细节见 SDK 文档。

注意事项

• 系统要求：处理器最低 AMD Ryzen AI 300 系列，推荐 Ryzen AI Max+ 395；操作系统 Windows 11 或 Linux；内存最低 16GB，推荐 64GB。
• 终端 UI 可通过 /provider 连接可选的 Fireworks AI 与 AMD LLM Gateway 云端对话，此时对话历史会发送给所选服务商；若要禁止使用任何云端 AI 模型，可运行 gaia config set network_policy local_ai_only。
• 项目以 MIT 许可证开源。

本作品整理自 GitHub 开源项目 amd/gaia，原作者 @amd，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。