【收藏必备】(持续更新)

本文详细介绍了字节跳动AI开发平台Coze的开源本地部署教程,包括系统要求、四步安装流程及常见问题解决方案。Coze采用Apache 2.0许可证,仅需2核CPU、4GB内存即可运行,虽功能略逊于公网版,但核心功能完备,适合开发者快速搭建AI智能体。


小白也能轻松部署Coze 开发平台开源本地部署详细教程(FAQ常见问题合集篇)

嗨~我是码蜂AI智能体。手把手拆解Coze工作流 AI智能体从0到1搭建 | 保姆级教程,持续分享coze商业工作流搭建案例、Coze智能体工作流定制,致力于让AI成为每个人的提效神器。

字节跳动旗下 AI Agent 开发平台 ——Coze(扣子)正式宣布开源,此次开源包含两大核心项目,全面覆盖 AI 智能体的开发、运维、测试与调优全流程:

  • CozeStudio(扣子开发平台)
  • CozeLoop(罗盘运维平台)

该项目采用 Apache 2.0 许可证,相关代码权益如下:

  • 可商用自由:支持商业场景使用,无需附加特殊条款限制;
  • 专利保障明确:包含清晰的专利授权条款,使用时无需担忧知识产权风险;
  • 社区协作开放:鼓励全球开发者共同参与迭代,共建生态未来。

该平台以低门槛著称,仅需 2 核 CPU、4GB 内存即可运行,并配套一键部署脚本,Docker 环境即可快速启用

和公网Coze 开发平台相比,本地版有这些差异:

  1. 功能上少了对话流、对话智能体、多 Agent 体系,也没有AI 应用模块;

  2. 缺少自定义空间功能;

  3. 发布渠道仅支持 WEB SDK 和 API—— 不过这一取舍其实颇为合理;

  4. 授权体系目前只支持个人令牌,且有效期仅能设 30 天。

好在核心功能基本都已覆盖,诚意虽有但不算太足。但对有开发能力的用户来说,它反倒比 Dify、N8N、FastGPT 等工具更值得一试。

更何况这才只是起点,后续的迭代升级值得期待。

整个安装流程共分四步,操作起来很简单,跟着一步步来就行:

  1. 安装 Docker Docker 可以理解为一个 “容器软件”,里面预装了 Coze 运行所需的各种组件,是安装 Coze 的必备前提,必须先完成安装。
  2. 获取 Coze 安装包 可从 GitHub 下载源码或压缩包(码蜂 AI 已整理好安装包,不会下载的同学可私信领取)。
  3. 执行安装命令 进入 Coze 安装包所在的文件夹,运行对应的安装命令即可启动安装。
  4. 初始化并登录 完成安装后初始化 Coze 后台,设置用户名和密码,之后就能登录使用了~

本篇主要介绍本地部署coze时遇到的常见问题。

Coze 本地部署常见问题与解决办法:

一、启动coze时执行docker compose --profile* up -d时,出现no service selected

把 docker-compose.yml 里面所有 profile 都删掉

或者替换一下最新的docker-compose.yml文件。

二、Error response from daemon: Ports are not available: exposing portTCP0.0.0.0:3306 -> 0.0.0.0:0: listen tcp 0.0.0.0:3306: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.

这个问题是因为我本地MySQL服务启动着,占用了3306的端口。而coze studio开源默认MySQL对外端口是3306,所以冲突了导致。 修改(coze-studio/docker/docker-compose.yml):

将MySQL对外暴露端口改为一个不存在的端口(比如3366)即可。其他类似端口冲突问题,按照同样方式解决。


三、[MY-012960] [InnoDB] Cannot create redologfiles because data files are corrupt or the database was not shut down cleanly after creating the data files.

这个错误来自 MySQL 的 InnoDB 存储引擎,说明 MySQL 启动失败。删除已有的数据文件,重新初始化(适用于开发环境或可清除数据场景)

改进步骤:

1、清空coze-studio/docker/data目录内的文件

2、清空coze-studio/docker/volumes目录内的内容。如果你是Windows,可以直接这样删除:


四、Container coze-elasticsearch-setup service “elasticsearch-setup” didn… service “elasticsearch-setup” didn’t complete successfully: exit 127

进入该容器发现找不到setup_es.sh 这个文件,实际这个文件存在的。

