amd-gaia 0.14.1__py3-none-any.whl → 0.14.2__py3-none-any.whl

amd_gaia-0.14.2.dist-info/METADATA

@@ -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.dist-info → amd_gaia-0.14.2.dist-info}/RECORD

@@ -1,15 +1,15 @@
-amd_gaia-0.14.1.dist-info/licenses/LICENSE.md,sha256=G1X5Kiqq2PwbU4BUcxqrxqo7tE_vlQZ_GC0VWembFi8,1103
+amd_gaia-0.14.2.dist-info/licenses/LICENSE.md,sha256=G1X5Kiqq2PwbU4BUcxqrxqo7tE_vlQZ_GC0VWembFi8,1103
 gaia/__init__.py,sha256=v8FpwoL5Hw4zlXkruJmebBqIpUr2lyPZSg2NrfAx-HM,108
-gaia/cli.py,sha256=Yu5AWW5RGD-b67oRHWIxIsGVxoic-Vsn-THmynzG088,224883
+gaia/cli.py,sha256=oUBmvDX4zj0aLD1pIFwxfJkA3ts-7KjBegnvhm3zles,224951
 gaia/logger.py,sha256=Z4IAkTRHFNeE2fd8p2OGYxt0qP5IWGBioo2GZ47z33g,6749
 gaia/security.py,sha256=IUBnJvRz6CkPh_yYxGwifsiGCMPquHlqKWcJehEu6t4,5989
 gaia/util.py,sha256=xpw398BY8Ez4WhdeZYSJq_lJgKi-0e78Ki6cy47708s,1615
-gaia/version.py,sha256=TvIO9tp3D5dRAoIw2Af2sSREAWKd3kVdEXg9YScol3M,2940
+gaia/version.py,sha256=bbMjXL9qt0IUJLC8jMdgOkI0WXSKQ7dcqrQ_an4O63A,2940
 gaia/agents/__init__.py,sha256=1_WqeEVnhTnAIIdu9bexrxOA713t6ULF8zQ9Wn2GFys,490
 gaia/agents/base/__init__.py,sha256=DgK0xd27Ef6dWMUHgtrnuSnrZvNB4wExKEyg_XeGoSI,373
-gaia/agents/base/agent.py,sha256=Fjr_KxdMU8z8hq49BEs-dEOA5NEjsU32vSzsmaAUmg0,94346
+gaia/agents/base/agent.py,sha256=MnuTCIEQ5YsMA1u_LFG2ju1vxN437uL5TXC1yit699Y,95260
 gaia/agents/base/api_agent.py,sha256=7O_46AICrvMSL-iP_8XLT6bYKEu3QXHJpbYGG-pawv8,4027
-gaia/agents/base/console.py,sha256=Cr44dhpmku7AFeK3fjL3uQYRXIExVrIi0vbakYBujj8,53667
+gaia/agents/base/console.py,sha256=c3WJfJrvsrhNa6ApH7CC6gr1WeaOSLuMll-EQVHyLNI,53670
 gaia/agents/base/mcp_agent.py,sha256=ixKnlqjP1YJ9GphShVWQ7r9LWInRV2rxSZI741OUssQ,2438
 gaia/agents/base/tools.py,sha256=KM3WruuLNvn4zAU7MlTjVE38NVfDJkofuD6QqLqf9So,2697
 gaia/agents/blender/agent.py,sha256=Qt6FkLVgOMi5UNTEMpxRG19Q33hlB5pKc0TwRryMPng,21270
@@ -23,7 +23,7 @@ gaia/agents/blender/core/rendering.py,sha256=UPCrROVdn5tATcv-af-gyk3F9BK0jtdYv-1
 gaia/agents/blender/core/scene.py,sha256=MNkkmz89kDtxXWh1hp6UWuyiMrELG-kX_mJUPZCq68M,7191
 gaia/agents/blender/core/view.py,sha256=iseY8jnESyXdkiAxctGm_sI52qYDEBAHsSZsKTGBT8I,5124
 gaia/agents/chat/__init__.py,sha256=RlWMJDCVWXGz7UEoc9nl5ZalswaWxyWnvc2ZeB9DC54,244
