GAIA v0.15.0 Release Notes

Overview

This release transforms GAIA into a full AI Agent Framework (SDK v1.0.0), introduces the Medical Intake Agent with Dashboard, adds the Database Module for SQLite-backed agents, and includes comprehensive documentation improvements with new playbooks.

Installation

# Install uv (ultra-fast Python package manager)
# Windows: irm https://astral.sh/uv/install.ps1 | iex
# macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

git clone https://github.com/amd/gaia.git
cd gaia
uv venv .venv --python 3.12
source .venv/bin/activate  # Windows: .\.venv\Scripts\Activate.ps1
uv pip install -e .
gaia -v

Or install from PyPI:

uv pip install amd-gaia

What's New

🚀 SDK v1.0.0 - AI Agent Framework

GAIA is now positioned as a pure framework/SDK for building AI PC agents:

• 900+ line API reference with 20+ components
• 60+ MDX documentation files organized into tabs
• 55+ interface validation tests
• Mintlify-powered documentation site at amd-gaia.ai

from gaia import Agent, tool

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

    def _register_tools(self):
        @tool
        def greet(name: str) -> str:
            """Greet someone by name."""
            return f"Hello, {name}!"

🏥 Medical Intake Agent with Dashboard

Complete patient intake form processing system:

• Automatic file watching for intake forms (.png, .jpg, .pdf)
• VLM-powered data extraction (Qwen2.5-VL on NPU)
• SQLite database with 17 patient fields
• Real-time React dashboard with SSE updates
• Natural language patient queries

gaia-emr watch          # Auto-process forms
gaia-emr dashboard      # Launch web dashboard
gaia-emr query "Find patient John Smith"

🗄️ Database Module

New gaia.database module with two usage patterns:

DatabaseAgent (prototyping):

from gaia import DatabaseAgent

class MyAgent(DatabaseAgent):
    def __init__(self, **kwargs):
        super().__init__(db_path="data/app.db", **kwargs)

DatabaseMixin (production):

from gaia import Agent, DatabaseMixin, tool

class MyAgent(Agent, DatabaseMixin):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.init_db("data/app.db")

🧪 Testing Utilities Module

New gaia.testing module for testing agents without real LLM/VLM services:

• MockLLMProvider, MockVLMClient, MockToolExecutor
• temp_directory, temp_file, create_test_agent fixtures
• assert_llm_called, assert_tool_called assertions
• 51 unit tests with full coverage

from gaia.testing import MockLLMProvider, assert_llm_called

def test_my_agent():
    mock_llm = MockLLMProvider(responses=["I found the data"])
    agent = MyAgent(skip_lemonade=True)
    agent.chat = mock_llm
    result = agent.process_query("Find data")
    assert_llm_called(mock_llm)

💻 Hardware Advisor Agent

New example agent with LemonadeClient APIs for dynamic model recommendations:

python examples/hardware_advisor_agent.py

📚 GAIA Code Playbook

Complete 3-part playbook for the Code Agent:

• Part 1: Introduction and fundamentals
• Part 2: Application creation and development
• Part 3: Validation and building workflows

Improvements

Agent UX Enhancements

• Rich Panel Final Answers: Agent responses now appear with green-bordered panels and "✅ Final Answer" title
• Better Completion Messages: Removed confusing step counters, now shows clean "Processing complete!" message
• Enhanced Error Display: Shows execution trace with Query → Plan Step → Tool → Error, plus code context with line pointers

Code Agent

• Limited router to TypeScript only (other languages report helpful error)
• Fixed default path issue where create-next-app would fail on non-empty directories
• Added dynamic timer scaffolding and artifact-aware planning

Lemonade Server Integration

• Centralized initialization in LemonadeManager singleton
• Changed context size check from error to warning (agents continue running)
• Fixed VLM image processing breaking embeddings endpoint

Documentation

• New setup.mdx with step-by-step installation guide
• New glossary.mdx with 50+ GAIA terms
• Streamlined learning path: Quickstart → Hardware Advisor → Playbooks/Guides
• Applied <CodeGroup> component across multiple docs for compact command examples
• Standardized license headers across 90+ files
• Added source code links throughout documentation

PyPI Package

• Renamed from gaia to amd-gaia (import name remains gaia)
• Enhanced PyTorch CPU-only build support

Bug Fixes

• #1092: Agent receives empty response after tool execution - fixed duplicate message insertion
• #1088: Confusing agent completion messages showing incomplete steps
• #1087: Context size error now shows as warning instead of blocking
• Fix Blender MCP 'Namespace' object has no attribute 'stats' #134: Blender MCP 'Namespace' object has no attribute 'stats'
• #1075: VLM image processing breaks embeddings endpoint
• #1083: Agent tool calling fixed with JSON format instructions in base class
• #1095: Windows npx command can't find TypeScript compiler
• #1137: Code agent default path fails on non-empty directories
• #1079: Authentication flow for documentation sub-pages
• #940: Empty LLM response when last message has role==tool

Infrastructure

CI/CD

• All workflows now skip tests on draft PRs (unless ready_for_ci label added)
• New test_unit.yml workflow for fast unit/integration tests
• Updated GitHub Actions: actions/checkout v5, actions/setup-python v6

Documentation Site

• Access code protection via Express.js proxy server
• Railway deployment with cookie-based authentication
• Open redirect and XSS vulnerability fixes

Breaking Changes

None. All changes are additive.

Full Changelog

40 commits from 8 contributors

Key PRs:

• #1063 - Transform GAIA into AI Agent Framework (SDK v1.0.0)
• #1101 - Medical Intake Agent with Dashboard
• #1093 - Add Database Module with DatabaseMixin and DatabaseAgent
• #1098 - Add Testing Utilities Module
• #1131 - GAIA Code Playbook
• #1113 - Hardware Advisor agent
• #1112 - Fix agent empty response after tool execution
• #1085 - Rename PyPI package to amd-gaia
• #1067 - Centralize Lemonade Server Initialization

Full Changelog: v0.14.1...v0.15.0