VibeFrame — генерация видео для агентов
VibeFrame
CLI и MCP-сервер: агент делает видео из брифа на ваших ключах Seedance, Runway, Veo и Kling под жестким лимитом расходов
- 185 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Генерация идет на ваших ключах провайдеров и стоит денег, а потолок `--max-cost` действует только если задан
- Ключи сохраняются в `~/.vibeframe/config.yaml`, установщик запускает скрипт из сети
Установка
- Работает в
Ручная установка
curl -fsSL https://vibeframe.ai/install.sh | bashЗатем `vibe doctor`. Нужны Node.js 20+, FFmpeg и Chrome. Установщик скачивает и запускает скрипт, прочитайте его перед запуском.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Генерация идет на ваших ключах провайдеров и стоит денег, а потолок `--max-cost` действует только если задан
- Ключи сохраняются в `~/.vibeframe/config.yaml`, установщик запускает скрипт из сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
VibeFrame превращает текстовый бриф в план, генерирует материалы в передовых моделях (Seedance, Runway, Kling, Gemini Omni) и собирает готовый MP4. Работает как CLI `vibe` для Claude Code, Codex, Cursor и любого агента с доступом к оболочке и как MCP-сервер для клиентов, которым удобнее типизированные вызовы. Главная идея — цена известна заранее. Команда `vibe build film --dry-run --max-cost 3 --json` считает смету без обращения к провайдерам и ключей. Если смета выше потолка, сборка не стартует: агент получает код `COST_CAP_EXCEEDED` и варианты `retryWith`, в том числе дешевле. Каждая ошибка приходит машиночитаемой, а не стек-трейсом. Проект после `vibe init` состоит из `STORYBOARD.md`, `DESIGN.md` и сцен в `scenes/`, по одному Markdown-файлу на сцену. Файлы можно править руками или поручить агенту. Склейка и рендер идут локально через FFmpeg и Chrome, композицию сцен VibeFrame делегирует Remotion и Hyperframes. Платная генерация нужна только для изображений и видео, озвучка Kokoro и сборка работают без ключей.
Для кого. Разработчикам и маркетологам, которые поручают Claude Code или Codex ролики и хотят потолок расходов, который агент не обойдет.
Подходит, если
- Ролик нужен по заметкам или одной строке, а агент должен сам собрать план, сцены и рендер
- Стоимость генерации надо знать до оплаты, в том числе когда ключей у вас еще нет
- Один персонаж проходит через несколько сцен, и кадры должны совпадать по виду
- Агент перебирает варианты, и каждый отказ должен сопровождаться готовыми шагами для повтора
- Сборка видео идет без платных ключей: Kokoro, HTML-сцены, Chrome и FFmpeg
Не подходит, если
- Задача сводится к сценам на HTML и их рендеру: авторы сами советуют брать Hyperframes напрямую
- Нужен только монтаж готовых файлов без генерации: хватит FFmpeg
- На машине нет Node.js 20, FFmpeg и Chrome: без них `vibe doctor` не пройдет
Пример запроса к агенту
Сделай 30-секундный ролик о запуске продукта по brief.md. Сначала посчитай смету с потолком 5 долларов и покажи ее, генерировать начинай только после моего ответа.Ограничения
Нужны Node.js 20 и новее, FFmpeg и Chrome или Chromium: проверяет их `vibe doctor`. Потолок `--max-cost` работает, только если задан: ограничение стоит прописать в команде или конфиге проекта.
Ключи нужны для провайдеров, которых вы используете: `OPENAI_API_KEY`, `FAL_API_KEY`, `GOOGLE_API_KEY`, `RUNWAY_API_SECRET`, `KLING_API_KEY`. Пакет называется `@vibeframe/cli`, а `npx vibeframe` запустит чужой пакет с тем же именем.
Проект не связан с HeyGen. Установщик через `curl | bash` кладет CLI в каталог данных XDG. Последний коммит репозитория: ноябрь 2026.
Как отключить. Удалите запись `vibeframe` из конфигурации MCP-клиента и каталог установки в `~/.local/share/vibeframe`. Ключи лежат в `~/.vibeframe/config.yaml`, удалите их оттуда.
Частые вопросы
Как ограничить расходы на генерацию видео?
Добавьте `--max-cost` к команде: `vibe build launch --max-cost 5`. Сборка отказывается стартовать, если смета выше. Смету без ключей считает `--dry-run`.
Как подключить MCP-сервер VibeFrame?
Команда `vibe host setup cursor --write` пишет `.cursor/mcp.json`, а `vibe host setup all` печатает фрагменты для всех клиентов. Вручную добавьте сервер с командой `npx` и аргументами `-y @vibeframe/mcp-server`. Для Claude Desktop есть готовое расширение `vibeframe.mcpb`.
Можно ли собрать видео без платных ключей?
Да, локальная часть работает бесплатно: озвучка Kokoro, сцены из HTML и CSS, Chrome без окна и FFmpeg. Ключи нужны только для генерации изображений и видео в моделях провайдеров.
Какие модели генерации поддерживаются?
Из README: Seedance, Runway, Kling и Gemini Omni, а в описании репозитория названы еще Veo. Список провайдеров и моделей ведется в файле `MODELS.md`.
Что делать, если сборка отказала по смете?
Агент получает код `COST_CAP_EXCEEDED` и список `retryWith`: например, пропустить фон через `--skip-backdrop` или поднять потолок до сметы. Повышать потолок стоит только с вашего согласия.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор скиллов, CLI и MCP-сервер, чтобы Claude Code или Codex делали видео по описанию: монтаж, графика, озвучка и субтитры
Скилл превращает тему или текст в рисованный объясняющий ролик: бриф, раскадровка, пробный фрагмент и локальный рендер.
Два скилла для генеративного видео и картинок: video пишет промпты для Seedance, Kling и Veo по правилам драматургии, image подбирает модель и синтаксис
Vibe Vision Video, скилл для видео, сохраняет проект редактируемым, чтобы автор или другой агент продолжил работу с роликом.
Локальная видеостудия для кодового агента: вы описываете ролик одной фразой, агент режиссирует, машина рендерит без облака
Скилл заставляет агента снять короткий фильм о продукте: идея, монтаж, звук и рендер на Remotion или HyperFrames
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| VibeFrame — генерация видео для агентов (эта карточка) | нет | 185 | |
| HyperFrames | нет | 79 556 | движок сцен на HTML без платной генерации и сметы |
| video-use | нет | 30 591 | навык монтажа видео для агента без бюджетного потолка |
Коротко о README
README открывается примером отказа по смете, затем объясняет, где VibeFrame стоит относительно Remotion и Hyperframes: композицию он делегирует, а платную генерацию берет на себя. Дальше идут установка, структура проекта из сцен, непрерывность персонажа между кадрами и подключение MCP.