-gaia/agents/chat/agent.py,sha256=9sQiVv6XtvKraWwQXtkOTrW0SS09rFLIlbc-WRKM9w8,39499
+gaia/agents/chat/agent.py,sha256=KL3yVhmf7vip1gIVxVfpOcYyiSYLWzWGhQ4HSXtni0U,39017
 gaia/agents/chat/app.py,sha256=lj-MBLtMakij5pmslItAXKsudeHvn6E6VfaIFrWqKCk,48217
 gaia/agents/chat/session.py,sha256=iAGodYKzAQ-D-IRiW_PKHCCdwLNTMAuqT4h7h6DULOw,18364
 gaia/agents/chat/tools/__init__.py,sha256=7camTNaCUwcY96t8cVVWmi3VpXX_r4AoeWJubMehYEw,466
@@ -37,18 +37,18 @@ gaia/agents/code/models.py,sha256=v5uUuNvco3T7WkeGKkRg3V5sjNdw1-xjh9_-RjGNW84,32
 gaia/agents/code/schema_inference.py,sha256=4GNEsE0ZMQDIta03nLHYu7s3yqARKr_6QGuSW5xBlOU,12887
 gaia/agents/code/system_prompt.py,sha256=oDr-XIaQ5SdcU1kwBxCcc-SFdb2BsWP5TvFxYSgr58s,1525
 gaia/agents/code/orchestration/__init__.py,sha256=tmZ1RHP01TXl08PTL0a4e20-c8ifMJNylQS8vF2tyO0,689
-gaia/agents/code/orchestration/checklist_executor.py,sha256=QuYMv_5K9la8Kl7nZy3Qfuw1XjdtUEt6mRfSYOTzPCU,63317
-gaia/agents/code/orchestration/checklist_generator.py,sha256=k8x97zOENt4duNmJa34P4rcwvqTF1kw70jQCJjlPTKw,27930
-gaia/agents/code/orchestration/orchestrator.py,sha256=54uRusK-ON2msb-9NMHYwj90NzfYzBXmd7jarUums6w,23591
+gaia/agents/code/orchestration/checklist_executor.py,sha256=RT75Mceu8uhoJrdULcuEhIbC8FTfMtAmrHVg5_sSO3o,64442
+gaia/agents/code/orchestration/checklist_generator.py,sha256=si2uE_zy9woGD1CcmasRQdSjWA63HxJND00nypGGQX4,29181
+gaia/agents/code/orchestration/orchestrator.py,sha256=LNjU0_hS4-otlmKcF5sfQ6gc1kLYmBVmZl2oNBVL0XI,24308
 gaia/agents/code/orchestration/project_analyzer.py,sha256=mk--4PherF36AGoo_CeP4ZY_EzC1UqV4SL6CQqbUTT4,12257
-gaia/agents/code/orchestration/template_catalog.py,sha256=VayjrmlDFY0dCk89HaWhnzR_tXFPdDv-oPqnUxuGNJw,17930
+gaia/agents/code/orchestration/template_catalog.py,sha256=jKdK-CvqzUJT5bZ8uEVGbiElIDQXymcsdR5e80UFBrA,18339
 gaia/agents/code/orchestration/factories/__init__.py,sha256=jTUACMSl0Od5-OlwwEApXYRJQeNGGGXE1RZSfcBccZY,350
 gaia/agents/code/orchestration/factories/base.py,sha256=4PvfaxG8P_X9dcyniPuuQSGNqI4etnFY8qjVoiHodEk,1916
 gaia/agents/code/orchestration/factories/nextjs_factory.py,sha256=6tvLKo20AieLabyG0Rwc7Yk976QLZg4XulFC8zYVHnw,3712
 gaia/agents/code/orchestration/factories/python_factory.py,sha256=GrV7Sf-q7gNcBBDEzI-fmEwrukXBGbzz4rPMrGD16P4,3157
 gaia/agents/code/orchestration/steps/__init__.py,sha256=3P0LQNlWAe38FkBrmn8RMXCOBpM3pw34kNZTM-ej2zI,1659
 gaia/agents/code/orchestration/steps/base.py,sha256=EojY57GZKaQE28y0_Rt-I9T7Ds_g8vGEUQmTPyxS_TU,5991
