Quickstart

npm install -g @amd-gaia/agent-ui

gaia-ui

npm install -g @amd-gaia/agent-ui@latest

npm install -g @amd-gaia/[email protected]

npm uninstall -g @amd-gaia/agent-ui
rm -rf ~/.gaia

npm uninstall -g @amd-gaia/agent-ui
Remove-Item -Recurse -Force "$env:USERPROFILE\.gaia"

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

class MyAgent(Agent):
    """A simple agent that can report system information."""

    def _get_system_prompt(self) -> str:
        return """You are a system monitoring assistant.
When users ask about time or system details, use the get_system_info tool."""

    def _register_tools(self):
        @tool
        def get_system_info() -> dict:
            """Get current time, date, platform, and Python version."""
            return {
                "time": datetime.now().strftime("%H:%M:%S"),
                "date": datetime.now().strftime("%Y-%m-%d"),
                "platform": platform.system(),
                "python": platform.python_version()
            }

# Use the agent. model_id pins the ~4B model that `gaia init` already
# downloaded; omit it and the agent base defaults to a much larger model
# that won't fit on most machines.
agent = MyAgent(model_id="Gemma-4-E4B-it-GGUF")
result = agent.process_query("What time is it and what system am I on?")
print(result.get("result"))

python my_agent.py

🤖 Processing: 'What time is it and what system am I on?'
...
🔧 Executing operation
  Tool: get_system_info

✅ Tool execution complete
{
  "time": "15:03:26",
  "date": "2025-12-17",
  "platform": "Windows",
  "python": "3.12.12"
}
...
✨ Processing complete!

The current time is 15:03:26 and you are on a Windows system running Python 3.12.12.

def _get_system_prompt(self) -> str:
    return """You are a system monitoring assistant.
When users ask about time or system details, use the get_system_info tool."""

@tool
def get_system_info() -> dict:
    """Get current time, date, platform, and Python version."""
    return {"time": "14:32:05", "platform": "Windows", ...}