# Installing AG2

AG2 is an open-source framework for building AI agents and multi-agent workflows. Let's get it installed.

AG2 is available on PyPI as [`ag2`](https://pypi.org/project/ag2). You can install it using `pip`, the Python package manager.

**Tip**  
We recommend using a virtual environment for your project to keep your packages contained. See [venv](https://docs.python.org/3/library/venv.html).

AG2 requires **Python version >= 3.10, < 3.14**. Run the following command to install AG2:

```
pip install "ag2[openai]"
```

This installs AG2 along with the [`openai`](https://pypi.org/project/openai) package.

**Note**  
**From ag2 version 0.8**: The OpenAI package, `openai` is not installed by default. You need to install it separately by adding the `openai` extra option.

### Install with Your Preferred Model Provider(s)

AG2 supports multiple AI model providers through **optional dependency groups**. Below are some examples of how to install AG2 with different model providers:

```
pip install "ag2[openai]"
pip install "ag2[gemini]"
pip install "ag2[anthropic,cohere,mistral]"
```

**MacOS Tip**  
On MacOS, if you get a `no matches found:` error, it usually means you missed the double quotes enclosing the package name. Wrap it in quotes as shown in the example and you should be fine:

```
pip install "ag2[openai]"
```

### Verify Your Installation

Confirm AG2 is installed correctly:

```
python -c "import autogen; print('AG2', autogen.__version__, 'installed successfully')"
```

You should see something like `AG2 x.x.x installed successfully` with your installed version number.

### Upgrading from `autogen` or `ag2`

If you've been using `autogen` or `ag2`, upgrading is simple — no need to reinstall from scratch. `autogen` and `ag2` are aliases for the same PyPI package.

To upgrade, run:

```
pip install -U "ag2[openai]"
```

### Next Step

You're all set! Head to the [Quick Start](https://docs.ag2.ai/latest/docs/quick-start/) to build your first agent in 3 minutes.