Coze Studio: как развернуть open-source платформу AI-агентов на своём сервере
Coze Studio — открытая версия платформы ByteDance для сборки агентов из визуальных блоков: агенты, воркфлоу, плагины, базы знаний, Chat SDK. Разбираем честно: что разворачивается за 15 минут, чем open-source отличается от облака и какие риски появляются, если выставить стенд в интернет.
ГайдSelf-hostApache-2.0Данные на 13.10.2026
Уровень СреднийМинимум 2 ядра / 4 ГБОбновлено 13.10.2026
Результат: рабочая платформа агентов на вашем сервере по адресу localhost:8888 — со сборкой агентов, визуальными воркфлоу, плагинами, базами знаний и API. Без подписки и без отправки данных наружу, но с честным списком оговорок: требования к железу, ручная настройка моделей и предупреждение авторов про безопасность при публичном доступе.
Что разворачиваем
Coze Studio — открытая (Apache-2.0) версия платформы Coze для сборки AI-агентов. Репозиторий coze-dev/coze-studio на 13.10.2026: 21 703 звезды, 3 129 форков, последний релиз v0.5.1 от 05.02.2026. Отдельным проектом живёт Coze Loop (5 768 ★, Apache-2.0) — платформа оценки и мониторинга агентов.
01Что внутри и кому это нужно
Coze Studio — визуальная среда: агент собирается из промпта, плагинов, базы знаний и воркфлоу, а не из кода. Бэкенд написан на Go, фронтенд — React и TypeScript, архитектура микросервисная по принципам DDD. Рантайм агентов и воркфлоу опирается на Eino, HTTP-слой — на Hertz, canvas воркфлоу — на FlowGram; всё это проекты, которые ByteDance развивает в открытом виде.
Из чего состоит репозиторий Coze Studio
Раскладка по языкам — из api.github.com/repos/coze-dev/coze-studio/languages, снято 13.10.2026 (округление до целых процентов).
Модуль
Что умеет
Нужен ли внешний сервис
Агенты
Сборка, публикация, управление; подключение воркфлоу и баз знаний
Нет
Воркфлоу
Визуальный canvas: узлы, ветвления, код на Python
Модель и плагины
Плагины
Магазин плагинов и свои инструменты с ключами доступа
Ключи третьих сервисов
Базы знаний
Загрузка документов и RAG-поиск по ним
Модель эмбеддингов
API и Chat SDK
Диалоги и воркфлоу через OpenAPI, встраивание чата в свой продукт
Personal Access Token
Состав — по README и официальному feature list проекта, снято 13.10.2026.
Что осталось в коммерческой версии
Авторы прямо пишут: часть функций доступна только в платной версии платформы — например тонкая настройка тона ответов. Перед внедрением сверьте таблицу различий в README: open-source и облачный Coze — не одно и то же по возможностям и поддержке.
02Требования: 2 ядра, 4 ГБ и Docker
Официальные минимальные требования скромные и подходят небольшому VPS. Но размер — не единственная метрика: платформа тянет несколько контейнеров, поэтому на 4 ГБ памяти стоит держать запас под модель и индексацию знаний, либо выносить модели на внешние API.
Параметр
Минимум
Комментарий
Процессор
2 ядра
Docker-контейнеры и воркфлоу делят ядра
Оперативная память
4 ГБ
С запасом под индексацию баз знаний
ПО
Docker + Docker Compose
Обязательно и то, и другое
Go (для сборки из исходников)
≥ 1.23.4
Указано бейджем в репозитории
Порты
8888 (веб), 8889 (внутренний API в compose)
Проверяйте, что порт свободен
Адрес стенда
http://localhost:8888/
Регистрация — /sign, модели — /admin/#model-management
Сводка по официальному Quickstart проекта, снято 13.10.2026. Точные требования к версиям образов проверяйте в docker/.env.example.
03Развёртывание за четыре шага
Порядок действий
Практика: команды и адреса
1
Получите исходники
Первый запуск занимает время: образы скачиваются и собираются локально.
terminalcopy
git clone https://github.com/coze-dev/coze-studio.git
cd coze-studio
2
Запустите сервис
На macOS и Linux есть make-цель; на Windows конфиг копируется из примера и запускается docker compose. Успешный старт подтверждает сообщение «Container coze-server Started».
terminalcopy
# macOS / Linux
make web
# Windows
cp ./docker/.env.example ./docker/.env
docker compose -f ./docker/docker-compose.yml up
3
Зарегистрируйте аккаунт
Откройте адрес стенда, задайте логин и пароль, нажмите Register. Это локальная учётная запись администратора — её же потом используют для входа в админку.
браузерcopy
http://localhost:8888/sign
4
Подключите модель
Ключевой шаг, который чаще всего пропускают. В админке добавляется модель: без неё в конструкторе агентов список моделей пуст. Версия образа должна быть не ниже 0.5.0.
браузерcopy
http://localhost:8888/admin/#model-management
Архитектура стенда
Если контейнеры не поднялись
Авторы ведут отдельный FAQ в вики по типовым сбоям старта. Перед тем как чинить compose-файл руками, посмотрите логи контейнера и версию Docker: большинство проблем — несовместимая версия Compose или занятый порт 8888.
04Безопасность: почему нельзя просто выставить стенд в интернет
В README есть явное предупреждение: перед публикацией в публичной сети нужно оценить риски. Перечислены открытая регистрация аккаунтов, исполнение Python в код-узлах воркфлоу, адрес прослушивания Coze Server, SSRF и часть горизонтальных повышений привилегий в API. Это не редкий случай, а нормальная плата за визуальный конструктор, который запускает пользовательский код.
Минимальная защита
Ставьте стенд за обратный прокси с авторизацией, не открывайте админку в интернет, отключите саморегистрацию, если платформа нужна только команде, ограничьте исходящие запросы из контейнеров и не давайте код-узлам доступ к внутренней сети.
Риск
Как проявляется
Что делать
Открытая регистрация
Любой желающий создаёт аккаунт в вашем стенде
Закрыть внешний доступ или отключить регистрацию
Python в код-узлах воркфлоу
Выполнение чужого кода внутри контейнера
Не публиковать конструктор для недоверенных пользователей
SSRF
Запросы из платформы во внутреннюю сеть
Ограничить исходящие соединения на уровне сети
Горизонтальные привилегии в API
Доступ к объектам других пользователей
Обновлять образ, следить за релизами
Формулировки рисков — из официального Quickstart проекта, снято 13.10.2026.
05Место на фоне других open-source платформ
Coze Studio — не самая крупная платформа по звёздам, зато одна из самых «продуктовых»: у неё есть визуальный canvas, магазин плагинов и готовая связка с Coze Loop для оценки качества агентов. Ниже — сопоставимые проекты; цифры взяты через GitHub API 13.10.2026 и показывают только масштаб сообщества, а не качество продукта.
Звёзды GitHub у open-source платформ агентовтыс. ★, снято 13.10.2026
Источник — api.github.com/repos// (stargazers_count). Сравнение условно: у платформ разные задачи и лицензии.
Хронология открытой части Coze
Вариант
Плюсы
Минусы
Локально / свой VPS
Данные не уходят наружу, своя модель, контроль версий
Сами обновляете, сами чините, платите за железо
Облачный Coze (SaaS)
Быстрый старт, актуальные фичи, поддержка
Данные обрабатываются на стороне вендора, нужна оплата из РФ
Другие self-host платформы (Dify, Langflow)
Свои сценарии RAG и оркестрации
Другой набор модулей, миграция не бесплатна
Цены облачных тарифов вендор публикует на официальном сайте и меняет их без предупреждения — фиксированных сумм здесь не приводим сознательно.
06Что сделать после первого запуска
Соберите простого агента-ассистента и опубликуйте его — так проверите всю цепочку «промпт → модель → ответ».
Добавьте базу знаний по своим документам и сравните ответы с и без RAG: обычно видно, где модель начинает выдумывать.
Соберите один воркфлоу с ветвлением и код-узлом — это самый быстрый способ понять ограничения платформы.
Подключите Chat SDK к тестовой странице, чтобы оценить встраивание агента в свой продукт.
Настройте резервное копирование данных стенда: контейнеры поднимаются быстро, а накопленные базы знаний и воркфлоу — нет.
Итог за 15 минут
Стандартный путь — четыре команды и два адреса в браузере: клонирование, make web, регистрация на localhost:8888/sign, подключение модели в /admin/#model-management. Дальше всё зависит от задачи, а не от установки.
Частые вопросы
Coze Studio — что это и чем отличается от coze.com?
Coze Studio — открытая версия платформы Coze (Apache-2.0), которую можно развернуть у себя: агенты, воркфлоу, плагины, базы знаний и API. Отличие от облачного Coze — часть функций осталась в коммерческой версии, обновления и поддержку вы обеспечиваете сами.
Сколько ресурсов нужно для локального запуска?
Официальный минимум — 2 ядра и 4 ГБ памяти плюс установленные Docker и Docker Compose. Для баз знаний и воркфлоу с индексацией закладывайте память с запасом либо выносите модель на внешний API.
Какие модели поддерживаются?
В репозитории указана интеграция с сервисами вроде OpenAI и Volcengine; список задаётся в разделе управления моделями. Подключение модели — обязательный шаг: без него в конструкторе агентов нечего выбирать. Актуальный список провайдеров сверяйте в вики проекта.
Безопасно ли выставлять Coze Studio в интернет?
Авторы предупреждают: перед публичным размещением нужно оценить риски — открытая регистрация, исполнение Python в код-узлах воркфлоу, SSRF и повышения привилегий в API. Для команды безопаснее закрытый стенд за обратным прокси с авторизацией.
Есть ли бесплатная версия и сколько стоит облако?
Открытая версия бесплатна: вы платите только за своё железо и токены модели. Тарифы облачного Coze вендор публикует на официальном сайте и периодически меняет, поэтому конкретные суммы смотрите там же.
Библиотека оркестрации агентов и воркфлоу, на которой построен Coze Studio
Итог гайда
8,4/ 10
Coze Studio даёт за один вечер полноценный конструктор агентов под своим контролем: клонирование, make web, настройка модели — и стенд работает. Слабые места честно перечислены авторами: публичный доступ требует защиты, часть функций только в коммерческой версии, а обновления вы держите сами.
Что почитать дальше
Обзор Coze, сравнение платформ агентов и гайд по Dify — в разделе руководств Qantcore.