# Agno Integration

Agno is a Python agent framework with built-in AG-UI support via `AgentOS`. The integration is straightforward -- Agno's `AGUI` interface handles the AG-UI protocol natively.

## Prerequisites

- Python 3.12+
- Node.js 20+
- OpenAI API key

## Python Dependencies

```toml
[project]
dependencies = [
    "agno>=1.7.8",
    "openai>=1.88.0",
    "yfinance>=0.2.63",
    "fastapi>=0.115.13",
    "uvicorn>=0.34.3",
    "ag-ui-protocol>=0.1.8",
    "python-dotenv>=1.0.0",
]
```

## Agent Definition (agent/src/agent.py)

```python
from agno.agent.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.yfinance import YFinanceTools
from .tools.backend import get_weather
from .tools.frontend import add_proverb, set_theme_color

agent = Agent(
    model=OpenAIChat(id="gpt-4o"),
    tools=[
        # Backend tools -- executed on the server
        YFinanceTools(),
        get_weather,
        # Frontend tools -- executed on the client
        add_proverb,
        set_theme_color,
    ],
    description="You are a demonstrative agent for Agno and CopilotKit's integration.",
    instructions="Format your response using markdown and use tables to display data where possible.",
)
```

Key patterns:

- Agno has built-in tool collections like `YFinanceTools()` for financial data
- Frontend and backend tools are mixed in the same `tools` list -- the distinction is handled by the AG-UI adapter

## Server (agent/main.py)

```python
import dotenv
from agno.os import AgentOS
from agno.os.interfaces.agui import AGUI
from src.agent import agent

dotenv.load_dotenv()

# Build AgentOS with the AGUI interface
agent_os = AgentOS(agents=[agent], interfaces=[AGUI(agent=agent)])
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="main:app", port=8000, reload=True)
```

Key patterns:

- `AgentOS` is Agno's application container -- it manages agents and interfaces
- `AGUI(agent=agent)` registers the AG-UI interface for the agent
- `agent_os.get_app()` returns a FastAPI/ASGI app
- The AG-UI endpoint is served at `/agui` by default

## Next.js Route (src/app/api/copilotkit/[[...slug]]/route.ts)

```typescript
import {
  CopilotRuntime,
  createCopilotHonoHandler,
  InMemoryAgentRunner,
} from "@copilotkit/runtime/v2";
import { HttpAgent } from "@ag-ui/client";
import { handle } from "hono/vercel";

const runtime = new CopilotRuntime({
  agents: {
    default: new HttpAgent({
      url:
        (process.env.AGENT_URL || "http://localhost:8000").replace(/\/$/, "") +
        "/agui",
    }),
  },
  runner: new InMemoryAgentRunner(),
});

const app = createCopilotHonoHandler({
  runtime,
  basePath: "/api/copilotkit",
});

export const GET = handle(app);
export const POST = handle(app);
export const PATCH = handle(app);
export const DELETE = handle(app);
```

Note the URL path is `/agui` -- this is where Agno's `AGUI` interface mounts.

## Environment

```bash
export OPENAI_API_KEY="your-openai-api-key-here"
# Or create agent/.env with the key
```