-gaia/agents/code/orchestration/steps/error_handler.py,sha256=th4QnWu8Yxdjfz8bL_Ozu8KFy_Fa2xcZXwZrzjxt6ek,11968
+gaia/agents/code/orchestration/steps/error_handler.py,sha256=sVPga7l5g04EIpq1YxGzPtLNAAKyPUmAIJqN_sZmhhY,11971
 gaia/agents/code/orchestration/steps/nextjs.py,sha256=rv_VCF0eO6LNNpBkY2fEXSvP0RzI_qTAN2LOD1HHu74,31178
 gaia/agents/code/orchestration/steps/python.py,sha256=hE7vBPSxUbi1uZlAzHhXxC8MzbkSRsGU4bR-nXWOJIo,10746
 gaia/agents/code/orchestration/workflows/__init__.py,sha256=qobsddeNoOUlYFV5CH7hLRd00wqshFLqxmZh-pV0Q9Q,423
@@ -57,13 +57,13 @@ gaia/agents/code/orchestration/workflows/nextjs.py,sha256=CtlG6NYNTKwP63TAmIIDU1
 gaia/agents/code/orchestration/workflows/python.py,sha256=PwC8xLYGJactiw_1zV4dfecxp9w06bp2qRQmmvlmaOE,2551
 gaia/agents/code/prompts/__init__.py,sha256=ikoAO4w0t3D6KSblsiwQpvsvtj0I9uwYuNW_bNjXLhc,320
 gaia/agents/code/prompts/base_prompt.py,sha256=5S3VkoKfZv9mRvR7PR4iiMAn7aKDP7uYfgCP2bgrDtQ,2811
-gaia/agents/code/prompts/code_patterns.py,sha256=fvmcRzdVV09B_U7QClDuMZtvnsc1ahOFyF9ae86CguI,65356
+gaia/agents/code/prompts/code_patterns.py,sha256=io0XaxDf7-_R90_QMT0pGQ65UD3lwZMkQzVYurUOK8k,69566
 gaia/agents/code/prompts/nextjs_prompt.py,sha256=MlZq30ytFauA6SpUTHbGtpKGWzkDvlBjlA359YDrC2I,1376
 gaia/agents/code/prompts/python_prompt.py,sha256=tDYrCF1fu1YBRcezOBDVrRzhNchQQaRzrpwbT3GkljI,5266
 gaia/agents/code/tools/__init__.py,sha256=qFqvGOD8cwAoddFKjS4_4cyt7DTQhAAM-TIcDI4hfB0,1236
 gaia/agents/code/tools/cli_tools.py,sha256=54lHmL_hRljqelxvSJNu-JxGC_l0pbWJlyu5wA7MdHA,39814
-gaia/agents/code/tools/code_formatting.py,sha256=wyc5XbnTRs6hSF7uwv-boP-AEUSKy4XGKwLTtMWbsBY,12574
-gaia/agents/code/tools/code_tools.py,sha256=XPQnrUpgdgKjiB0UJiwUOXEf3JWrlY-5uFbOAIfY31s,28199
+gaia/agents/code/tools/code_formatting.py,sha256=dP4wXbtvlaXmj16xFArFUUIkau3RQHREPLWZ-0q1E44,12577
+gaia/agents/code/tools/code_tools.py,sha256=cvF8NL_3HZ8ploIE5LFepHvYFW0GbXxiSANbTSieCaA,28202
 gaia/agents/code/tools/error_fixing.py,sha256=pl6zJm0_cYH0oj-z1LkDuM1mk611J1ssc5AlvSNT6Zo,58989
 gaia/agents/code/tools/external_tools.py,sha256=sGPPUw8LRwV9Ow1kPVFam_AlsLsTVNWsU0TbCrhsOm8,7493
 gaia/agents/code/tools/file_io.py,sha256=Yu_FE1fpqepWqUibHKL76TGEF70k6K5shQ7YmS4_mig,33852
