# 安装指南

## 创建虚拟环境（可选）

在本地安装AgentChat时，我们推荐使用虚拟环境进行安装。这将确保AgentChat的依赖项与系统其他部分隔离。

``````{tab-set}

`````{tab-item} venv

创建并激活：

Linux/Mac系统：
```bash
python3 -m venv .venv
source .venv/bin/activate
```

Windows命令行：
```batch
python3 -m venv .venv
.venv\Scripts\activate.bat
```

后续如需退出环境，运行：

```bash
deactivate
```

`````

`````{tab-item} conda

如果尚未安装，请先[安装Conda](https://docs.conda.io/projects/conda/en/stable/user-guide/install/index.html)

创建并激活：

```bash
conda create -n autogen python=3.12
conda activate autogen
```

后续如需退出环境，运行：

```bash
conda deactivate
```

`````

``````

## 使用pip安装

通过pip安装`autogen-core`包：

```bash
pip install "autogen-core"
```

```{note}
需要Python 3.10或更高版本。
```

## 安装OpenAI模型客户端

要使用OpenAI和Azure OpenAI模型，需要安装以下扩展：

```bash
pip install "autogen-ext[openai]"
```

如果使用Azure OpenAI并需要AAD认证，需安装：

```bash
pip install "autogen-ext[azure]"
```

## 安装Docker用于代码执行（可选）

我们推荐使用Docker来运行{py:class}`~autogen_ext.code_executors.docker.DockerCommandLineCodeExecutor`执行模型生成的代码。请根据操作系统参考[Docker官网](https://docs.docker.com/get-docker/)安装Docker。

更多关于代码执行的内容，请参阅[命令行代码执行器](./components/command-line-code-executors.ipynb)和[代码执行](./design-patterns/code-execution-groupchat.ipynb)。