OpenDesign — среда с открытым исходным кодом, в которой ИИ-агент создаёт редактируемые прототипы, презентации, документы, изображения и анимационные ролики. Руководство поможет подключить агента или модель, собрать первый проект и получить проверяемый результат, включая MP4 через OpenDesign Motion и HyperFrames.

📌
Актуализировано 21 октября 2026 года. На официальной странице загрузки доступна версия 0.26.0, выпущенная 20 октября. Motion представлен в релизе 0.25.0 от 15 октября; версия 0.26.0 также описывает этот режим и совместное обсуждение работ по ссылке. Команды и ограничения сверены с официальными материалами; установка и рендер в рамках этой актуализации не выполнялись.

Как устроен OpenDesign

OpenDesign объединяет диалог с агентом, файлы проекта и предварительный просмотр. Вы задаёте результат и оформление, агент создаёт исходники, затем вы проверяете их и вносите правки в том же проекте. Код распространяется под Apache-2.0.

Читайте также: разбор Bolt.new.

Работу можно начать с локального агента, собственного API-ключа или OpenDesign Cloud. Поддерживаемые локальные среды включают Codex, Claude Code, Cursor, OpenCode, Qwen, GitHub Copilot, Hermes и DeepSeek Harness. Полный список и способы подключения находятся в README.

💡
CLI — инструмент командной строки, через который OpenDesign запускает локального агента. BYOK — подключение модели по собственному API-ключу. MCP — протокол, через который внешний агент получает доступ к инструментам и файлам OpenDesign. Дизайн-система задаёт оформление; скилл описывает способ выполнения задачи; шаблон даёт стартовую структуру результата.

Основные возможности

ЗадачаЧто создаётсяЧто проверять
Прототип интерфейсаВеб-, настольный или мобильный прототип с исходниками и просмотромАдаптивность, состояния элементов, соответствие брифу
Презентация или документРедактируемый материал; для презентаций предусмотрены HTML, PDF, PPTX, ZIP и MarkdownФакты, переносы, порядок страниц и доступность экспорта в вашей среде
ИзображениеВизуальный материал через подключённого медиапровайдераСоответствие заданию, права использования и стоимость генерации
Motion DesignHTML-анимация либо видеопроект с MP4Тайминг, читаемость, звук, исходники и воспроизведение готового файла
Работа с оформлениемПакет на базе DESIGN.md с правилами брендаЦвета, шрифты, компоненты и нежелательные приёмы
Передача в разработкуАктуальные файлы проекта через CLI или MCPВыбранный проект, права доступа и изменения в коде
Обсуждение с командойСсылка на работу с комментариями, которые возвращаются в проектСостав опубликованного предпросмотра и актуальность версии

Форматы и рабочие процессы описаны в обзоре продукта; показ работ и комментарии по ссылке — в релизе 0.26.0.

Компоненты системы

graph TD
    A[Браузер или Electron] -->|HTTP и SSE| B[Веб-приложение Next.js]
    B --> C[Локальный демон Express]
    C --> D[SQLite и файлы проектов]
    C --> E[Скиллы, шаблоны, дизайн-системы и плагины]
    C --> F[Локальный ИИ-агент]
    C --> G[API-провайдер модели]
    B --> H[Изолированный предпросмотр]

Демон — фоновый сервис, который управляет проектами, запускает агентов, обращается к API и передаёт события интерфейсу. Текущий стек включает Next.js 16, TypeScript, Express и SQLite. Подробности — в описании архитектуры.

Локальная установка хранит рабочие файлы на вашей стороне, но подключённый облачный агент или API может передавать данные своему провайдеру. Перед использованием конфиденциальных материалов проверьте выбранную модель и условия её обработки данных.

Установка и подключение модели

Настольное приложение: основной маршрут