使用代码编辑器(如 VS Code或Notepad++)

打开 elasticsearch-setup 服务所依赖的启动脚本(coze-studio/docker/volumes/elasticsearch/setup_es.sh)。

在编辑器的右下角,你会看到 CRLF 或 LF 的标识,点击它并选择 LF。保存文件后再重新启动就解决了。


五、 如果提示"command not found",请检查:

  • 安装时是否勾选了"添加到PATH"
  • 可能需要重启电脑使PATH生效
  • 不同系统对应不同的命令格式


六、Windows系统执行命令时报错:不是内部或外部命令,也不是可运行的程序。

这种情况是因为不同系统的命令格式不一样,可以搜索一下对应系统的命令。

比如:cp .env.example .env

则执行:copy .env.example .env


七、windows本地部署,“Error response from daemon: Ports are not available: exposing portTCP0.0.0.0:2379 -> 127.0.0.1:0:2379” 如何解决?

查看占用

netstat -ano | findstr :2379

net stop winnat

net start winnat


八、Agent 对话调试 “Something error:Internal server error” 错误?

可以通过以下命令查询具体错误日志

Linux命令:docker logs coze-server | grep -i ‘node execute failed’

widows命令:docker logs coze-server | findstr /i “node execute failed”


关于Coze的使用,以及工作流的搭建,我也会在之后的教程中为大家讲解, 大家可以关注我们,持续发布新的教程,欢迎进入coze交流学习群共同学习,下期见~

d=2247484344&idx=1&sn=fdc67e555b344e66aa8dd05d1d889b44&scene=21#wechat_redirect)

关于Coze的使用,以及工作流的搭建,我也会在之后的教程中为大家讲解, 大家可以关注我们,持续发布新的教程,欢迎进入coze交流学习群共同学习,下期见~

九、AI大模型学习和面试资源

我在一线互联网企业工作十余年里,指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家,也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑,所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限,很多互联网行业朋友无法获得正确的资料得到学习提升,故此将并将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

这份完整版的大模型 AI 学习和面试资料已经上传CSDN,朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

在这里插入图片描述

第一阶段: 从大模型系统设计入手,讲解大模型的主要方法;

第二阶段: 在通过大模型提示词工程从Prompts角度入手更好发挥模型的作用;

第三阶段: 大模型平台应用开发借助阿里云PAI平台构建电商领域虚拟试衣系统;

第四阶段: 大模型知识库应用开发以LangChain框架为例,构建物流行业咨询智能问答系统;

第五阶段: 大模型微调开发借助以大健康、新零售、新媒体领域构建适合当前领域大模型;

第六阶段: 以SD多模态大模型为主,搭建了文生图小程序案例;

第七阶段: 以大模型平台应用与开发为主,通过星火大模型,文心大模型等成熟大模型构建大模型行业应用。

在这里插入图片描述

👉学会后的收获:👈

• 基于大模型全栈工程实现(前端、后端、产品经理、设计、数据分析等),通过这门课可获得不同能力;

• 能够利用大模型解决相关实际项目需求: 大数据时代,越来越多的企业和机构需要处理海量数据,利用大模型技术可以更好地处理这些数据,提高数据分析和决策的准确性。因此,掌握大模型应用开发技能,可以让程序员更好地应对实际项目需求;

• 基于大模型和企业数据AI应用开发,实现大模型理论、掌握GPU算力、硬件、LangChain开发框架和项目实战技能, 学会Fine-tuning垂直训练大模型(数据准备、数据蒸馏、大模型部署)一站式掌握;

• 能够完成时下热门大模型垂直领域模型训练能力,提高程序员的编码能力: 大模型应用开发需要掌握机器学习算法、深度学习框架等技术,这些技术的掌握可以提高程序员的编码能力和分析能力,让程序员更加熟练地编写高质量的代码。

在这里插入图片描述

1.AI大模型学习路线图
2.100套AI大模型商业化落地方案
3.100集大模型视频教程
4.200本大模型PDF书籍
5.LLM面试题合集
6.AI产品经理资源合集

👉获取方式:
😝有需要的小伙伴,可以保存图片到wx扫描二v码免费领取【保证100%免费】🆓

在这里插入图片描述

Logo

聚焦RDK与具身智能,汇集机器人开发教程、开源案例和技术交流

更多推荐