amd-gaia 0.14.1__tar.gz → 0.14.3__tar.gz

{amd_gaia-0.14.1 → amd_gaia-0.14.3}/MANIFEST.in

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 
 # Include all JSON files in the interface directory

amd_gaia-0.14.3/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: amd-gaia
+Version: 0.14.3
+Summary: GAIA is a lightweight agent framework designed for the edge and AI PCs.
+Home-page: https://github.com/amd/gaia
+Author: AMD
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: openai
+Requires-Dist: pydantic>=2.9.2
+Requires-Dist: transformers
+Requires-Dist: accelerate
+Requires-Dist: python-dotenv
+Requires-Dist: aiohttp
+Requires-Dist: rich
+Requires-Dist: watchdog>=2.1.0
+Requires-Dist: pillow>=9.0.0
+Provides-Extra: api
+Requires-Dist: fastapi>=0.115.0; extra == "api"
+Requires-Dist: uvicorn>=0.32.0; extra == "api"
+Requires-Dist: python-multipart>=0.0.9; extra == "api"
+Provides-Extra: audio
+Requires-Dist: torch<2.4,>=2.0.0; extra == "audio"
+Requires-Dist: torchvision<0.19.0; extra == "audio"
+Requires-Dist: torchaudio; extra == "audio"
+Provides-Extra: blender
+Requires-Dist: bpy; extra == "blender"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.1.0; extra == "mcp"
+Requires-Dist: starlette; extra == "mcp"
+Requires-Dist: uvicorn; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-benchmark; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: memory_profiler; extra == "dev"
+Requires-Dist: matplotlib; extra == "dev"
+Requires-Dist: adjustText; extra == "dev"
+Requires-Dist: plotly; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: autoflake; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: responses; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+Provides-Extra: eval
+Requires-Dist: anthropic; extra == "eval"
+Requires-Dist: bs4; extra == "eval"
+Requires-Dist: scikit-learn>=1.5.0; extra == "eval"
+Requires-Dist: numpy<2.3.0,>=2.0; extra == "eval"
+Requires-Dist: pypdf; extra == "eval"
+Provides-Extra: talk
+Requires-Dist: pyaudio; extra == "talk"
+Requires-Dist: openai-whisper; extra == "talk"
+Requires-Dist: numpy==1.26.4; extra == "talk"
+Requires-Dist: kokoro>=0.3.1; extra == "talk"
+Requires-Dist: soundfile; extra == "talk"
+Requires-Dist: sounddevice; extra == "talk"
+Provides-Extra: youtube
+Requires-Dist: llama-index-readers-youtube-transcript; extra == "youtube"
+Provides-Extra: rag
+Requires-Dist: pypdf; extra == "rag"
+Requires-Dist: pymupdf>=1.24.0; extra == "rag"
+Requires-Dist: sentence-transformers; extra == "rag"
+Requires-Dist: faiss-cpu>=1.7.0; extra == "rag"
+Provides-Extra: lint
+Requires-Dist: black; extra == "lint"
+Requires-Dist: pylint; extra == "lint"
+Requires-Dist: isort; extra == "lint"
+Requires-Dist: flake8; extra == "lint"
+Requires-Dist: autoflake; extra == "lint"
+Requires-Dist: mypy; extra == "lint"
+Requires-Dist: bandit; extra == "lint"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# <img src="https://raw.githubusercontent.com/amd/gaia/main/src/gaia/img/gaia.ico" alt="GAIA Logo" width="64" height="64" style="vertical-align: middle;"> GAIA: AI Agent Framework for AMD Ryzen AI
+
+[![GAIA Build Installer](https://github.com/amd/gaia/actions/workflows/build_installer.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests "Check out our build")
+[![GAIA CLI Tests](https://github.com/amd/gaia/actions/workflows/test_gaia_cli.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests "Check out our cli tests")
+[![Latest Release](https://img.shields.io/github/v/release/amd/gaia?include_prereleases)](https://github.com/amd/gaia/releases/latest "Download the latest release")
+[![PyPI](https://img.shields.io/pypi/v/amd-gaia)](https://pypi.org/project/amd-gaia/)
+[![GitHub downloads](https://img.shields.io/github/downloads/amd/gaia/total.svg)](https://github.com/amd/gaia/releases)
+[![OS - Windows](https://img.shields.io/badge/OS-Windows-blue)](https://amd-gaia.ai/quickstart "Windows installation")
+[![OS - Linux](https://img.shields.io/badge/OS-Linux-green)](https://amd-gaia.ai/quickstart "Linux installation")
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289DA?logo=discord&logoColor=white)](https://discord.com/channels/1392562559122407535/1402013282495102997)
+
+**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.
+
+<p align="center">
+  <a href="https://amd-gaia.ai/quickstart"><strong>Get Started →</strong></a>
+</p>
+
+---
+
+## 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
+
+```python
+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 →](https://amd-gaia.ai/quickstart)**
+
+---
+
+## 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
+
+```bash
+pip install amd-gaia
+```
+
+For complete setup instructions including Lemonade Server, see the **[Quickstart Guide](https://amd-gaia.ai/quickstart)**.
+
+---
+
+## 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](https://amd-gaia.ai/quickstart)** — Build your first agent in 10 minutes
+- **[SDK Reference](https://amd-gaia.ai/sdk)** — Complete API documentation
+- **[Guides](https://amd-gaia.ai/guides/chat)** — Chat, Voice, RAG, and more
+- **[FAQ](https://amd-gaia.ai/reference/faq)** — Frequently asked questions
+
+---
+
+## Contributing
+
+We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details.
+
+- **Build agents** in your own repository using GAIA as a dependency
+- **Improve the framework** — check [GitHub Issues](https://github.com/amd/gaia/issues) for open tasks
+- **Add documentation** — examples, tutorials, and guides
+
+---
+
+## Contact
+
+- **Email**: [gaia@amd.com](mailto:gaia@amd.com)
+- **Discord**: [Join our community](https://discord.com/channels/1392562559122407535/1402013282495102997)
+- **Issues**: [GitHub Issues](https://github.com/amd/gaia/issues)
+
+---
+
+## License
+
+[MIT License](./LICENSE.md)
+
+Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+SPDX-License-Identifier: MIT

amd_gaia-0.14.3/README.md

@@ -0,0 +1,123 @@
+# <img src="https://raw.githubusercontent.com/amd/gaia/main/src/gaia/img/gaia.ico" alt="GAIA Logo" width="64" height="64" style="vertical-align: middle;"> GAIA: AI Agent Framework for AMD Ryzen AI
+
+[![GAIA Build Installer](https://github.com/amd/gaia/actions/workflows/build_installer.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests "Check out our build")
+[![GAIA CLI Tests](https://github.com/amd/gaia/actions/workflows/test_gaia_cli.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests "Check out our cli tests")
+[![Latest Release](https://img.shields.io/github/v/release/amd/gaia?include_prereleases)](https://github.com/amd/gaia/releases/latest "Download the latest release")
+[![PyPI](https://img.shields.io/pypi/v/amd-gaia)](https://pypi.org/project/amd-gaia/)
+[![GitHub downloads](https://img.shields.io/github/downloads/amd/gaia/total.svg)](https://github.com/amd/gaia/releases)
+[![OS - Windows](https://img.shields.io/badge/OS-Windows-blue)](https://amd-gaia.ai/quickstart "Windows installation")
+[![OS - Linux](https://img.shields.io/badge/OS-Linux-green)](https://amd-gaia.ai/quickstart "Linux installation")
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289DA?logo=discord&logoColor=white)](https://discord.com/channels/1392562559122407535/1402013282495102997)
+
+**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.
+
+<p align="center">
+  <a href="https://amd-gaia.ai/quickstart"><strong>Get Started →</strong></a>
+</p>
+
+---
+
+## 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
+
+```python
+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 →](https://amd-gaia.ai/quickstart)**
+
+---
+
+## 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
+
+```bash
+pip install amd-gaia
+```
+
+For complete setup instructions including Lemonade Server, see the **[Quickstart Guide](https://amd-gaia.ai/quickstart)**.
+
+---
+
+## 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](https://amd-gaia.ai/quickstart)** — Build your first agent in 10 minutes
+- **[SDK Reference](https://amd-gaia.ai/sdk)** — Complete API documentation
+- **[Guides](https://amd-gaia.ai/guides/chat)** — Chat, Voice, RAG, and more
+- **[FAQ](https://amd-gaia.ai/reference/faq)** — Frequently asked questions
+
+---
+
+## Contributing
+
+We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details.
+
+- **Build agents** in your own repository using GAIA as a dependency
+- **Improve the framework** — check [GitHub Issues](https://github.com/amd/gaia/issues) for open tasks
+- **Add documentation** — examples, tutorials, and guides
+
+---
+
+## Contact
+
+- **Email**: [gaia@amd.com](mailto:gaia@amd.com)
+- **Discord**: [Join our community](https://discord.com/channels/1392562559122407535/1402013282495102997)
+- **Issues**: [GitHub Issues](https://github.com/amd/gaia/issues)
+
+---
+
+## License
+
+[MIT License](./LICENSE.md)
+
+Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+SPDX-License-Identifier: MIT

{amd_gaia-0.14.1 → amd_gaia-0.14.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.black]
 line-length = 88
-target-version = ['py310', 'py311', 'py312']
+target-version = ['py312']
 exclude = '''
 (
   /(
@@ -24,7 +24,7 @@ skip_gitignore = true
 skip = [".git", "__pycache__", "venv", ".venv", ".mypy_cache", ".tox", ".eggs", "_build", "buck-out", "node_modules"]
 
 [tool.mypy]
-python_version = "3.10"
+python_version = "3.12"
 warn_return_any = true
 warn_unused_configs = true
 ignore_missing_imports = true
@@ -47,4 +47,17 @@ testpaths = ["tests"]
 python_files = ["test_*.py"]
 python_classes = ["Test*"]
 python_functions = ["test_*"]
-addopts = "--tb=short --strict-markers"
+addopts = "--tb=short --strict-markers"
+
+# UV configuration for PyTorch CPU-only builds
+# GAIA is optimized for AMD hardware and doesn't require NVIDIA/CUDA dependencies
+# This ensures torch, torchvision, and torchaudio are installed from CPU-only index
+[[tool.uv.index]]
+name = "pytorch-cpu"
+url = "https://download.pytorch.org/whl/cpu"
+explicit = true
+
+[tool.uv.sources]
+torch = [{ index = "pytorch-cpu" }]
+torchvision = [{ index = "pytorch-cpu" }]
+torchaudio = [{ index = "pytorch-cpu" }]

{amd_gaia-0.14.1 → amd_gaia-0.14.3}/setup.py

@@ -1,4 +1,4 @@
-# Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+# Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
 # SPDX-License-Identifier: MIT
 
 import re
@@ -27,7 +27,10 @@ setup(
         "gaia.llm",
         "gaia.audio",
         "gaia.chat",
+        "gaia.database",
         "gaia.talk",
+        "gaia.testing",
+        "gaia.utils",
         "gaia.apps",
         "gaia.apps.llm",
         "gaia.apps.summarize",
@@ -42,6 +45,8 @@ setup(
         "gaia.agents.chat",
         "gaia.agents.chat.tools",
         "gaia.agents.docker",
+        "gaia.agents.emr",
+        "gaia.agents.emr.dashboard",
         "gaia.agents.jira",
         "gaia.agents.code",
         "gaia.agents.code.orchestration",
@@ -73,11 +78,13 @@ setup(
         "aiohttp",
         "rich",
         "watchdog>=2.1.0",
+        "pillow>=9.0.0",
     ],
     extras_require={
         "api": [
             "fastapi>=0.115.0",
             "uvicorn>=0.32.0",
+            "python-multipart>=0.0.9",
         ],
         "audio": [
             "torch>=2.0.0,<2.4",
@@ -131,6 +138,7 @@ setup(
         ],
         "rag": [
             "pypdf",
+            "pymupdf>=1.24.0",
             "sentence-transformers",
             "faiss-cpu>=1.7.0",
         ],
@@ -161,6 +169,7 @@ setup(
             "gaia-cli = gaia.cli:main",
             "gaia-mcp = gaia.mcp.mcp_bridge:main",
             "gaia-mcp-atlassian = gaia.mcp.atlassian_mcp:main",
+            "gaia-emr = gaia.agents.emr.cli:main",
         ]
     },
     python_requires=">=3.10",

amd_gaia-0.14.3/src/amd_gaia.egg-info/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: amd-gaia
+Version: 0.14.3
+Summary: GAIA is a lightweight agent framework designed for the edge and AI PCs.
+Home-page: https://github.com/amd/gaia
+Author: AMD
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: openai
+Requires-Dist: pydantic>=2.9.2
+Requires-Dist: transformers
+Requires-Dist: accelerate
+Requires-Dist: python-dotenv
+Requires-Dist: aiohttp
+Requires-Dist: rich
+Requires-Dist: watchdog>=2.1.0
+Requires-Dist: pillow>=9.0.0
+Provides-Extra: api
+Requires-Dist: fastapi>=0.115.0; extra == "api"
+Requires-Dist: uvicorn>=0.32.0; extra == "api"
+Requires-Dist: python-multipart>=0.0.9; extra == "api"
+Provides-Extra: audio
+Requires-Dist: torch<2.4,>=2.0.0; extra == "audio"
+Requires-Dist: torchvision<0.19.0; extra == "audio"
+Requires-Dist: torchaudio; extra == "audio"
+Provides-Extra: blender
+Requires-Dist: bpy; extra == "blender"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.1.0; extra == "mcp"
+Requires-Dist: starlette; extra == "mcp"
+Requires-Dist: uvicorn; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-benchmark; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: memory_profiler; extra == "dev"
+Requires-Dist: matplotlib; extra == "dev"
+Requires-Dist: adjustText; extra == "dev"
+Requires-Dist: plotly; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: autoflake; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: responses; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+Provides-Extra: eval
+Requires-Dist: anthropic; extra == "eval"
+Requires-Dist: bs4; extra == "eval"
+Requires-Dist: scikit-learn>=1.5.0; extra == "eval"
+Requires-Dist: numpy<2.3.0,>=2.0; extra == "eval"
+Requires-Dist: pypdf; extra == "eval"
+Provides-Extra: talk
+Requires-Dist: pyaudio; extra == "talk"
+Requires-Dist: openai-whisper; extra == "talk"
+Requires-Dist: numpy==1.26.4; extra == "talk"
+Requires-Dist: kokoro>=0.3.1; extra == "talk"
+Requires-Dist: soundfile; extra == "talk"
+Requires-Dist: sounddevice; extra == "talk"
+Provides-Extra: youtube
+Requires-Dist: llama-index-readers-youtube-transcript; extra == "youtube"
+Provides-Extra: rag
+Requires-Dist: pypdf; extra == "rag"
+Requires-Dist: pymupdf>=1.24.0; extra == "rag"
+Requires-Dist: sentence-transformers; extra == "rag"
+Requires-Dist: faiss-cpu>=1.7.0; extra == "rag"
+Provides-Extra: lint
+Requires-Dist: black; extra == "lint"
+Requires-Dist: pylint; extra == "lint"
+Requires-Dist: isort; extra == "lint"
+Requires-Dist: flake8; extra == "lint"
+Requires-Dist: autoflake; extra == "lint"
+Requires-Dist: mypy; extra == "lint"
+Requires-Dist: bandit; extra == "lint"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# <img src="https://raw.githubusercontent.com/amd/gaia/main/src/gaia/img/gaia.ico" alt="GAIA Logo" width="64" height="64" style="vertical-align: middle;"> GAIA: AI Agent Framework for AMD Ryzen AI
+
+[![GAIA Build Installer](https://github.com/amd/gaia/actions/workflows/build_installer.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests "Check out our build")
+[![GAIA CLI Tests](https://github.com/amd/gaia/actions/workflows/test_gaia_cli.yml/badge.svg)](https://github.com/amd/gaia/tree/main/tests "Check out our cli tests")
+[![Latest Release](https://img.shields.io/github/v/release/amd/gaia?include_prereleases)](https://github.com/amd/gaia/releases/latest "Download the latest release")
+[![PyPI](https://img.shields.io/pypi/v/amd-gaia)](https://pypi.org/project/amd-gaia/)
+[![GitHub downloads](https://img.shields.io/github/downloads/amd/gaia/total.svg)](https://github.com/amd/gaia/releases)
+[![OS - Windows](https://img.shields.io/badge/OS-Windows-blue)](https://amd-gaia.ai/quickstart "Windows installation")
+[![OS - Linux](https://img.shields.io/badge/OS-Linux-green)](https://amd-gaia.ai/quickstart "Linux installation")
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289DA?logo=discord&logoColor=white)](https://discord.com/channels/1392562559122407535/1402013282495102997)
+
+**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.
+
+<p align="center">
+  <a href="https://amd-gaia.ai/quickstart"><strong>Get Started →</strong></a>
+</p>
+
+---
+
+## 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
+
+```python
+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 →](https://amd-gaia.ai/quickstart)**
+
+---
+
+## 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
+
+```bash
+pip install amd-gaia
+```
+
+For complete setup instructions including Lemonade Server, see the **[Quickstart Guide](https://amd-gaia.ai/quickstart)**.
+
+---
+
+## 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](https://amd-gaia.ai/quickstart)** — Build your first agent in 10 minutes
+- **[SDK Reference](https://amd-gaia.ai/sdk)** — Complete API documentation
+- **[Guides](https://amd-gaia.ai/guides/chat)** — Chat, Voice, RAG, and more
+- **[FAQ](https://amd-gaia.ai/reference/faq)** — Frequently asked questions
+
+---
+
+## Contributing
+
+We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details.
+
+- **Build agents** in your own repository using GAIA as a dependency
+- **Improve the framework** — check [GitHub Issues](https://github.com/amd/gaia/issues) for open tasks
+- **Add documentation** — examples, tutorials, and guides
+
+---
+
+## Contact
+
+- **Email**: [gaia@amd.com](mailto:gaia@amd.com)
+- **Discord**: [Join our community](https://discord.com/channels/1392562559122407535/1402013282495102997)
+- **Issues**: [GitHub Issues](https://github.com/amd/gaia/issues)
+
+---
+
+## License
+
+[MIT License](./LICENSE.md)
+
+Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+SPDX-License-Identifier: MIT