@@ -73,7 +73,7 @@ gaia/agents/code/tools/testing.py,sha256=UadAIUeNFKE90sPEiX3nuM16Wo9FyeQjyJPZ7TF
 gaia/agents/code/tools/typescript_tools.py,sha256=p7S2sF2XypJCX4OSqS9P916Q5-Wp0HYoib1xcbsAhPw,4499
 gaia/agents/code/tools/validation_parsing.py,sha256=BdZDMAHnoWyhk20NuDadrFtCluvVqvpVdZ6eWAZyqjI,17300
 gaia/agents/code/tools/validation_tools.py,sha256=xM0FEfKpAWEHyEKDXdWAJBVjfuIiEnShXUA9qzk3EnI,36265
-gaia/agents/code/tools/web_dev_tools.py,sha256=J5dwsmZNGu06FrVBVwMcHAEDMHy5Vw0CE9RHkWmr43U,77670
+gaia/agents/code/tools/web_dev_tools.py,sha256=KU13i2OsgBBc7JlaDhyfxJYy5h9VmNrUlo0060dUWcg,78400
 gaia/agents/code/validators/__init__.py,sha256=gvCXPdksZs703Lkg-3Bs3CoC3k51K9LIUoiZux8koo0,509
 gaia/agents/code/validators/antipattern_checker.py,sha256=4KQtE6yLLxK9tx2M6y8Pz8do5twIUyLWjeIqRcLpqdc,8614
 gaia/agents/code/validators/ast_analyzer.py,sha256=KjZjOFeFWmheO7vScZsCq9m0h62Sdu5O1epOeKWAt9g,6980
@@ -98,18 +98,18 @@ gaia/apps/llm/__init__.py,sha256=TIepjYRrjI6A4M3l8hfhKRZnwHR38r1ZDQDFfGucuY4,162
 gaia/apps/llm/app.py,sha256=takotX-pAQUg8-teig7cF0jOCZYe-fmqbMP_9GpdInE,5097
 gaia/apps/summarize/app.py,sha256=roSFU8VUBNcKNXxxKQ3V_F0eyF5rvst1gAGqcojmJH8,24758
 gaia/apps/summarize/html_viewer.py,sha256=EszoiclACH4i28jB7Rz10m3vpzVd-6skV0juYHA5Yz4,4314
-gaia/apps/summarize/pdf_formatter.py,sha256=kp9_AR1fY-wOOP1-zX6tnEifTZW5XG3RAzu9sAZ4uHY,10708
+gaia/apps/summarize/pdf_formatter.py,sha256=oCLNqT7vY4mopYb8KPpB-vHMrvCeM_6qCnIh4srV1jo,10711
 gaia/audio/__init__.py,sha256=v8FpwoL5Hw4zlXkruJmebBqIpUr2lyPZSg2NrfAx-HM,108
-gaia/audio/audio_client.py,sha256=Qniq9k0Gf7tkBon1jTHyha5qI1PV6aFa6VJ9DVBL6ak,19008
+gaia/audio/audio_client.py,sha256=a1Y2yK02-gmLaBdHOEwD5esEkWbg2rEhRqRVQwE5VX8,19018
 gaia/audio/audio_recorder.py,sha256=2YfJE-7S4uW7kzOAuW7Gkl3xX6WQljARKKUq2Ao4c1M,10009
