Basic

Create a basic AI agent with ChatGPT-like web interface

Code

cookbook/os/interfaces/agui/basic.py

from agno.agent.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.os.interfaces.agui import AGUI

chat_agent = Agent(
    name="Assistant",
    model=OpenAIResponses(id="gpt-5.2"),
    instructions="You are a helpful AI assistant.",
    add_datetime_to_context=True,
    markdown=True,
)

agent_os = AgentOS(
    agents=[chat_agent],
    interfaces=[AGUI(agent=chat_agent)],
)
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="basic:app", reload=True)

Usage

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Set Environment Variables

   export OPENAI_API_KEY=your_openai_api_key
   
3. Install dependencies

   uv pip install -U agno ag-ui-protocol
   
4. Run Example

   python cookbook/os/interfaces/agui/basic.py
   

Key Features

• Web Interface: ChatGPT-like conversation experience
• Real-time Chat: Instant message exchange
• Markdown Support: Rich text formatting in responses
• DateTime Context: Time-aware responses
• Open Protocol: Compatible with AG-UI frontends

Setup Frontend

1. Clone AG-UI repository: git clone https://github.com/ag-ui-protocol/ag-ui.git
2. Install dependencies: cd ag-ui/typescript-sdk && pnpm install
3. Build integration: cd integrations/agno && pnpm run build
4. Start Dojo: cd ../../apps/dojo && pnpm run dev
5. Access at http://localhost:3000