На странице загрузки доступны сборки 0.26.0 для macOS на Apple Silicon и Intel, а также Windows x64. Указанные требования: macOS 11 Big Sur или новее, Windows 10 или 11. Готового Linux-установщика в текущем официальном релизе нет; для Linux используйте запуск из исходников.

  1. Скачайте сборку для своей системы и установите приложение.
  2. Выберите способ работы: локальный агент, API Key или OpenDesign Hosted/Cloud.
  3. Для локального агента установите и авторизуйте его CLI отдельно. Убедитесь, что OpenDesign обнаружил исполняемый файл.
  4. Для BYOK задайте адрес API, ключ и идентификатор модели. В версии 0.26.0 при первичной настройке можно вводить собственное имя модели, не ограничиваясь предложенным списком.
  5. Создайте небольшой тестовый проект и убедитесь, что агент отвечает, создаёт файл и открывает его в предпросмотре.

Пресеты BYOK включают Anthropic, OpenAI, Azure OpenAI, Google Gemini, Ollama, LM Studio, vLLM и совместимые API. Поля подключения — baseUrl, apiKey, model; особенности описаны в README. Ключ вводите в настройки провайдера, не в бриф, код страницы или общие файлы проекта.

Docker

Нужны Docker и Docker Compose v2. Следуйте официальному Quickstart:

git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
cp .env.example .env
openssl rand -hex 32

Скопируйте полученный случайный токен в существующую строку OD_API_TOKEN= файла deploy/.env, затем запустите контейнер:

docker compose up -d

Откройте http://127.0.0.1:7456. Если браузер запросит Basic Auth, используйте имя open-design и значение OD_API_TOKEN как пароль. Первый запуск включает загрузку образа и может занять время. Локальный CLI с вашего компьютера не становится автоматически доступным внутри контейнера: отдельно проверьте среду агента или настройте BYOK.

Для диагностики и обновления образа:

docker compose logs -f
docker compose pull
docker compose up -d
⚠️
Не выставляйте демон в публичную сеть без аутентификации, разрешённых origins и корректного проксирования потоковых ответов. Перед обновлением сохраните резервную копию данных по инструкции вашей установки. Команда docker compose down -v удаляет тома и не подходит для обычной остановки.

Запуск из исходников

По текущему Quickstart нужны Node.js 24.x и pnpm 10.33.x; репозиторий закрепляет pnpm 10.33.2. Установите Git и выполните:

git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run web

Откройте URL, который напечатает tools-dev: без явной настройки инструмент выбирает свободные порты. Команда получает текущую ветку разработки; её содержимое может отличаться от настольного релиза 0.26.0. Для остановки управляемых фоновых сервисов предусмотрено pnpm tools-dev stop.

Первый проект: от задания до файла

  1. Выберите результат. На Home начните прототип, презентацию, документ, изображение или Motion Design.
  2. Выберите движок. Укажите локального агента либо API/Cloud-модель.
  3. Подготовьте бриф. Назовите аудиторию, цель, формат, обязательное содержание и ограничения. Приложите разрешённые изображения и фактические данные.
  4. Подключите оформление. Выберите дизайн-систему и подходящий шаблон или плагин.
  5. Закажите создание. Если сначала нужен только план, скажите это прямо. Для готового результата явно запросите файлы и нужный формат экспорта.
  6. Проверьте предпросмотр. Откройте созданный файл, найдите ошибки содержания и оформления, передайте конкретные замечания агенту.
  7. Проверьте экспорт отдельно. Откройте полученный файл вне OpenDesign и убедитесь, что он пригоден для передачи.

Локальные среды с файловыми инструментами записывают исходники непосредственно в проект. Текстовые и BYOK-среды могут возвращать полный исходный блок, который OpenDesign преобразует в файл. Эти способы передачи результата различаются; диагностика приведена в Quickstart.

Скиллы, шаблоны и дизайн-системы

В репозитории разделены каталоги:

  • skills/ — функциональные инструкции для агента;
  • design-templates/ — стартовые структуры прототипов, презентаций, документов и медиа;
  • design-systems/ — пакеты оформления на базе DESIGN.md;
  • plugins/ — расширения, объединяющие связанные возможности и сценарии.