-gaia/audio/kokoro_tts.py,sha256=eMKSsesiaUCp1RE3HP7LJP-KtDnP_LeluB6xu6JSX8E,22422
-gaia/audio/whisper_asr.py,sha256=6y8qzdi9timbP-Fnq44eLbbATcLMhEA3ryFjobLrID0,16940
+gaia/audio/kokoro_tts.py,sha256=paI1MwIdjYKL2c-Alq7QfIFRvHCGFnN6IfaXgrIM0z4,22430
+gaia/audio/whisper_asr.py,sha256=MNNxYNMKkblv28rf5Qa0GxiL6Qu8yftk6SWr97ro7zs,16948
 gaia/chat/__init__.py,sha256=LaQkeWzHVMkpOjQrawWrSiu2Q0i4OkVJ57p4pzrBWNg,365
 gaia/chat/app.py,sha256=-occvE-x1zRibu4qfCuvWQbEZC2rkfPjYd3DHYK9TXA,12760
 gaia/chat/prompts.py,sha256=cf5tMjS0qJoPscaejKCREEJ7-wy510ndihLuey39ma8,22089
-gaia/chat/sdk.py,sha256=wchESe2Qxq1ASr7aTWAzruDEuqzeEi_AtQLEuGSXW5U,44818
-gaia/eval/batch_experiment.py,sha256=MAyhHGPXXTn9IQF9OdAjEn8cyycbllmE03L006G8s4o,101881
-gaia/eval/claude.py,sha256=p1b_ovkA9XClDyUWJF-Eu6oP3nehNvequKsh5JplZ78,21170
+gaia/chat/sdk.py,sha256=EfQ1zDRNS_RueHnJrNQ6cdt-GosECmH-0cfFRMWIQc0,44824
+gaia/eval/batch_experiment.py,sha256=mKP11D1YSPCSPo5pxloMO_XjO8WHiAHXr8mE-Z0MNs0,101884
+gaia/eval/claude.py,sha256=JpjEjWT00qWgiq356I7Eq6LCjmgF5f60gav_jAi4H_A,21186
 gaia/eval/config.py,sha256=UQA1L5zBRGfLfhawRI8dYIczEdUzQ0qIlDzRDf1DQ9Q,1658
 gaia/eval/email_generator.py,sha256=fvn_zG4XDgt1a1Z50QEvpluF-imYfRX5I9R5vsnh5bs,21719
 gaia/eval/eval.py,sha256=56ukOYOgornJNWeJTENTBWMloOf_ZaACuYKX0tryhE4,151009
@@ -776,7 +776,7 @@ gaia/eval/webapp/public/styles.css,sha256=YTn_pyzKY3vzl1APs52vmtw03aQ0OOaIKESRFD
 gaia/llm/__init__.py,sha256=v8FpwoL5Hw4zlXkruJmebBqIpUr2lyPZSg2NrfAx-HM,108
 gaia/llm/lemonade_client.py,sha256=sj2Z71ewGBjIQEPGBBIgtpgWw7Z6rBv9Gr_0OIQEid8,116251
 gaia/llm/lemonade_manager.py,sha256=LNNGXb1qeJ4NzpMDYxTVcwszGQ_kXx6U9YKSHNhMIH0,10600
-gaia/llm/llm_client.py,sha256=qB9l1wwT5aLANYjSETRTLs5-3fe6TTGTCMz-A6jplM4,29909
+gaia/llm/llm_client.py,sha256=tOo9tk645G6IcqPij2rdhpygJpovl3iu9hX6l-bqd4o,29912
 gaia/llm/vlm_client.py,sha256=VYskOi-ZinDhJQ2WRh-DG3a14Y2qYpRQVnLYHDAotF0,10681
 gaia/mcp/agent_mcp_server.py,sha256=zgIjqEwYiLy1RyPLAiQ8GCBZAEKQD4QcB2B0McfP-Ws,10397
 gaia/mcp/blender_mcp_client.py,sha256=g5Q972WaK4qgSf1sQ_vl_BquY9Wzwm-a-5KjP2O6ox0,5105
