网站导航
> 技术文档 > 字节Coze开源版安装教程_coze安装

字节Coze开源版安装教程_coze安装

网友: 技术文档 2025-08-15 15:21:50

字节跳动于2025年7月26日正式开源其AI智能体开发平台“扣子”（Coze），包含Coze Studio可视化开发工具和Coze Loop运维管理系统两大核心组件。短短48小时内，GitHub星标数突破9000+ ，掀起开发圈热潮。最令人惊喜的是——它仅需2核CPU+4GB内存即可本地运行，真正将AI开发门槛拉低到“家用电脑级”。

下面手把手教你从零部署，避开新手常见坑点！

一、准备环境：安装Docker

这是唯一的前置依赖，作用是为Coze创建隔离的运行环境：

  1. 访问 Docker官网 下载安装包

  2. 双击安装，全部选择默认设置（Windows需启用Hyper-V，安装过程若提示重启请同意）

  3. 安装完成后打开Docker Desktop，确认状态栏显示“Running”

💡 替代方案：若官网下载慢，可使用国内镜像包（飞书下载链接）

二、获取Coze源码

打开Docker Desktop内置终端（右下角Terminal图标），执行：

git clone https://github.com/coze-dev/coze-studio.git  # 克隆代码cd coze-studio/docker                                 # 进入docker配置目录cp .env.example .env                                 # 复制环境配置文件

无Git用户：可直接在GitHub下载ZIP包解压

三、配置模型服务（关键步骤！）

不配置模型则无法创建智能体，此处以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

编辑deepseek-r1.yaml，修改以下参数：

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分钟）。成功后访问： 👉 http://localhost:8888

五、避坑指南：高频错误解决

  1. 端口冲突错误：
    若提示Ports are not available：

    • 关闭占用端口（如3306/6379）：netstat -ano | findstr :3306 查PID后结束进程

    • 或修改docker-compose.yml中端口号

  2. MySQL启动失败：
    报错MYSQL_USER cannot be \"root\"：
    → 删除系统环境变量中的MYSQL_USER和MYSQL_PASSWORD

  3. Elasticsearch启动失败：
    报错exit 127：
    → 用VSCode打开docker/volumes/elasticsearch/setup_es.sh，右下角切换CRLF为LF后保存

六、更换模型实战（如切换至Qwen）

  1. 复制模板：将model_template_basic复制到../backend/conf/model/，重命名为qwen.yaml

  2. 修改配置：

id: 2  # 保持唯一name: \"qwen3-235b\"meta.conn_config:  base_url: \"https://dashscope.aliyuncs.com/compatible-mode/v1\"  api_key: \"阿里百炼申请的KEY\"  model: \"qwen3-235b-a22b-instruct-2507\"

  1. 重启服务生效：docker compose --profile \'*\' restart coze-server

为什么Coze开源值得关注？

  • 零成本商用：Apache 2.0协议允许免费商业使用，无隐藏条款

  • 全链路开源：覆盖Agent开发(Studio)、测试/运维(Loop)、部署(SDK)

  • 硬件亲民：告别动辄16G显存的GPU，普通笔记本也能跑AI工作流

试部署后你会发现：从拉代码到界面打开，真正操作时间不到10分钟。这种“无痛感”正是开源Coze的核心突破——让每个有想法的普通人，都能低成本成为AI智能体开发者。

此刻登录http://localhost:8888，你的第一个AI Agent已在等待诞生。

人工智能（Coze）技术学习交流群

推荐阅读

DeepSeek实践指导手册、人工智能在软件测试中的应用、我们是如何测试人工智能的?

Deepseek52条喂饭指令

在本地部署属于自己的 DeepSeek 模型，搭建AI 应用平台

DeepSeek 大模型与智能体公开课，带你从零开始，掌握 AI 的核心技术，开启智能未来！

深度解析：如何通过DeepSeek优化软件测试开发工作，提升效率与准确度

DeepSeek、文心一言、Kimi、豆包、可灵……谁才是你的最佳AI助手？

从零到一：如何构建一个智能化测试平台？

DeepSeek-R1+ Ollama 本地部署全攻略

DeepSeek与Playwright结合：利用AI提升自动化测试脚本生成与覆盖率优化

DeepSeek大模型6大部署模式解析与探索测试开发技术赋能点

爱测智能化服务平台

测开人必看！0代码+AI驱动，测试效率飙升300% ——霍格沃兹测试开发学社‌重磅上新‌「爱测智能化服务平台」限时开放体验！

一码难求的Manus：智能体技术如何重构生产力？测试领域又有哪些新机遇？

开源工具

AppCrawler 开源版
https://github.com/seveniruby/AppCrawler

Hogwarts-Browser-Use 开源版
指导安装贴：hogwarts-browser-use - 开源项目 - 爱测-测试人社区

专业版 （7天免费试用）

自动遍历测试框架 AppCrawler 专业版
通用数据驱动测试框架 hogwarts-ddt 专业版
测试智能体框架 hogwarts-agent 专业版

学社提供的资源

