Ralphy — CLI для видеороликов и контента с агентом
Ralphy Video CLI
Ralphy дает Claude Code, Cursor и Codex команды для создания видео: шаблон, генерация кадров с оценкой стоимости и рендер в mp4
- 144 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Генерация идет через платные API: без `--dry-run` агент может потратить деньги на ключах OpenRouter и ElevenLabs
- Установочный скрипт `curl | sh` запускает код из сети, перед запуском стоит прочитать его
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ralphy-video-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Генерация идет через платные API: без `--dry-run` агент может потратить деньги на ключах OpenRouter и ElevenLabs
- Установочный скрипт `curl | sh` запускает код из сети, перед запуском стоит прочитать его
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ralphy — настольное приложение для работы с контентом, а в репозитории лежит и самостоятельный CLI `ralphy`. Агент управляет им командами: `ralphy new` создает проект, `ralphy template suggest` подбирает шаблон по фразе, `ralphy template use` разворачивает его, `ralphy generate image` делает кадры, `ralphy render` собирает mp4. Модели вызываются через OpenRouter (Kling, Seedance, Veo, Sora, Nano-Banana), озвучку и музыку дает ElevenLabs. Ролик собирается в HyperFrames: это HTML с анимацией GSAP, которую рендерят Puppeteer и FFmpeg. Флаг `--dry-run` показывает стоимость генерации до траты денег. Единственная точка входа — глагол `ralphy`: каждый вызов модели попадает в журнал `generations.jsonl`, каждая цена в сводку, каждый сбой в разбор. Если сцена не проходит проверки качества, рендер отказывает. После `ralphy setup` в агента ставится скилл, и дальше он ведет работу сам.
Для кого. Авторам коротких роликов, рекламы и контента для соцсетей, которые отдают сборку видео локальному агенту и хотят видеть цену до запуска.
Подходит, если
- Агент должен сделать рекламный ролик на 30 секунд по короткому описанию
- Нужно подобрать шаблон ролика по фразе вроде «говорящая голова про дедлайны»
- Перед генерацией кадров нужна смета, чтобы не потратить лишнее
- Сборку видео надо вести в git: HTML-композиция версионируется и проверяется в CI
- Стоимость и сбои генерации нужно собирать в журнал для разбора
Не подходит, если
- Нужен монтаж готовых съемок на временной шкале: Ralphy собирает ролики из сгенерированных кадров и шаблонов
- Нет ключей OpenRouter и ElevenLabs: без них генерация не заработает
- Ролик нужен за минуты: холодный старт занимает около 8 минут, пакет из 10 роликов около 25
- Бюджет нулевой: типичная цена 30-секундного ролика по данным README 8–12 долларов
Пример запроса к агенту
Сделай рекламный ролик на 30 секунд про весеннее эспрессо. Сначала подбери шаблон и покажи смету генерации через --dry-run.Ограничения
Для работы нужны Bun и ffmpeg, а также ключи `OPENROUTER_API_KEY` и `ELEVENLABS_API_KEY`. Генерация платная, ориентир из README: 8–12 долларов за ролик на 30 секунд.
Настольное приложение собирается из исходников на macOS с Bun 1.4.2 и новее. Автономный CLI ставится на macOS, Linux и Windows. Подсказки для моделей уходят сторонним сервисам, а каждая генерация попадает в журнал `generations.jsonl` проекта. Проект молодой: версия в README 0.3.0, поэтому набор команд может меняться.
Как отключить. Удалите CLI тем же менеджером, которым ставили, например `npm uninstall -g @alecs5am/ralphy`. Скилл Ralphy уберите из каталога скиллов агента, ключи удалите из переменных окружения.
Частые вопросы
Как поставить Ralphy?
Выполните `npm install -g @alecs5am/ralphy`. Есть и другие пути: `brew install alecs5am/tap/ralphy` на macOS, скрипт `install.sh` на Linux и macOS, `install.ps1` на Windows. Во всех случаях ставится один и тот же бинарник.
Что делает ralphy setup?
Интерактивный мастер просит два ключа API и ставит скилл в агента. После него команда `ralphy doctor` проверяет окружение: на выходе зеленые отметки для bun, ffmpeg и ключей.
Сколько стоит ролик?
README называет 8–12 долларов за 30 секунд. Точную цену конкретной генерации показывает флаг `--dry-run` до запуска, поэтому лишнего не спишут.
С какими агентами работает Ralphy?
В схеме README указаны Claude Code, Cursor и Codex: они работают по плейбукам и вызывают те же команды `ralphy`. Рабочая папка `.agents/skills` в репозитории содержит десятки скиллов для монтажа, субтитров и арт-дирекшена.
Чем Ralphy отличается от HyperFrames?
HyperFrames — движок композиции из HTML и GSAP, а Ralphy использует его как один из слоев. Поверх него идут шаблоны, маршрутизатор моделей, смета, журнал генераций и проверки качества сцены.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыВидеомонтаж для агентов: openreelio-cli с JSON-выводом и MCP-сервером режет, подписывает, рендерит и проверяет ролик
Одиннадцать скиллов Claude Code делают из клипа с говорящим человеком рилсы: заголовки, графика позади, сплит-экран
Скилл собирает моушн-графику кодом: 21 готовый стиль, пять вопросов, три кадра на утверждение и рендер в MP4.
Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды
CLI для программного создания видео из HTML: агент собирает кадры по шаблонам и рендерит готовый MP4 на вашем компьютере
Набор скиллов, CLI и MCP-сервер, чтобы Claude Code или Codex делали видео по описанию: монтаж, графика, озвучка и субтитры
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Ralphy — CLI для видеороликов и контента с агентом (эта карточка) | нет | 144 | |
| HyperFrames | нет | 83 283 | движок HTML-композиции, без шаблонов, сметы и журнала генераций |
| video-use | нет | 30 994 | скилл для монтажа видео по реплике, без своего CLI и маршрутизатора моделей |
Коротко о README
README сравнивает Ralphy с закрытыми облачными сервисами и сценариями-одиночками по семи признакам: лицензия Apache-2.0, выбор любой модели OpenRouter, смета через `--dry-run`, воспроизводимость, отказ рендера при плохой сцене, исследовательский движок `ralphy research` и композиция в git. Полный список команд лежит в `docs/cli-surface.generated.md`.