@@ -788,13 +788,13 @@ gaia/mcp/servers/__init__.py,sha256=cGW-US8qMthLG0EOqr7qxjawAI5rOKoOLJh8DbfPoOU,
 gaia/mcp/servers/docker_mcp.py,sha256=ehDAcqR56te8FPT48N6kR6ARoSa0UcHs0nbapUelFqs,2183
 gaia/rag/__init__.py,sha256=Ui7XO7C5tB-oEHOG1kYgNYV7GZL3PbQRojDzSgLdNuw,336
 gaia/rag/app.py,sha256=Kee7h_llYBxI2rWgrkg2picSyIj_ECBmsnPrcWmbOs8,8872
-gaia/rag/demo.py,sha256=8St_FslmK_MSYUeEHQk7xQZanTvBpHT01bKmMF13CKY,10590
-gaia/rag/pdf_utils.py,sha256=2lSNhmoqxdTYy-SM6o8gJSD15WcUcX5Ywb6R-QES5vs,7693
-gaia/rag/sdk.py,sha256=y04-45BB2iNohnaJnXh1MF1O6G7gUQWbH69u2Z9aPIw,88003
+gaia/rag/demo.py,sha256=L9paeJk9dFbkq5g2Ip5nlNQ2AQH9dVSUDiMVtnc2gfE,10609
+gaia/rag/pdf_utils.py,sha256=mUWy4XZ4xLUbvbPbEUMcxwFnaK7ltKd46kdol0DgE2g,7696
+gaia/rag/sdk.py,sha256=GqCl5yFUjd6WK5wkm3UzHwRlh4NhvbfNhONR_5g9rdM,88011
 gaia/talk/app.py,sha256=T8nMkoGQluSo4TV-70OcwzRI48W87DC2O_HfyO0bHBA,8213
-gaia/talk/sdk.py,sha256=lWI_cV8JvTz5CIT35HYMG-KC0x5ty_-WvdaT8fx-kZc,17859
-amd_gaia-0.14.1.dist-info/METADATA,sha256=2Z9WUYsl5uxSiZzO0UYMcYTwPGNisTu7EMB_NjBQx34,30483
-amd_gaia-0.14.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-amd_gaia-0.14.1.dist-info/entry_points.txt,sha256=md5PIkmzuP8j-uzSLj5a1it-ZVrzAGupIihPrAig18E,149
-amd_gaia-0.14.1.dist-info/top_level.txt,sha256=79yz2gLmqK4bFQkuN8_cnHVY-lobuVT0Ww4YoO6OFvU,5
-amd_gaia-0.14.1.dist-info/RECORD,,
+gaia/talk/sdk.py,sha256=MXbyic5JH_TM8JBegwPnNTi58IfRx71sqX0TQV6ijXc,17862
+amd_gaia-0.14.2.dist-info/METADATA,sha256=jAKBDk9NRkNwkaJ56JsOdYG3a-tBVttUuwCTiBFL2MA,8674
+amd_gaia-0.14.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+amd_gaia-0.14.2.dist-info/entry_points.txt,sha256=md5PIkmzuP8j-uzSLj5a1it-ZVrzAGupIihPrAig18E,149
+amd_gaia-0.14.2.dist-info/top_level.txt,sha256=79yz2gLmqK4bFQkuN8_cnHVY-lobuVT0Ww4YoO6OFvU,5
+amd_gaia-0.14.2.dist-info/RECORD,,

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)

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

gaia/agents/chat/agent.py

@@ -411,13 +411,8 @@ No documents are currently indexed.
 """
 
         # Build the prompt with indexed documents section
-        base_prompt = """You are a helpful AI assistant that responds ONLY in valid JSON format.
-
-**CRITICAL RULES:**
-1. ALWAYS output valid JSON - every single response
-2. Do NOT add text before or after the JSON
-3. Do NOT use markdown code blocks
-4. Your entire response must be parseable as JSON
+        # NOTE: Base agent now provides JSON format rules, so we only add ChatAgent-specific guidance
+        base_prompt = """You are a helpful AI assistant with document search and RAG capabilities.
 """
 
         # Add indexed documents section
