OpenDesign — среда с открытым исходным кодом, в которой ИИ-агент создаёт редактируемые прототипы, презентации, документы, изображения и анимационные ролики. Руководство поможет подключить агента или модель, собрать первый проект и получить проверяемый результат, включая MP4 через OpenDesign Motion и HyperFrames.
Как устроен OpenDesign
OpenDesign объединяет диалог с агентом, файлы проекта и предварительный просмотр. Вы задаёте результат и оформление, агент создаёт исходники, затем вы проверяете их и вносите правки в том же проекте. Код распространяется под Apache-2.0.
Читайте также: разбор Bolt.new.
Работу можно начать с локального агента, собственного API-ключа или OpenDesign Cloud. Поддерживаемые локальные среды включают Codex, Claude Code, Cursor, OpenCode, Qwen, GitHub Copilot, Hermes и DeepSeek Harness. Полный список и способы подключения находятся в README.
Основные возможности
| Задача | Что создаётся | Что проверять |
| Прототип интерфейса | Веб-, настольный или мобильный прототип с исходниками и просмотром | Адаптивность, состояния элементов, соответствие брифу |
| Презентация или документ | Редактируемый материал; для презентаций предусмотрены HTML, PDF, PPTX, ZIP и Markdown | Факты, переносы, порядок страниц и доступность экспорта в вашей среде |
| Изображение | Визуальный материал через подключённого медиапровайдера | Соответствие заданию, права использования и стоимость генерации |
| Motion Design | HTML-анимация либо видеопроект с 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 используйте запуск из исходников.
- Скачайте сборку для своей системы и установите приложение.
- Выберите способ работы: локальный агент, API Key или OpenDesign Hosted/Cloud.
- Для локального агента установите и авторизуйте его CLI отдельно. Убедитесь, что OpenDesign обнаружил исполняемый файл.
- Для BYOK задайте адрес API, ключ и идентификатор модели. В версии 0.26.0 при первичной настройке можно вводить собственное имя модели, не ограничиваясь предложенным списком.
- Создайте небольшой тестовый проект и убедитесь, что агент отвечает, создаёт файл и открывает его в предпросмотре.
Пресеты 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 -fdocker compose pull
docker compose up -ddocker 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.
Первый проект: от задания до файла
- Выберите результат. На Home начните прототип, презентацию, документ, изображение или Motion Design.
- Выберите движок. Укажите локального агента либо API/Cloud-модель.
- Подготовьте бриф. Назовите аудиторию, цель, формат, обязательное содержание и ограничения. Приложите разрешённые изображения и фактические данные.
- Подключите оформление. Выберите дизайн-систему и подходящий шаблон или плагин.
- Закажите создание. Если сначала нужен только план, скажите это прямо. Для готового результата явно запросите файлы и нужный формат экспорта.
- Проверьте предпросмотр. Откройте созданный файл, найдите ошибки содержания и оформления, передайте конкретные замечания агенту.
- Проверьте экспорт отдельно. Откройте полученный файл вне 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.
Примеры поставляются со скриптами, шрифтами, аудио и предпросмотром. Дополнительные инструкции для анимации выбираются через @. Содержимое набора зафиксировано в заметках к выпуску.
Читайте также: Edits для Mac — руководство для новичка.
Первый ролик без платной генерации медиа
Для минимальной проверки подготовьте короткий текст и выберите пример Motion Design. Начните с 5–10 секунд, простых фигур и титров, без внешней генерации изображений, видео и звука. Подключённый агент при этом может расходовать квоту или оплачиваемые токены.
- Откройте Motion Design на Home или в Community.
- Выберите пример, например Product Promo, и нужного агента.
- Укажите длительность, пропорции, текст, оформление и звуковую политику: без звука либо с конкретным разрешённым аудиофайлом.
- Через
@выберите подходящий motion-скилл из доступных в вашей установке. - Попросите создать ролик с исходниками и MP4. Дождитесь завершения рендера.
- Откройте 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Показ работы и комментарии в версии 0.26.0
Релиз 0.26.0 позволяет отправить ссылку на интерактивную работу или motion-видео. Рецензенту нужен вход в аккаунт, но устанавливать настольное приложение не требуется. На общей странице видны предпросмотр и комментарии; разговоры проекта с ИИ и представление кода туда не включаются.
Порядок согласования:
- Подготовьте версию, которую можно показывать, и создайте ссылку на работу.
- Получите комментарии, привязанные к нужному месту.
- В OpenDesign выберите замечания, которые хотите выполнить, и передайте их агенту.
- Проверьте исправленный результат.
- Вручную обновите содержимое по ссылке. URL сохраняется; зрителям нужно обновить просмотр, чтобы увидеть новую версию.
- Завершите доступ по ссылке после согласования, если он больше не нужен.
Показ по ссылке выводит выбранный материал за пределы локальной среды. До отправки проверьте, нет ли в самом предпросмотре закрытых данных, даже если чат и код не показываются.
Полезные сценарии
Прототип лендинга в фирменном стиле
Задача: проверить структуру страницы до разработки. На входе: бриф, согласованные тексты и 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/healthHTTP-ответ подтверждает доступность сервиса, но не готовность агента и экспорта. Завершите проверку в интерфейсе:
При наличии 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