DESIGN.md описывает цвета, типографику, композицию, компоненты, движение и нежелательные паттерны. Некоторые пакеты также содержат токены CSS, компоненты и ресурсы. В актуальном README указана 151 дизайн-система. Число 132 из раннего описания продукта не следует использовать как текущий размер единого каталога скиллов.

Смена дизайн-системы задаёт правила для следующего обращения к агенту. Чтобы переработать уже созданный материал, явно попросите применить новое оформление и проверьте результат. Для презентаций доступны, в частности, guizang-ppt и HTML-шаблоны; для видео — шаблоны HyperFrames и примеры Motion Design.

OpenDesign Motion: анимация и видео через агента

OpenDesign Motion — направление работы с анимацией внутри OpenDesign. В интерфейсе оно представлено типом Motion Design на Home и в Community. Вы выбираете пример или задаёте собственный бриф, агент создаёт редактируемые исходники и, если запрошен видеоролик, MP4. Этот порядок описан в релизе 0.25.0 и реализации Motion Design.

Что можно взять за основу

В стартовый набор входят пять примеров:

  • Motion Future;
  • Product Promo;
  • Showreel;
  • UI Morph;
  • Visual Lesson.

Примеры поставляются со скриптами, шрифтами, аудио и предпросмотром. Дополнительные инструкции для анимации выбираются через @. Содержимое набора зафиксировано в заметках к выпуску.

💡
Укажите конечный формат. Для интерактивной анимации результатом может быть запускаемый HTML. Для видео попросите MP4 и сохранение редактируемых исходников. Наличие анимации в предпросмотре ещё не подтверждает, что готовый видеофайл создан.

Читайте также: Edits для Mac — руководство для новичка.

Первый ролик без платной генерации медиа

Для минимальной проверки подготовьте короткий текст и выберите пример Motion Design. Начните с 5–10 секунд, простых фигур и титров, без внешней генерации изображений, видео и звука. Подключённый агент при этом может расходовать квоту или оплачиваемые токены.

  1. Откройте Motion Design на Home или в Community.
  2. Выберите пример, например Product Promo, и нужного агента.
  3. Укажите длительность, пропорции, текст, оформление и звуковую политику: без звука либо с конкретным разрешённым аудиофайлом.
  4. Через @ выберите подходящий motion-скилл из доступных в вашей установке.
  5. Попросите создать ролик с исходниками и MP4. Дождитесь завершения рендера.
  6. Откройте MP4 отдельно, затем попросите одну небольшую правку и повторную сборку. Так вы проверите и экспорт, и возможность продолжать работу с исходниками.

Промпт:

Создай в этом проекте 8-секундный ролик Motion Design в формате 16:9, 1920×1080. Используй простые геометрические фигуры и точный русский текст: «От идеи к прототипу». Сначала плавно собери композицию, затем покажи заголовок и удержи финальный кадр для чтения.

Примени выбранную дизайн-систему. Сделай видео без звука. Не используй платную генерацию изображений, видео, музыки или речи и не публикуй результат.

Сохрани редактируемые исходники и создай MP4 через доступный в OpenDesign процесс HyperFrames. Проверь длительность, отсутствие обрезанного текста, первый и последний кадры и воспроизводимость MP4. Сообщи имя готового файла и расположение исходников. Если экспорт не удался, сохрани исходники и назови ошибку.

Признак успеха: есть воспроизводимый восьмисекундный MP4 нужного размера; текст совпадает с заданием, звука нет; после правки исходников создаётся обновлённый файл. Это критерии проверки, а не результат запуска, выполненного для данного руководства.

Интеграция с HyperFrames: как получается MP4

HyperFrames — открытый видеофреймворк HeyGen, встроенный в видеопроцесс OpenDesign. Агент описывает композицию с помощью HTML, CSS и анимации, например GSAP. HyperFrames переводит её в кадры через Chrome без графического интерфейса, затем FFmpeg кодирует MP4 и обрабатывает звук. Эта интеграция описана в README OpenDesign.