@@ -425,25 +420,7 @@ No documents are currently indexed.
             base_prompt
             + indexed_docs_section
             + """
-
-**JSON RESPONSE FORMATS:**
-
-Format 1 - Direct Answer (for general conversation):
-{
-  "thought": "brief reasoning",
-  "goal": "what you're trying to achieve",
-  "answer": "your response text here"
-}
-
-Format 2 - Tool Call (to get data or perform actions):
-{
-  "thought": "why you need this tool",
-  "goal": "what you're trying to achieve",
-  "tool": "tool_name",
-  "tool_args": {}
-}
-
-**WHEN TO USE EACH FORMAT:**
+**WHEN TO USE TOOLS VS DIRECT ANSWERS:**
 
 Use Format 1 (answer) for:
 - Greetings: {"answer": "Hello! How can I help?"}
@@ -847,9 +824,9 @@ When user asks to "index my data folder" or similar:
                 "\n❌ Error: Missing required package 'watchdog'\n\n"
                 "File watching requires the watchdog package.\n"
                 "Please install the required dependencies:\n"
-                "  pip install -e .[dev]\n\n"
+                '  uv pip install -e ".[dev]"\n\n'
                 "Or install watchdog directly:\n"
-                "  pip install watchdog>=2.1.0\n"
+                '  uv pip install "watchdog>=2.1.0"\n'
             )
             logger.error(error_msg)
             raise ImportError(error_msg)

gaia/agents/code/orchestration/checklist_executor.py

@@ -107,6 +107,12 @@ TEMPLATE_METADATA: Dict[str, Dict[str, Any]] = {
             ],
             "file_pattern": "src/app/{resource}s/[id]/page.tsx",
         },
+        "artifact-timer": {
+            "requires_client": True,
+            "expected_classes": [
+                "glass-card",
+            ],
+        },
     },
     "generate_api_route": {
         "collection": {
@@ -891,6 +897,7 @@ Return raw CSS starting with @tailwind base;"""
                 APP_GLOBALS_CSS,
                 CLIENT_COMPONENT_FORM,
                 CLIENT_COMPONENT_NEW_PAGE,
+                CLIENT_COMPONENT_TIMER,
                 SERVER_COMPONENT_DETAIL,
                 SERVER_COMPONENT_LIST,
             )
