优秀的编程知识分享平台

网站首页 > 技术文章 正文

Coze开源本地部署教程_开源canopen

nanyue 2025-10-02 04:52:32 技术文章 2 ℃

2核CPU+4GB内存即可运行,10分钟无痛部署AI智能体开发平台

字节跳动于2025年7月26日开源其AI智能体开发平台Coze(中文名“扣子”),包含Coze Studio可视化开发工具Coze Loop运维管理系统两大核心组件。短短48小时内GitHub星标数突破9000+,最大亮点在于其极致亲民的硬件要求——普通家用电脑即可流畅运行。本文将提供一步一图的完整本地部署指南,即使你是零基础小白也能轻松搞定。

一、环境准备:安装Docker

Docker是唯一前置依赖,用于创建隔离运行环境:

  1. 下载安装包
    Docker官网下载地址:(https://www.docker.com/products/docker-desktop)
    国内用户若下载慢,可使用飞书镜像包:(https://ay6exk7fyt.feishu.cn/drive/folder/IccNf2B4JlJOIvd2kWfcpYnRn4l)
  2. 安装设置
  3. Windows系统:安装时勾选启用Hyper-V(安装过程中若提示重启需同意)
  4. Mac系统:直接拖拽安装,无需特殊设置
  5. 安装完成后打开Docker Desktop,确认状态栏显示 “Running”

二、获取Coze源码

  1. 打开Docker Desktop内置终端(右下角Terminal图标)
  2. 逐行执行以下命令:
# 克隆官方仓库代码
git clone https://github.com/coze-dev/coze-studio.git
# 进入docker配置目录
cd coze-studio/docker
# 复制环境配置文件
cp .env.example .env

无Git用户替代方案
在GitHub直接下载ZIP包(https://github.com/coze-dev/coze-studio/archive/refs/heads/main.zip),解压后进入
coze-studio/docker目录手动创建.env文件。

三、关键步骤:配置模型服务

未配置模型将无法创建智能体! 以配置DeepSeek模型为例:

# 进入模型配置目录(Windows用start替换open)
open ../backend/conf/model/  
# 复制DeepSeek模板文件
cp ../backend/conf/model/template/model_template_ark_volc_deepseek-r1.yaml backend/conf/model/deepseek-r1.yaml
  1. 用文本编辑器打开deepseek-r1.yaml
  2. 修改以下参数:
base_url: "https://api.deepseek.com/v1"
api_key: "sk-xxxxxxxx"  # 在[DeepSeek平台](https://platform.deepseek.com/)申请
model: "deepseek-reasoner"

支持多模型切换:OpenAI、Claude、Qwen、Gemini、豆包等配置方法类似

四、一键启动服务

coze-studio/docker目录执行:

docker compose --profile '*' up -d
  • 首次运行需下载镜像(约5-10分钟,取决于网络)
  • 出现Container coze-server Started提示即启动成功
  • 访问控制台: http://localhost:8888

五、避坑指南:高频错误解决方案

错误类型

现象

解决方案

端口冲突

提示Ports are not available

执行 netstat -ano | findstr :3306 查PID后结束进程,或修改docker-compose.yml端口

MySQL启动失败

报错MYSQL_USER cannot be "root"

删除系统环境变量中的MYSQL_USER和MYSQL_PASSWORD

Elasticsearch报错127

启动时异常退出

用VSCode打开docker/volumes/elasticsearch/setup_es.sh,右下角切换CRLF为LF格式

六、进阶技巧:切换模型实战(以Qwen为例)



为什么选择开源Coze?

  • 零成本商用:采用Apache 2.0协议,允许免费商业使用无隐藏条款
  • 全链路开源:覆盖Agent开发(Studio)、测试/运维(Loop)、部署(SDK)
  • 硬件平民化:告别动辄16G显存的GPU,普通笔记本即可运行AI工作流

部署完成后访问 http://localhost:8888 ,输入任意邮箱密码即可注册登录,你的第一个AI Agent已就绪!

此刻,你已站在AI智能体开发的最前沿。从拉取代码到界面打开,操作时间不足10分钟——这种“无痛感”正是Coze开源的革命性意义:让每个有想法的普通人,都能成为AI创造者。

推荐学习



行业首个「知识图谱+测试开发」深度整合课程【人工智能测试开发训练营】,赠送智能体工具。提供企业级解决方案人工智能的管理平台部署,实现智能化测试,落地大模型,实现从传统手工转向用AI和自动化来实现测试,提升效率和质量。

最近发表
标签列表