Роли распределены так:

КомпонентОтветственностьРезультат
OpenDesignБриф, выбор агента, оформление, файлы, предпросмотр и запуск медиазадачиРабочий проект
ИИ-агентСцены, HTML/CSS, анимация, подключение медиа и правкиРедактируемая композиция
HyperFramesУправление временем, покадровый рендер и сборка со звукомMP4
Внешний медиапровайдер, если подключёнСоздание отдельных видеоклипов, изображений или аудиоМедиа для композиции

Так можно собирать типографические заставки, продуктовые промо, объясняющие ролики и анимированные данные. Генерация видеокадров внешней моделью — отдельная операция со своим провайдером и оплатой; для ролика из текста и фигур она не обязательна.

Где остаются исходники и почему важен штатный рендер

В шаблоне интеграции OpenDesign композиции размещаются в скрытой папке .hyperframes-cache/ внутри проекта. Там находятся HTML, метаданные и ресурсы; готовый MP4 выводится в корень проекта. Поэтому отсутствие HTML в обычном списке результатов не означает, что исходников нет. Перед архивированием попросите агента указать их точное расположение и включите скрытые файлы в резервную копию.

Внутри OpenDesign рендер, требующий запуска Chrome, передаётся локальному демону. Самостоятельный вызов HyperFrames из ограниченной оболочки агента может зависнуть, в частности из-за macOS sandbox. Для обычного пользователя надёжнее поручить сборку штатному процессу OpenDesign, а не переносить в чат внутренние команды диспетчера.

Для корректной перемотки анимация должна быть связана со временем композиции. Случайные значения без фиксированного начального состояния, бесконечные циклы и самостоятельное управление воспроизведением медиа могут нарушить покадровый рендер. Эти требования должен соблюдать агент по контракту HyperFrames.

Отдельный CLI-маршрут HyperFrames

Если вы создаёте самостоятельный проект HyperFrames вне OpenDesign, официальный быстрый старт требует Node.js 22+ и FFmpeg:

npx hyperframes init my-video
cd my-video
npx hyperframes preview

После проверки предпросмотра остановите его через Ctrl+C и выполните:

npx hyperframes lint
npx hyperframes render

Это отдельный способ работы. Он не является обязательным шагом установки Motion и не заменяет штатный диспетчер рендера внутри OpenDesign. Для самостоятельной работы через Codex есть руководство по HyperFrames.

Подключение внешнего агента через MCP

OpenDesign поставляет stdio MCP-сервер. Через него внешний агент читает актуальные файлы проекта без повторного экспорта ZIP. Способы установки перечислены в README.

Для настольной установки откройте Settings → MCP server и используйте конфигурацию для своего клиента. Если команда OpenDesign od уже корректно установлена, можно сначала посмотреть конфигурацию, затем установить её для Codex:

od mcp install codex --print
od mcp install codex

На macOS и в WSL2 имя od может совпадать с системной /usr/bin/od. В таком случае используйте конфигурацию из настроек с абсолютным путём к OpenDesign.

Проверка после подключения: попросите внешнего агента перечислить проекты и прочитать известный файл из выбранного проекта. Если используете CLI, сначала получите идентификатор:

od project list --json

Затем подставьте его вместо PROJECT_ID:

od files list PROJECT_ID --json
⚠️
До выдачи прав на запись или удаление проверьте проект и разрешения MCP-клиента. Эти операции изменяют рабочие файлы. Начните с чтения одного известного файла и просматривайте изменения перед сохранением.

Показ работы и комментарии в версии 0.26.0

Релиз 0.26.0 позволяет отправить ссылку на интерактивную работу или motion-видео. Рецензенту нужен вход в аккаунт, но устанавливать настольное приложение не требуется. На общей странице видны предпросмотр и комментарии; разговоры проекта с ИИ и представление кода туда не включаются.