教育官网：霍格沃兹测试开发学社
科技官网：测吧（北京）科技有限公司
火焰杯就业选拔赛：火焰杯就业选拔赛 - 霍格沃兹测试开发学社
火焰杯职业竞赛：火焰杯职业竞赛 - 霍格沃兹测试开发学社
学习路线图：霍格沃兹测试开发学社
公益社区论坛：爱测-测试人社区 - 软件测试开发爱好者的交流社区，交流范围涵盖软件测试、自动化测试、UI测试、接口测试、性能测试、安全测试、测试开发、测试平台、开源测试、测试教程、测试面试题、appium、selenium、jmeter、jenkins
公众号：霍格沃兹测试学院
视频号：霍格沃兹软件测试
ChatGPT体验地址：霍格沃兹测试开发学社

本套视频教程所有配套资料领取方式如下:

方式1:访问官网可下载:testingstudio.com
方式2:关注ceshiren.com社区
人工智能/AI/为什么测试工程师需要掌握AI_哔哩哔哩_bilibili
​adb命令：【霍格沃兹测试开发】adb命令零基础快速入门–深入理解掌握app自动化测试底层技术_哔哩哔哩_bilibili
Python语法：1.闭包和装饰器_哔哩哔哩_bilibili?
人工智能：人工智能在音频、视觉、多模态领域的应用_哔哩哔哩_bilibili
软件测试入门：【霍格沃兹测试开发】7小时速成！软件测试新手入门指南，轻松掌握测试技能！_哔哩哔哩_bilibili
测试开发：【霍格沃兹测试开发】面试BAT软件测试开发，你需要具备哪些技能？_哔哩哔哩_bilibili
面试题指导：【霍格沃兹测试开发】软件测试工程师如何拿到P5-P7高薪offer？_哔哩哔哩_bilibili
JMeter:JMeter从入门到精通全集 包含http/dubbo/Kafka压测、Grafana监控_哔哩哔哩_bilibili
Java测试框架：【软件测试】Java测试框架Junit5与Allure测试报告免费课_哔哩哔哩_bilibili
简历面试教程：软件测试工程师简历面试教程攻略–如何写出能进BAT大厂测开岗的优质简历？如何在面试中向HR要到更高薪资？如何拿到更高级别的offer？–持续更新！_哔哩哔哩_bilibili
Java：【软件测试教程】Java自动化测试平台开发入门篇之初识springboot_哔哩哔哩_bilibili?
java语言rest-assured：【霍格沃兹测试开发】java语言rest-assured框架进行接口测试实战_哔哩哔哩_bilibili
Java接口自动化：【软件测试】Java接口自动化测试之RestAssured_哔哩哔哩_bilibili
性能测试：【软件测试教程】高级性能测试-JMeter+InfluxDB+Grafana压测数据展示_哔哩哔哩_bilibili
Linux：Linux 中如何实时查看日志记录-【软件测试面试题】_哔哩哔哩_bilibili
接口测试：【软件测试教程】接口测试入门实战-基于企业微信api进行接口测试_哔哩哔哩_bilibili
APP自动化：【霍格沃兹测试开发】APP移动端自动化测试从入门到精通/Appium环境安装/元素定位与隐式等待（最全攻略）_哔哩哔哩_bilibili
MySQL：【软件测试教程】MySQL数据库基本增删改查与多表查询_哔哩哔哩_bilibili
postman：【软件测试】postman基础-发送post请求_哔哩哔哩_bilibili
性能实战：【软件测试教程】性能测试压测实战-JMeter+InfluxDB+Grafana压测数据展示_哔哩哔哩_bilibili
零基础入门：零基础快速入门软件测试的秘籍_哔哩哔哩_bilibili
Java-JUnit5:软件测试之Java测试框架JUnit5 L1_哔哩哔哩_bilibili
接口测试：【软件测试】App抓包实战练习-接口测试初级入门_哔哩哔哩_bilibili
接口mitmproxy工具：【软件测试教程】测开必备工具mitmproxy_哔哩哔哩_bilibili
pytest：1.pytest简介与安装-【软件测试实战教程】_哔哩哔哩_bilibili
app功能测试：14.app压力测试-【软件测试实战教程】_哔哩哔哩_bilibili
前端开发-vue:Vue生命周期_哔哩哔哩_bilibili
flask:Flask环境安装与配置_哔哩哔哩_bilibili
Appium：appium的基本介绍_哔哩哔哩_bilibili
精品课试听：1.接口测试价值与体系_哔哩哔哩_bilibili

Docker

Docker cp命令详解：在Docker容器和主机之间复制文件/文件夹

Docker pull 命令详解：从镜像仓库获取镜像

深入理解 Docker Run 命令：从入门到精通

Docker Exec 命令详解与实践指南

Docker Kill/Pause/Unpause命令详细使用指南

Docker Logs命令详解

Selenium

多任务一次搞定！selenium自动化复用浏览器技巧大揭秘

如何使用Selenium处理隐藏元素

软件测试/测试开发/全日制|selenium NoSuchDriverException问题解决

软件测试/人工智能|解决Selenium中的异常问题：“error sending request for url”

Python

使用Python爬取豆瓣电影影评：从数据收集到情感分析

如何使用 Python 实现十进制转二进制的程序

Python教程：如何获取颜色的RGB值

Python处理日期的利器—日期转换指南

Python字符串的编码与解码

 

网络标签：

相关问题