coze-studio README

The project's README from github.com/coze-dev/coze-studio. As one markdown file: README.md.

Image

Coze Studio • Feature list • Quickstart • Developer Guide

License Go Version

English | 中文

What is Coze Studio?

Coze Studio is an all-in-one AI agent development tool. Providing the latest large models and tools, various development modes and frameworks, Coze Studio offers the most convenient AI agent development environment, from development to deployment.

Coze Studio, derived from the "Coze Development Platform" which has served tens of thousands of enterprises and millions of developers, we have made its core engine completely open. It is a one-stop visual development tool for AI Agents that makes creating, debugging, and deploying AI Agents unprecedentedly simple. Through Coze Studio's visual design and build tools, developers can quickly create and debug agents, apps, and workflows using no-code or low-code approaches, enabling powerful AI app development and more customized business logic. It's an ideal choice for building low-code AI products tailored . Coze Studio aims to lower the threshold for AI agent development and application, encouraging community co-construction and sharing for deeper exploration and practice in the AI field.

The backend of Coze Studio is developed using Golang, the frontend uses React + TypeScript, and the overall architecture is based on microservices and built following domain-driven design (DDD) principles. Provide developers with a high-performance, highly scalable, and easy-to-customize underlying framework to help them address complex business needs.

Feature list

Module Feature
Model service Manage the model list, integrate services such as OpenAI and Volcengine
Build agent * Build, publish, and manage agent
* Support configuring workflows, knowledge bases, and other resources
Build apps * Create and publish apps
* Build business logic through workflows
Build a workflow Create, modify, publish, and delete workflows
Develop resources Support creating and managing the following resources:
* Plugins
* Knowledge bases
* Databases
* Prompts
API and SDK * Create conversations, initiate chats, and other OpenAPI
* Integrate agents or apps into your own app through Chat SDK

Quickstart

Learn how to obtain and deploy the open-source version of Coze Studio, quickly build projects, and experience Coze Studio's open-source version.

Environment requirements:

Deployment steps:

  1. Retrieve the source code.

    # Clone code
    git clone https://github.com/coze-dev/coze-studio.git
    
  2. Deploy and start the service. When deploying and starting Coze Studio for the first time, it may take a while to retrieve images and build local images. Please be patient. If you see the message "Container coze-server Started," it means the Coze Studio service has started successfully.

    cd coze-studio
    # start service
    # for macOS or Linux
    make web  
    # for windows
    cp ./docker/.env.example ./docker/.env
    docker compose -f ./docker/docker-compose.yml up
    

    For common startup failure issues, please refer to the FAQ.

  3. Register an account by visiting http://localhost:8888/sign, entering your username and password, and clicking the Register button.

  4. Configure the model at http://localhost:8888/admin/#model-management by adding a new model. (The image version must be greater than or equal to 0.5.0.)

  5. Visit Coze Studio at http://localhost:8888/.

[!WARNING] If you want to deploy Coze Studio in a public network environment, it is recommended to assess security risks before you begin, and take corresponding protection measures. Possible security risks include account registration functions, Python execution environments in workflow code nodes, Coze Server listening address configurations, SSRF (Server - Side Request Forgery), and some horizontal privilege escalations in APIs. For more details, refer to Quickstart.

Developer Guide

Using the open-source version of Coze Studio

Regarding how to use Coze Studio, refer to the Coze Development Platform Official Documentation Center for more information. Please note that certain features, such as tone customization, are limited to the commercial version. Differences between the open-source and commercial versions can be found in the Feature List.

License

This project uses the Apache 2.0 license. For details, please refer to the LICENSE file.

Community contributions

We welcome community contributions. For contribution guidelines, please refer to CONTRIBUTING and Code of conduct. We look forward to your contributions!

Security and privacy

If you discover potential security issues in the project, or believe you may have found a security issue, please notify the ByteDance security team through our security center or vulnerability reporting email. Please do not create public GitHub Issues.

Join Community

We are committed to building an open and friendly developer community. All developers interested in AI Agent development are welcome to join us!

🐛 Issue Reports & Feature Requests

To efficiently track and resolve issues while ensuring transparency and collaboration, we recommend participating through:

💬 Technical Discussion & Communication

Join our technical discussion groups to share experiences with other developers and stay updated with the latest project developments:

Feishu Group Chat
Scan the QR code below with Feishu mobile app to join:

Image

Discord Server
Click to join: Coze Community

Telegram Group
Click to join: Telegram Group Coze

Acknowledgments

Thank you to all the developers and community members who have contributed to the Coze Studio project. Special thanks:

coze-studio (coze-dev/coze-studio)

Searching Database…

这是什么?一个开源的一站式 AI 智能体开发平台:通过可视化工具创建、调试和部署 AI 智能体、应用和工作流,无需写代码或只需写少量代码。
这是需要注册使用的云服务,还是我自己搭建运行的东西?自己搭建运行:这是一个用 Docker Compose 部署的自托管网页平台——也就是字节跳动 Coze 开发平台的核心引擎的完全开源版本。
我怎么把它跑起来?先安装 Docker 和 Docker Compose(至少需要 2 个 CPU 内核和 4 GB 内存),克隆仓库,然后用 Docker Compose 启动服务。首次启动会构建镜像;看到 'Container coze-server Started' 后,打开网页界面并注册一个账号。
在开始搭建智能体之前,我还需要配置什么?需要一个模型服务:部署完成后必须先添加一个模型(支持 OpenAI、火山引擎等),否则在智能体、工作流或应用里就无法选择模型。另外,官方插件也需要其对应第三方服务的授权密钥。
把它直接暴露到公网上安全吗?要小心:README 建议先评估安全风险,并点名了几个可能的风险,包括开放账号注册、工作流代码节点里的 Python 执行、SSRF,以及 API 中的一些水平越权问题。
不用写代码也能用它做东西吗?可以:智能体、应用和工作流都是用无代码或低代码的可视化方式搭建的。技术活主要在安装部署——需要有人先用 Docker 把它部署好,并配置好模型服务。
我到底能用它做出什么东西?三样东西:智能体、应用和工作流。它提供可视化画布,通过拖拽节点来搭建工作流,还有共享资源——插件、知识库、数据库和提示词。
我做的智能体能嵌到我自己的产品里吗?可以——Coze Studio 提供对话和工作流的 OpenAPI 以及一个 Chat SDK,用个人访问令牌(Personal Access Token)做鉴权,这样就能把智能体接入你自己的应用(README 里给了一个网页客服的例子)。
它和商业版 Coze 平台比怎么样?核心引擎是完全开放的,但有些功能只有商业版才有——比如音色定制就是文档里举的例子。具体差异可以看文档里的功能清单。
它底层用了什么技术?后端用 Golang,前端用 React + TypeScript,按照领域驱动设计组织成微服务架构。它基于 Eino 运行时、FlowGram 工作流画布引擎和 Hertz 这个 Go HTTP 框架构建。
What are similar projects?sim, JeecgBoot, nocobase, FastGPT, kestra, Flowise, dify, LoomFlow
Creator
coze-dev
Size
73.7 MB
Stars
21.7K
Age
1y
Commits · 90 Days