> ## 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.

# Install & Setup

> Install the Agno SDK with uv or pip in a supported Python virtual environment.

## Install the Agno SDK

Agno v2.7.2 supports Python 3.9 or later in the Python 3 series (`>=3.9,<4`). The commands below select Python 3.12.

Use [uv](https://docs.astral.sh/uv/getting-started/installation/) for environment and package management, or use Python's built-in `venv` and pip.

**1. Create a virtual environment**

```bash uv theme={null}
uv venv --python 3.12
```

```bash pip (macOS / Linux) theme={null}
python3.12 -m venv .venv
```

```powershell pip (Windows) theme={null}
py -3.12 -m venv .venv
```

**2. Activate the virtual environment**

```bash macOS / Linux theme={null}
source .venv/bin/activate
```

```powershell Windows (PowerShell) theme={null}
.\.venv\Scripts\Activate.ps1
```

```cmd Windows (Command Prompt) theme={null}
.venv\Scripts\activate.bat
```

**3. Install Agno**

```bash uv theme={null}
uv pip install -U agno
```

```bash pip theme={null}
pip install -U agno
```

> [!NOTE]
>
> If pip reports an installation error, upgrade it with `python -m pip install --upgrade pip`.

***

## Upgrade Agno

To upgrade `agno`, run this in your virtual environment.

```bash uv theme={null}
uv pip install -U agno
```

```bash pip theme={null}
pip install -U agno --no-cache-dir
```


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