Skip to main content

Documentation Index

Fetch the complete documentation index at: https://spacesail.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Code

cookbook/os/interfaces/agui/basic.py
from agno.agent.agent import Agent
from agno.models.openai import OpenAIChat
from agno.os import AgentOS
from agno.os.interfaces.agui import AGUI

chat_agent = Agent(
    name="Assistant",
    model=OpenAIChat(id="gpt-5-mini"),
    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

Create a virtual environment

Open the Terminal and create a python virtual environment.
python3 -m venv .venv
source .venv/bin/activate
2

Set Environment Variables

export OPENAI_API_KEY=your_openai_api_key
3

Install libraries

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