API Server

from gaia.api.openai_server import app
import uvicorn

# Run server (app is a module-level FastAPI instance). Keep it on loopback;
# see "Authentication" below before binding anything wider.
uvicorn.run(app, host="127.0.0.1", port=8080)

# Now accessible via the OpenAI SDK. The flagship ships registered as "gaia";
# add more in AGENT_MODELS (see below):
# from openai import OpenAI
# client = OpenAI(base_url="http://localhost:8080/v1", api_key="dummy")
# response = client.chat.completions.create(
#     model="my-agent",
#     messages=[{"role": "user", "content": "Write Python code"}]
# )

GAIA_API_CORS_ORIGINS="https://myapp.example.com" gaia api start

export GAIA_API_KEY=$(openssl rand -hex 32)
gaia api start
curl -H "Authorization: Bearer $GAIA_API_KEY" http://localhost:8080/v1/chat/completions ...

Permission denied: Refused to run 'write_file': it requires explicit user
approval, and the OpenAI-compatible API has no channel to ask for it. …

from gaia.agents.base.api_agent import ApiAgent
from gaia.agents.base.tools import tool

class MyAPIAgent(ApiAgent):
    """Agent exposed via OpenAI-compatible API."""

    def get_model_id(self) -> str:
        # Model ID shown in /v1/models
        return "my-custom-agent"

    def get_model_info(self) -> dict:
        return {
            "max_input_tokens": 4096,
            "max_output_tokens": 2048,
            "description": "Custom agent for data analysis",
            "capabilities": ["data_analysis", "visualization"],
        }

    def _get_system_prompt(self) -> str:
        return "You are a data analysis assistant."

    def _register_tools(self):
        @tool
        def analyze(data: str) -> dict:
            """Analyze data."""
            return {"analysis": "Data is valid"}

# src/gaia/api/agent_registry.py
AGENT_MODELS = {
    # 👇 New entry
    "my-agent": {
        "class_name": "my_package.my_agent.MyAPIAgent",
        "init_params": {"api_mode": True, "silent_mode": True},
        "description": "Custom agent for data analysis",
    },
}

from gaia.api.sse_handler import SSEOutputHandler

# Create SSE handler
sse = SSEOutputHandler()

# Use with agent (parameter name is output_handler, not console)
agent = MyAgent(output_handler=sse)

# Process query — events are pushed as they happen
result = agent.process_query("Generate code")

// Example payloads emitted by src/gaia/ui/sse_handler.py
{"event": "tool_start", "data": {"name": "generate_code", "args": {...}}}
{"event": "tool_result", "data": {"name": "generate_code", "result": {...}}}
{"event": "answer", "data": {"text": "Here's the code..."}}