> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentUI

> An open-source AgentUI for your AgentOS

![](https://mintcdn.com/agno-v2/QfHdyhk-tu-JEw8s/images/agent-ui.png?fit=max\&auto=format\&n=QfHdyhk-tu-JEw8s\&q=85\&s=72cd1f0888dea4f1ec60a67bff5664c4)

Agno provides an open-source UI for interacting with your agents. It's free to use and build on top of. Chat with your agents and view their memory, knowledge, and more.

> [!NOTE]
>
> The AgentOS only uses data in your database. No data is sent to Agno.

Built with Next.js and TypeScript, the Open Source Agent UI was developed in response to community requests for a self-hosted alternative following the success of [AgentOS](https://agno-v2.mintlify.site/agent-os/introduction.md).

## Get Started with Agent UI

To clone the Agent UI, run the following command in your terminal:

```bash theme={null}
npx create-agent-ui@latest
```

Enter `y` to create a new project, install dependencies, then run the agent-ui using:

```bash theme={null}
cd agent-ui && npm run dev
```

Open [http://localhost:3000](http://localhost:3000) to view the Agent UI, but remember to connect to your local agents.

![](https://mintcdn.com/agno-v2/JcEPRFr_oNRDYYcC/images/agent-ui-homepage.png?fit=max\&auto=format\&n=JcEPRFr_oNRDYYcC\&q=85\&s=02ec5ad7d40581f565548d64fd228fcc)

> **Clone the repository manually**
>
> You can also clone the repository manually
>
> ```bash theme={null}
> git clone https://github.com/agno-agi/agent-ui.git
> ```
>
> And run the agent-ui using
>
> ```bash theme={null}
> cd agent-ui && pnpm install && pnpm dev
> ```

## Connect your AgentOS

The Agent UI needs to connect to an AgentOS server, which you can run locally or on any cloud provider.

Let's start with a local AgentOS server. Create a file `agentos.py`

```python agentos.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.os import AgentOS
from agno.db.sqlite import SqliteDb
from agno.tools.duckduckgo import DuckDuckGoTools
from agno.tools.yfinance import YFinanceTools

agent_storage: str = "tmp/agents.db"

web_agent = Agent(
    name="Web Agent",
    model=OpenAIChat(id="gpt-4o"),
    tools=[DuckDuckGoTools()],
    instructions=["Always include sources"],
    # Store the agent sessions in a sqlite database
    db=SqliteDb(db_file=agent_storage),
    # Adds the current date and time to the context
    add_datetime_to_context=True,
    # Adds the history of the conversation to the messages
    add_history_to_context=True,
    # Number of history responses to add to the messages
    num_history_runs=5,
    # Adds markdown formatting to the messages
    markdown=True,
)

finance_agent = Agent(
    name="Finance Agent",
    model=OpenAIChat(id="gpt-4o"),
    tools=[YFinanceTools()],
    instructions=["Always use tables to display data"],
    db=SqliteDb(db_file=agent_storage),
    add_datetime_to_context=True,
    add_history_to_context=True,
    num_history_runs=5,
    markdown=True,
)

agent_os = AgentOS(agents=[web_agent, finance_agent])
app = agent_os.get_app()

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

In another terminal, run the AgentOS server:

**1. Setup your virtual environment**

```bash Mac theme={null}
python3 -m venv .venv
source .venv/bin/activate
```

```bash Windows theme={null}
python3 -m venv aienv
aienv/scripts/activate
```

**2. Install dependencies**

```bash Mac theme={null}
uv pip install -U openai ddgs yfinance "agno[os]"
```

```bash Windows theme={null}
uv pip install -U openai ddgs yfinance "agno[os]"
```

**3. Export your OpenAI key**

```bash Mac theme={null}
export OPENAI_API_KEY=sk-***
```

```bash Windows theme={null}
setx OPENAI_API_KEY sk-***
```

**4. Run the AgentOS**

```shell theme={null}
python agentos.py
```

> [!TIP]
>
> Make sure the module path in `agent_os.serve()` matches your filename (e.g., `"agentos:app"` for `agentos.py`).

## View the AgentUI

* Open [http://localhost:3000](http://localhost:3000) to view the Agent UI
* Enter the `localhost:7777` endpoint on the left sidebar and start chatting with your agents and teams!

<video autoPlay muted controls src="https://mintcdn.com/agno-v2/ZS8LtGag_F9zcKU4/videos/agent-ui-demo.mp4?fit=max&auto=format&n=ZS8LtGag_F9zcKU4&q=85&s=e4d7d59efdd156a677a403baeaa1d1a1" />

## Learn more

> **[AgentOS Introduction](https://agno-v2.mintlify.site/agent-os/introduction.md)**
>
> Run agents, teams, and workflows on the AgentOS runtime.

> **[Building Agents](https://agno-v2.mintlify.site/agents/building-agents.md)**
>
> Build your own agents


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.