@@ -975,6 +982,7 @@ export default function Home() {
                 "form": CLIENT_COMPONENT_FORM,
                 "new": CLIENT_COMPONENT_NEW_PAGE,
                 "detail": SERVER_COMPONENT_DETAIL,
+                "artifact-timer": CLIENT_COMPONENT_TIMER,
             },
             "generate_api_route": {
                 "collection": api_route_collection,
@@ -1030,6 +1038,12 @@ export default function Home() {
 
         if template == "generate_react_component":
             variant = params.get("variant", "list")
+            component_name = params.get("component_name")
+            if component_name:
+                safe_name = "".join(
+                    ch for ch in component_name if ch.isalnum() or ch == "_"
+                )
+                component_name = safe_name or component_name
 
             if variant == "list":
                 return f"src/app/{resource}s/page.tsx"
@@ -1039,7 +1053,12 @@ export default function Home() {
                 return f"src/app/{resource}s/new/page.tsx"
             elif variant == "detail":
                 return f"src/app/{resource}s/[id]/page.tsx"
+            elif variant == "artifact-timer":
+                file_component = component_name or f"{resource_cap}Timer"
+                return f"src/components/{file_component}.tsx"
             else:
+                if component_name:
+                    return f"src/components/{component_name}.tsx"
                 return f"src/components/{resource_cap}{variant.capitalize()}.tsx"
 
         elif template == "generate_api_route":
@@ -1604,12 +1623,15 @@ if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma;
         variant = template_params.get("variant", "list")
 
         # Generate component_name from resource + variant
-        # e.g., "todo" + "list" -> "TodoList"
+        # Allow caller to provide an explicit component_name (used for timers)
         resource_capitalized = resource.capitalize() if resource else "Item"
         variant_capitalized = variant.capitalize() if variant else "List"
+        explicit_component = template_params.get("component_name")
 
         # Build component name based on variant
-        if variant == "list":
+        if explicit_component:
+            component_name = explicit_component
+        elif variant == "list":
             component_name = f"{resource_capitalized}List"
         elif variant == "form":
             component_name = f"{resource_capitalized}Form"
@@ -1619,6 +1641,8 @@ if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma;
             component_name = f"{resource_capitalized}Detail"
         elif variant == "actions":
             component_name = f"{resource_capitalized}Actions"
+        elif variant == "artifact-timer":
+            component_name = f"{resource_capitalized}Timer"
         else:
             component_name = f"{resource_capitalized}{variant_capitalized}"
 

gaia/agents/code/orchestration/checklist_generator.py

@@ -137,6 +137,8 @@ CHECKLIST_SYSTEM_PROMPT = """You are a code generation planner. Your task is to
 5. Ensure dependencies are satisfied (run setup before data, data before API, API before UI)
 6. Generate a complete checklist that creates a working application
 7. When follow-up fixes are requested, use `fix_code` to repair the specific files called out by validation/test logs. Extract the precise file paths and line numbers from the errors (see the Raw Validation Logs) and pass those line numbers inside the error description so the fixer knows exactly where to focus. Always reference the latest findings to decide which fixes to schedule before running validations again.
+8. If the user explicitly requests an additional UI artifact (countdown display, stats badge, etc.), schedule a `generate_react_component` step with the appropriate `artifact-*` variant (e.g., `"artifact-timer"`) and a descriptive `component_name`. Keep the artifact's logic inside that client component—server components like `page.tsx` should only render the artifact and pass any required props.
+9. **Route pairing requirement:** Whenever you schedule `{{"template": "generate_api_route", "params": {{"type": "collection", ...}}}}`, you MUST also include a matching `generate_api_route` item with `"type": "item"` for the same resource so detail pages can call `/api/<resource>/[id]`.
 
 This workflow repeats until all validations pass, so each checklist should either advance new functionality or explicitly repair the failures reported in the latest validation logs.
 
@@ -144,12 +146,13 @@ This workflow repeats until all validations pass, so each checklist should eithe
 
 For any app that manages resources (todos, posts, users, etc.), you MUST generate ALL of these UI components:
 
-1. **List page** (variant: "list") - Main page showing all items at /resources
-2. **Form component** (variant: "form") - Reusable form for create
+1. **Form component** (variant: "form") - Reusable form for create (generate this first so other pages can import it)
+2. **Artifact components** (variant: "artifact-*") - Any additional UI artifacts requested by the user (e.g., countdown display, stats badge). Generate these before any page that consumes them.
 3. **New page** (variant: "new") - Create new item at /resources/new
 4. **Edit page** (variant: "detail") - Edit single item at /resources/[id] with pre-populated form
+5. **List page** (variant: "list") - Main page showing all items at /resources
 
-Missing any of these will result in broken navigation! Always include all 4 variants.
+Missing any of the required components (form, new, detail, list) will result in broken navigation! When artifacts are requested, they must also be generated or the UI will be incomplete.
 
 ## REQUIRED: Setup and Validation Commands
 
@@ -181,6 +184,7 @@ Important:
 - Use exact template names from the catalog
 - Provide all required parameters
 - Order items by dependency (setup first, then data, then API, then UI)
+- REQUIRED ordering for `generate_react_component`: emit all non-`list` variants (form, new, detail, actions, artifact-*) before the `variant: "list"` call so the list can import previously generated components
 - Add semantic enhancements that make the app intuitive (e.g., checkboxes for todos)
 - For CRUD apps, ALWAYS include all 4 UI variants: list, form, new, detail
 - REQUIRED: Include `setup_app_styling` after `create_next_app`