> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/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.

<Steps>
  <Step title="Create a virtual environment">
    <CodeGroup>
      ```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
      ```
    </CodeGroup>
  </Step>

  <Step title="Activate the virtual environment">
    <CodeGroup>
      ```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
      ```
    </CodeGroup>
  </Step>

  <Step title="Install Agno">
    <CodeGroup>
      ```bash uv theme={null}
      uv pip install -U agno
      ```

      ```bash pip theme={null}
      pip install -U agno
      ```
    </CodeGroup>
  </Step>
</Steps>

<br />

<Note>
  If pip reports an installation error, upgrade it with `python -m pip install --upgrade pip`.
</Note>

***

## Upgrade Agno

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

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

  ```bash pip theme={null}
  pip install -U agno --no-cache-dir
  ```
</CodeGroup>