Overview

Create a virtual environment (optional)

When installing AG2 locally, we recommend using a virtual environment for the installation. This will ensure that the dependencies for AG2 are isolated from the rest of your system.

venv

Create and activate:

python3 -m venv autogen
source autogen/bin/activate

To deactivate later, run:

deactivate

Conda

Install Conda if you have not already.

Create and activate:

conda create -n autogen python=3.10
conda activate autogen

To deactivate later, run:

conda deactivate

Poetry

Install Poetry if you have not already.

Create and activate:

poetry init
poetry shell

poetry add autogen

To deactivate later, run:

exit

Install AG2

AG2 requires Python version >= 3.9, < 3.14. It can be installed from pip:

pip install ag2[openai]

If you have been using autogen or ag2, all you need to do is upgrade it using:

pip install -U autogen[openai]

or

pip install -U ag2[openai]

as autogen and ag2 are aliases for the same PyPI package.

openai>=1 is required.

Install Docker for Code Execution

We recommend using Docker for code execution. To install Docker, follow the instructions for your operating system on the Docker website.

A simple example of how to use Docker for code execution is shown below:

from pathlib import Path
from autogen import UserProxyAgent
from autogen.coding import DockerCommandLineCodeExecutor

work_dir = Path("coding")
work_dir.mkdir(exist_ok=True)

with DockerCommandLineCodeExecutor(work_dir=work_dir) as code_executor:
    user_proxy = UserProxyAgent(
        name="user_proxy",
        code_execution_config={"executor": code_executor},
    )

To learn more about code executors, see the code executors tutorial.

You might have seen a different way of defining the executors without creating the executor object, please refer to FAQ for this legacy code executor.