跳至主要內容

Coze Studio 扣子开源项目本地部署

技术实践AI部署约 691 字大约 2 分钟

Coze Studio 扣子开源项目本地部署

Coze Studio 扣子开源项目是一个基于 AI 的协同创作平台，旨在帮助用户更高效地进行内容创作和管理。Coze官方与2025.7.26日发布了Coze Studio的开源版本，支持本地部署。本文将实践如何在本地部署 Coze Studio 扣子开源项目。

1. 环境准备

  • 操作系统：macOS 15 Sequoia
  • Docker：Docker Desktop for macOS

部署步骤：

  1. 获取源码。

    # 克隆代码
git clone https://github.com/coze-dev/coze-studio.git

  2. 配置模型。

    1. 从模板目录复制模型的模版文件，并粘贴到配置文件目录。

      # 模版文件目录
backend/conf/model/template/xxx.yaml

      # 配置文件目录
backend/conf/model/xxx.yaml

    2. 在配置文件目录下，修改模版文件。

      1. 进入目录 backend/conf/model。打开复制后的文件xxx.yaml。
      2. 设置 id、meta.conn_config.api_key、meta.conn_config.model 字段，并保存文件。
        • id：Coze Studio 中的模型 ID，由开发者自行定义，必须是非 0 的整数，且全局唯一。模型上线后请勿修改模型 id 。
        • meta.conn_config.api_key：模型服务的 API Key。
        • meta.conn_config.model：模型服务的 model ID。

  3. 部署并启动服务。 首次部署并启动 Coze Studio 需要拉取镜像、构建本地镜像，可能耗时较久，请耐心等待。部署过程中，你会看到以下日志信息。如果看到提示 "Container coze-server Started"，表示 Coze Studio 服务已成功启动。

    # 启动服务
cd docker
cp .env.example .env
docker compose --profile '*' up -d

注意：若本地已有SQL服务运行，可能会导致端口占用

  1. 访问 Coze Studio。 打开浏览器，访问 http://localhost:8888，即可进入 Coze Studio 的 Web 界面。

项目中，部署使用了Google的Gemini免费API

Buterr