ChainForge

环境要求

• Python 3.8 或更高版本
• 已安装 pip，可正常执行 pip 命令
• Google Chrome、Firefox、Microsoft Edge 或 Brave 浏览器之一
• （可选）如需 Docker 方式运行，需安装 Docker Desktop
• （可选）OpenAI、Anthropic、Google 等模型的 API Key 或 Amazon AWS 凭证

安装与启动步骤

1. 1检查 Python 版本

   在终端确认 Python 版本不低于 3.8，版本过低会导致安装或运行失败。

   python --version

   复制

2. 2安装 ChainForge

   用 pip 从 PyPI 安装 chainforge 包，安装完成后会提供 chainforge 命令行入口。

   pip install chainforge

   复制

3. 3启动本地服务

   执行 serve 命令启动本地服务，默认监听 8000 端口，保持终端窗口不要关闭。

   chainforge serve

   复制

4. 4浏览器打开界面

   用 Chrome、Firefox、Edge 或 Brave 打开 http://localhost:8000，即可看到可视化流程编辑界面。

5. 5配置模型 API Key

   点击界面右上角 Settings 图标填入 OpenAI、Anthropic、Google 等 API Key；希望免重复填写可写入本地环境变量。

6. 6Docker 方式运行（可选）

   若已装 Docker Desktop，可改为构建镜像并运行容器，同样暴露 8000 端口。

   docker build -t chainforge .
   docker run -p 8000:8000 chainforge

   复制

关键配置

如何确认成功

浏览器访问 http://localhost:8000（Docker 方式为 http://127.0.0.1:8000）能正常加载 ChainForge 可视化界面即启动成功。

常见问题

注意事项

• 网页版功能集有限，需要完整能力（环境变量密钥、Python 评估、Ollama）请本地安装。
• Python 版本必须为 3.8 或更高。
• chainforge serve 默认使用 8000 端口，Docker 运行时需要做 8000:8000 端口映射。
• Docker 步骤要求在 ChainForge 仓库根目录（存在 Dockerfile 的位置）执行 docker build。