​
Overview

Get started with AgentOS by setting up a minimal local instance. This guide will have you running your first agent in minutes, with optional paths to add advanced features through our examples.

​
Prerequisites

  • Python 3.9+
  • An LLM provider API key (e.g., OPENAI_API_KEY)

​
Installation

Create and activate a virtual environment: 
# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate
Install dependencies: 
pip install -U agno fastapi uvicorn openai

​
Minimal Setup

Create my_os.py: 
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.os import AgentOS

assistant = Agent(
    name="Assistant",
    model=OpenAIChat(id="gpt-5-mini"),
    instructions=["You are a helpful AI assistant."],
    markdown=True,
)

agent_os = AgentOS(
    os_id="my-first-os",
    description="My first AgentOS",
    agents=[assistant],
)

app = agent_os.get_app()

if __name__ == "__main__":
    # Default port is 7777; change with port=...
    agent_os.serve(app="my_os:app", reload=True)

​
Running Your OS

Start your AgentOS: 
python my_os.py
Access your running instance:
  • App Interface: http://localhost:7777
  • Configuration: http://localhost:7777/config
  • API Reference: View the AgentOS API documentation for programmatic access

​
Connecting to the Control Plane

With your AgentOS now running locally (http://localhost:7777), you can connect it to the AgentOS control plane for a enhanced management experience. The control plane provides a centralized interface to interact with your agents, manage knowledge bases, track sessions, and monitor performance.

​
Next Steps

Connect to Control Plane

Connect your running OS to the AgentOS control plane interface

Browse Examples

Explore comprehensive examples for advanced AgentOS configurations