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

amd_gaia-0.14.2/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: amd-gaia
+Version: 0.14.2
+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
+Provides-Extra: api
+Requires-Dist: fastapi>=0.115.0; extra == "api"
+Requires-Dist: uvicorn>=0.32.0; 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: 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="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.2/README.md

@@ -0,0 +1,123 @@
+# <img src="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.2}/pyproject.toml

@@ -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.2/src/amd_gaia.egg-info/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: amd-gaia
+Version: 0.14.2
+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
+Provides-Extra: api
+Requires-Dist: fastapi>=0.115.0; extra == "api"
+Requires-Dist: uvicorn>=0.32.0; 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: 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="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.2}/src/gaia/agents/base/agent.py

@@ -159,9 +159,38 @@ class Agent(abc.ABC):
         # Register tools for this agent
         self._register_tools()
 
-        # Update system prompt with available tools
+        # Update system prompt with available tools and response format
         tools_description = self._format_tools_for_prompt()
-        self.system_prompt += f"\n\n==== AVAILABLE TOOLS ====\n{tools_description}\n\n"
+        self.system_prompt += f"\n\n==== AVAILABLE TOOLS ====\n{tools_description}\n"
+
+        # Add JSON response format instructions (shared across all agents)
+        self.system_prompt += """
+==== RESPONSE FORMAT ====
+You must respond ONLY in valid JSON. No text before { or after }.
+
+**To call a tool:**
+{"thought": "reasoning", "goal": "objective", "tool": "tool_name", "tool_args": {"arg1": "value1"}}
+
+**To create a multi-step plan:**
+{
+  "thought": "reasoning",
+  "goal": "objective",
+  "plan": [
+    {"tool": "tool1", "tool_args": {"arg": "val"}},
+    {"tool": "tool2", "tool_args": {"arg": "val"}}
+  ],
+  "tool": "tool1",
+  "tool_args": {"arg": "val"}
+}
+
+**To provide a final answer:**
+{"thought": "reasoning", "goal": "achieved", "answer": "response to user"}
+
+**RULES:**
+1. ALWAYS use tools for real data - NEVER hallucinate
+2. Plan steps MUST be objects like {"tool": "x", "tool_args": {}}, NOT strings
+3. After tool results, provide an "answer" summarizing them
+"""
 
         # Initialize ChatSDK with proper configuration
         # Note: We don't set system_prompt in config, we pass it per request
@@ -199,12 +228,11 @@ class Agent(abc.ABC):
         """
         raise NotImplementedError("Subclasses must implement _get_system_prompt")
 
-    @abc.abstractmethod
     def _create_console(self):
         """
         Create and return a console output handler.
         Returns SilentConsole if in silent_mode, otherwise AgentConsole.
-        Subclasses should override this to provide domain-specific console output.
+        Subclasses can override this to provide domain-specific console output.
         """
         if self.silent_mode:
             # Check if we should completely silence everything (including final answer)

{amd_gaia-0.14.1 → amd_gaia-0.14.2}/src/gaia/agents/base/console.py

@@ -21,7 +21,7 @@ try:
 except ImportError:
     RICH_AVAILABLE = False
     print(
-        "Rich library not found. Install with 'pip install rich' for syntax highlighting."
+        "Rich library not found. Install with 'uv pip install rich' for syntax highlighting."
     )
 
 # Display configuration constants