Порядок согласования:

  1. Подготовьте версию, которую можно показывать, и создайте ссылку на работу.
  2. Получите комментарии, привязанные к нужному месту.
  3. В OpenDesign выберите замечания, которые хотите выполнить, и передайте их агенту.
  4. Проверьте исправленный результат.
  5. Вручную обновите содержимое по ссылке. URL сохраняется; зрителям нужно обновить просмотр, чтобы увидеть новую версию.
  6. Завершите доступ по ссылке после согласования, если он больше не нужен.

Показ по ссылке выводит выбранный материал за пределы локальной среды. До отправки проверьте, нет ли в самом предпросмотре закрытых данных, даже если чат и код не показываются.

Полезные сценарии

Прототип лендинга в фирменном стиле

Задача: проверить структуру страницы до разработки. На входе: бриф, согласованные тексты и DESIGN.md либо референс оформления.

Выберите Prototype и подходящий шаблон, например saas-landing, подключите дизайн-систему и попросите создать страницу. Проверьте мобильный и настольный размеры, затем внесите правки через агента.

Результат: исходники и открывающийся прототип с нужными секциями и оформлением. Ограничение: доступность, безопасность, формы и готовность к рабочей эксплуатации проверяются отдельно.

Презентация с последующей правкой

Задача: собрать доклад или питч. На входе: структура, проверенные факты и разрешённые изображения.

Выберите режим презентации, шаблон и дизайн-систему. После генерации проверьте порядок слайдов, цифры и переносы; экспортируйте в нужный формат и откройте файл отдельно.

Результат: редактируемая презентация и проверенный экспорт. Ограничение: доступность и точность переноса в PPTX зависят от среды и способа экспорта; наличие HTML-предпросмотра не подтверждает качество PowerPoint-файла.

Короткий анимационный ролик о продукте

Задача: показать один тезис или функцию за 15–30 секунд. На входе: точный текст, реальные изображения продукта, оформление и при необходимости разрешённый аудиофайл.

Откройте Motion Design, начните с Product Promo и задайте длительность и пропорции. Попросите агент создать редактируемую композицию и MP4 через HyperFrames. После просмотра исправьте конкретную сцену и повторите экспорт.

Читайте также: разбор Recordly.

Результат: MP4 с нужным содержанием и исходники для дальнейших версий. Ограничение: внешние генерации и озвучка требуют отдельной настройки; не подменяйте реальный интерфейс выдуманной картинкой.

Второй формат ролика для другой площадки

Задача: получить вертикальную версию принятого горизонтального видео. На входе: исходники композиции, медиа и согласованный текст.

Попросите агента сделать отдельную версию 9:16, перерасположить текст и изображения, сохранить содержание и пересобрать MP4. Проверьте его на экране телефона.

Результат: отдельный вертикальный файл с читаемыми титрами и сохранёнными важными элементами. Ограничение: простая обрезка или растягивание 16:9 не гарантируют пригодности результата; сложные сцены требуют новой компоновки.

Передача прототипа в рабочий репозиторий

Задача: продолжить разработку с актуальными файлами. На входе: проект OpenDesign и подключённый MCP-клиент в Codex, Claude Code или другой совместимой среде.

Попросите агента прочитать файлы конкретного проекта, перенести нужные части в репозиторий и показать изменения перед записью.

Результат: агент использует текущие HTML, CSS или компоненты без промежуточного ZIP. Ограничение: права на рабочий репозиторий и файлы OpenDesign проверяются отдельно; резервная копия нужна до массовой правки.

Расходы, безопасность и ограничения

Сам OpenDesign доступен под Apache-2.0. Работа локального агента расходует его квоту или оплачивается по тарифу провайдера; BYOK оплачивается по условиям выбранного API. OpenDesign Cloud — отдельный сервис с собственными планами и условиями. Цены и акции меняются, поэтому локальную бесплатную установку нельзя приравнивать к бесплатной работе всех моделей.

