Video Creative System

Система производства вертикальных VoiceOver-креативов через AI-агента. Это не SaaS-панель и не видеоредактор с ручным интерфейсом. Пользователь общается с агентом в чате, согласовывает сценарий, раскадровку и визуальные материалы, а агент выполняет установку, генерацию, монтаж, проверку и точечные правки.

Начальная инструкция для агента: AGENT_GUIDE.md.

Возможности

• VoiceOver-сборка по декларативному manifest;
• профили classic и kinetic_clipart_v4;
• субтитры по словам, Hook Overlay и безопасный кроп 4:5;
• анимированные клипарты и reusable infographic shots;
• Imagen 4 и Veo 3.1 для недостающих визуальных материалов;
• ElevenLabs V3 и Whisper для озвучки и таймингов;
• музыка, riser, синхронизированные SFX и LUFS mastering;
• SQLite-реестр исходников, сценариев, транскрипций и версий роликов;
• поэтапный кэш и хирургические правки без полной пересборки;
• браузерная review-галерея и финальный экспорт 1080x1920.

Клиентские исходники, API-ключи, музыка, бренды и готовые рекламные ролики в репозиторий не входят.

Быстрый запуск

Требуются Linux или macOS, Python 3.11-3.13, Node.js 20+, npm, FFmpeg 6+ и Git. На Windows используйте WSL2.

git clone https://github.com/dengineproblem/video-creative-system-public.git
cd video-creative-system-public
./scripts/install.sh --full
chmod 600 .env
./scripts/doctor.py
./scripts/smoke_test.sh --render

install.sh создаёт .env. Добавляйте в него только собственные ключи тех провайдеров, которыми планируете пользоваться. Smoke test не обращается к платным API и собирает короткий технический ролик.

При первом рендере Remotion скачивает Chrome Headless Shell размером около 100 МБ. Это однократная операция.

Как передать систему агенту

После клонирования откройте агенту каталог репозитория и передайте AGENT_GUIDE.md с задачей:

Установи систему, выполни doctor и бесплатный smoke render, затем создай мой первый проект. Не запускай платную генерацию до согласования сценария, раскадровки и генерируемых кадров.

Агент должен последовательно провести пользователя через:

1. создание проекта и подключение исходников;
2. сохранение референсов и транскрипций;
3. согласование сценария;
4. согласование раскадровки;
5. предварительный просмотр hook и infographic shots;
6. выбор голоса, музыки и стиля субтитров;
7. review-сборку и точечны