本文详细介绍了如何将Coze Studio开源项目快速部署到本地环境。首先，需要从GitHub克隆项目代码，并在本地新建文件夹。接着，配置大模型，通过复制模板文件并修改关键参数，包括模型ID、火山方舟的API Key以及模型接入点的Endpoint ID。完成配置后，使用Docker进行部署，包括启动服务、下载镜像等步骤。成功部署后，用户可以通过本地地址访问Coze Studio，并通过邮箱和密码进行登录使用，享受本地化开发带来的便利。文章还提供了解决常见报错的建议。

🚀 **项目获取与本地环境准备**：用户首先需要通过`git clone`命令从GitHub获取Coze Studio的开源项目代码，并在本地创建一个新的文件夹来存放项目文件，为后续的部署操作打下基础。

🛠️ **大模型配置是关键**：在正式启动服务前，必须完成大模型的配置。这包括将`model_template_ark_doubao-seed-1.6.yaml`文件复制为`ark_doubao-seed-1.6.yaml`，并重点修改该文件中的三个核心参数：全局唯一的`id`、火山方舟的`api_key`以及模型接入点的`Endpoint ID`，确保模型能够正常工作。

🐳 **Docker化部署流程**：完成模型配置后，通过Docker Compose命令来启动服务。用户需要进入`docker`目录，复制`.env.example`为`.env`，然后执行`docker compose --profile '*' up -d`指令。此过程会自动下载所需的镜像并启动服务，最终用户可通过`http://localhost:8888/`访问并使用Coze Studio。

💡 **常见问题与解决方案**：文章还提及了在部署过程中可能遇到的“localhost拒绝了您的请求”等报错，并提供了一个简便的解决方案：将`coze-studio`文件夹拖拽到CodeBuddy中，让其辅助启动，以解决潜在的配置或环境问题。

哈喽，大家好，

我是阿星👋

扣子开源了，怎么快速部署到本地呢，一起来跟着操作

1、下载项目文件

首先，本地新建文件夹，从github克隆代码。

GitHub地址: 

github.com/coze-dev/co…

# 首先cd到你的目录

# 克隆代码 

git clone https://github.com/coze-dev/coze-studio.git

2、换个路径

但是正式启动之前，要先把大模型配置好。否则你启动了模型没法工作呀。

a、从模板目录复制1.6 模型的模版文件，并粘贴到配置文件目录

# 复制1.6 模型配置模版

cd coze-studio

# 然后

cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml

b、注意，打开你复制后的ark_doubao-seed-1.6.yaml，注意！接下来用的是这个复制后的文件，不是模板里的文件。

3、更改文件配置

打开ark_doubao-seed-1.6.yaml后，你会看到密密麻麻的代码

小白不要头晕

只 3个参数需要改：

🔴 id：比如123，必须是非 0 的整数，且全局唯一即可

🔴 meta.conn_config.api_key：

就是火山方舟的key，去这个地方获取一个：

API Key (www.volcengine.com/docs/82379/…)

点击创建即可

🔴 meta.conn_config.model ：

火山方舟 doubao-seed-1.6 模型接入点的 Endpoint ID

这里获取推理接入点：console.volcengine.com/ark/region:…

然后点击红框里的这个字符，才是你的Endpoint ID

修改完成后大致如下

4、docker部署

# 启动服务，换成你自己的路径，比如我的是👉cd /Users/xingyang/Downloads/code/coze/coze-studio/docker#然后分别键入👉 cd docker👉cp .env.example .env👉docker compose --profile '*' up -d

然后你就会看到他正在下载

打开 http://localhost:8888/

输入邮箱和密码，就可以开始使用啦。

如果还有其他报错比如localhost拒绝了您的请求，直接吧coze-studio文件夹拖到codebuddy里面就可以了。让它给你启动。