Перед началом учитывайте:

  • Качество и скорость зависят от агента, модели, сложности композиции и компьютера.
  • Возможности файловых инструментов и текстового BYOK-профиля различаются. Наличие провайдера в списке не подтверждает весь видеопроцесс: проверьте его на коротком ролике.
  • Облачные модели, показ по ссылке и внешние медиапровайдеры требуют отдельной оценки того, какие данные покидают компьютер.
  • Генерация изображений, видео и речи может иметь собственные расходы, квоты и права использования.
  • Шрифты, изображения и аудио должны быть доступны при финальном рендере; внешние сетевые ресурсы могут мешать автономной сборке.
  • Прототип требует отдельной проверки перед рабочим размещением, а длинный съёмочный монтаж — оценки удобства на небольшом фрагменте.

Защита OpenDesign от запросов к внутренним адресам может блокировать частный API-провайдер с сообщением Internal IPs blocked. Для доверенного внутреннего хоста предусмотрен OD_ALLOWED_INTERNAL_HOSTS; правила перечислены в README. Разрешайте только нужные имена или IP, не отключайте защиту целиком.

Если что-то не работает

СимптомЧто проверитьПризнак исправления
Локальный агент не найденУстановку и авторизацию CLI; доступность его папки в PATH процесса OpenDesign; Rescan в Models & providers → Local CLIАгент определяется и выполняет короткую задачу
BYOK не отвечаетbaseUrl, ключ, точное имя модели, баланс и блокировку внутренних адресовМодель возвращает ответ без ошибки доступа
Нет Motion DesignВерсию приложения; наличие режима на Home или в Community; текущий установщик на официальном сайтеРежим и стартовые примеры доступны
Анимация открылась, MP4 нетБыл ли явно заказан видеоролик; статус экспорта и фактическую ошибкуЕсть отдельный воспроизводимый MP4
Рендер завис из оболочки агентаИспользуется ли штатный диспетчер OpenDesign для Chrome-зависимого рендераМедиазадача завершается и возвращает файл
В сборке из исходников отсутствует OD_BIN или URL демона содержит :0Сборку CLI демона и перезапуск через tools-dev; повторное открытие проекта из приложенияАгент получает действительное окружение проекта
По общей ссылке старая версияВыполнено ли ручное обновление содержимого; обновил ли зритель страницуПо прежнему URL видна новая работа

Диагностика установки и медиадиспетчера описана в Quickstart; особенности Motion и общих ссылок — в релизе 0.26.0.

Проверка установки и готового результата

Для локального веб- или Docker-запуска проверьте доступность демона. Подставьте фактический порт, если он отличается:

curl -i http://127.0.0.1:7456/api/health

HTTP-ответ подтверждает доступность сервиса, но не готовность агента и экспорта. Завершите проверку в интерфейсе:

Выбранный агент или BYOK-провайдер выполняет короткую задачу.
Создаётся тестовый проект и хотя бы один файл.
Файл открывается в предпросмотре; после правки видна новая версия.
Нужный экспорт открывается вне OpenDesign.
Для Motion сохранены исходники и MP4, если заказан ролик.
Длительность, пропорции, титры и звук соответствуют заданию.
Первый и последний кадры, переходы и переносы текста проверены вручную.
При использовании общей ссылки показана последняя согласованная версия.

При наличии FFmpeg можно дополнительно проверить скачанный MP4. Замените final.mp4 на имя своего файла:

ffprobe -v error -show_entries format=duration:stream=codec_type,width,height -of json final.mp4
ffmpeg -v error -i final.mp4 -f null -

Первая команда показывает длительность и параметры потоков. Вторая декодирует файл целиком; нормальное завершение без сообщений об ошибках подтверждает отсутствие обнаруженных ошибок декодирования. Читаемость текста, достоверность содержания и качество звука оцениваются просмотром.

Следующий шаг

База знаний: HyperFrames от HeyGen — видео как код для ИИ-агентов и Codex — устройство видеокомпозиции, команды и самостоятельный рендер.

Если вы хотите связать прототипы, презентации и видео одним оформлением и агентным процессом, начните с одного короткого проекта и требований к файлам, данным и проверке результата.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov