安装指南#

AutoGen Studio 提供两种安装方式：通过 PyPi 安装或从源码安装。我们推荐通过 PyPi 安装，除非您需要修改源代码。

创建虚拟环境（推荐）#

建议使用虚拟环境，这能确保 AutoGen Studio 的依赖项与系统其他部分隔离。

创建并激活环境：

Linux/Mac：

python3 -m venv .venv
source .venv/bin/activate

Windows 命令行：

python3 -m venv .venv
.venv\Scripts\activate.bat

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

deactivate

若未安装请先安装 Conda

创建并激活环境：

conda create -n autogen python=3.10
conda activate autogen

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

conda deactivate

通过 PyPi 安装（推荐）#

使用 Python 包管理器 pip 安装 AutoGen Studio：

pip install -U autogenstudio

从源码安装#

注：此方式需要具备 React 界面构建的相关知识

提供两种从源码安装的方式：手动安装或使用开发容器。

A) 手动从源码安装#

  1. 确保已安装 Python 3.10+ 和 Node.js（版本需高于 14.15.0）

  2. 克隆 AutoGen Studio 代码仓库

  3. 进入 python/packages/autogen-studio 目录，执行 pip install -e . 安装 Python 依赖

  4. 进入 python/packages/autogen-studio/frontend 目录，安装依赖并构建 UI：

npm install -g gatsby-cli
npm install --global yarn
cd frontend
yarn install
yarn build

Windows 用户可能需要使用替代命令构建前端：#

gatsby clean && rmdir /s /q ..\autogenstudio\web\ui 2>nul & (set "PREFIX_PATH_VALUE=" || ver>nul) && gatsby build --prefix-paths && xcopy /E /I /Y public ..\autogenstudio\web\ui


### B) 使用开发容器从源码安装

1. 按照 [Dev Containers 教程](https://code.visualstudio.com/docs/devcontainers/tutorial) 安装 VS Code、Docker 和相关扩展。
2. 克隆 AutoGen Studio 代码仓库。
3. 在 VS Code 中打开 `python/packages/autogen-studio/`。点击左下角的蓝色按钮或按 F1 选择 _"Dev Containers: 在容器中重新打开"_。
4. 构建用户界面：

```bash
cd frontend
yarn build

运行应用#

安装完成后，在终端输入以下命令启动Web界面：

autogenstudio ui --port 8081

该命令将在指定端口启动应用。打开浏览器访问 http://localhost:8081/ 即可使用AutoGen Studio。

AutoGen Studio支持以下参数用于自定义应用配置：

  • --host <host> 参数用于指定主机地址，默认为localhost

  • --appdir <appdir> 参数用于指定应用文件存储目录（如数据库和生成的用户文件），默认为用户主目录下的.autogenstudio文件夹

  • --port <port> 参数用于指定端口号，默认为8080

  • --reload 参数用于启用代码修改后自动重启服务器功能，默认为False

  • --database-uri 参数用于指定数据库连接URI。示例值包括SQLite的sqlite:///database.sqlite和PostgreSQL的postgresql+psycopg://user:password@localhost/dbname。若未指定，默认使用--appdir目录下的database.sqlite文件

  • --upgrade-database 参数用于将数据库架构升级至最新版本，默认为False

现在您已成功安装并运行AutoGen Studio，接下来可以探索其各项功能，包括定义和修改agent工作流、与agents和会话进行交互，以及扩展agent技能集。