gflow-cli
Консольный клиент и MCP-сервер для Google Flow: видео Veo и картинки Imagen из терминала, пакетами и из скриптов агента
- 347 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Утилита управляет браузером с вашей сессией Google, а автоматизация подпадает под условия Google
- Генерация видео списывает кредиты аккаунта, а ошибки интерфейса Flow могут прервать пакет посреди работы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gflow-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Утилита управляет браузером с вашей сессией Google, а автоматизация подпадает под условия Google
- Генерация видео списывает кредиты аккаунта, а ошибки интерфейса Flow могут прервать пакет посреди работы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gflow-cli управляет Google Flow без ручных кликов. Утилита на Python открывает настоящий браузер с вашей сессией Flow и запускает генерацию: видео делает Veo, картинки делает Imagen. Команда `gflow image t2i` создает изображение по тексту. Подкоманды gflow video делают видео из текста, из кадра и из референсов, а `gflow video extend` продолжает готовый клип дальше предела в 8 секунд. Для повторяющихся персонажей есть `gflow character create`: команда заводит в Flow героя с эталоном лица и тела, чтобы человек выглядел одинаково от кадра к кадру. Флаг `--tool creative-director` перед генерацией переписывает короткую подсказку в развернутую по формуле из пяти частей. Пакетный запуск строится на обычном цикле оболочки по файлу с подсказками. Результаты ложатся в папку из GFLOW_CLI_OUTPUT_DIR или уходят в облачное хранилище через GFLOW_CLI_STORAGE_URI. Встроенный MCP-сервер дает те же операции агентам по stdio командой `gflow mcp run` или по HTTP через `gflow serve`. Для Claude Code и Codex есть плагин со скиллами gflow-cli и video-production.
Для кого. Для тех, у кого есть аккаунт Google с доступом к Flow и кредитами Veo и кто гонит видео и картинки пачками или отдает генерацию агенту.
Подходит, если
- Нужна серия картинок по готовому файлу подсказок
- Клип из Flow короче, чем требует сцена
- В нескольких роликах должен повторяться один и тот же человек
- Агенту в Claude Code или Cursor нужно запускать генерацию и забирать результат через MCP-сервер
- Готовые файлы надо сразу складывать в S3, MinIO или Google Cloud Storage
Не подходит, если
- У вас нет аккаунта Google с доступом к Flow: утилита работает только поверх вашей сессии
- Нужен серверный запуск без окна браузера: сейчас генерация идет через видимое окно Chromium
- Вы не хотите автоматизировать свой аккаунт Google: условия Google ограничивают такую автоматизацию
- Нужна стабильность продакшена: интерфейс Flow и конечные точки могут измениться без предупреждения
Пример запроса к агенту
Сгенерируй пять вертикальных картинок по подсказкам из prompts.txt, а потом сделай из лучшей видео на 8 секунд и покажи остаток кредитов.Ограничения
- Проект неофициальный, построен на реверс-инжиниринге и не связан с Google. Стадия разработки — альфа.
- Нужен аккаунт Google с доступом к Flow, каждая генерация видео расходует кредиты этого аккаунта. Картинки и операции монтажа бесплатны.
- Утилита ведет видимый браузер Chromium через Playwright, для первого запуска скачивается около 150 МБ. Первый вызов занимает от 30 до 90 секунд.
- Если интерфейс Flow изменился, команда останавливается с отдельным кодом выхода, например 23 при смене селекторов, и не отправляет задание повторно.
- Обновление ставится командой `gflow update`.
Как отключить. Удалите утилиту командой `uv tool uninstall gflow-cli` и снимите плагин в Claude Code. Сессия Flow хранится в профиле Chromium на вашей машине, удалите этот профиль, если нужно выйти из аккаунта.
Частые вопросы
Как поставить gflow-cli?
Удобнее всего `uv tool install gflow-cli`, подойдет и `pip install gflow-cli`. Затем один раз выполните `uv tool run --from gflow-cli playwright install chromium` и войдите командой `gflow auth login --browser chrome`.
Как подключить gflow-cli к Claude Code?
Выполните `/plugin marketplace add ffroliva/gflow-cli` и `/plugin install gflow@gflow-cli`. Плагин приносит скиллы и MCP-сервер, но ставится выключенным. Для Codex есть команды `codex plugin marketplace add .` и `codex plugin add gflow@gflow-cli`.
Что стоит денег, а что бесплатно?
Кредиты Flow тратятся только на видео Veo. Картинки и операции монтажа бесплатны. Баланс показывает команда `gflow credits user`, она ничего не списывает.
Как запретить агенту тратить кредиты?
Зарегистрируйте сервер командой `gflow mcp run --no-spend`. В этом режиме инструменты, которые расходуют кредиты, не регистрируются вообще.
Чем gflow-cli отличается от официального API Veo?
Официального API здесь нет: утилита управляет интерфейсом Flow через ваш браузер и приватный API Flow. По словам разработчика, чистый HTTP-транспорт для видео пока не работает из-за проверки reCAPTCHA и входа через браузер Chrome.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер, через который агент создает кадры и видео в Google Flow под вашим аккаунтом Google
Набор скиллов, CLI и MCP-сервер, чтобы Claude Code или Codex делали видео по описанию: монтаж, графика, озвучка и субтитры
ClipForge MCP
ClipForge
ClipForge MCP собирает вертикальное видео из темы или ссылки на товар: сток, озвучка Edge TTS и субтитры без ключей, сборка через FFmpeg
Два скилла для генеративного видео и картинок: video пишет промпты для Seedance, Kling и Veo по правилам драматургии, image подбирает модель и синтаксис
Набор скиллов для агентов, чтобы генерировать и редактировать изображения, видео и звук через сервис muapi.ai и muapi-cli
Скилл пишет промпты для генерации видео, картинок и музыки на 14 платформах и по желанию отправляет их в браузере
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| gflow-cli (эта запись) | нет | 347 | ||
| MiniMax MCP | да | API-ключ | 1 594 | официальный MCP MiniMax: озвучка, голоса, генерация картинок и видео |
| ima2-gen | нет | 889 | локальная студия генерации картинок и видео для GPT, Grok, Gemini, NovelAI и ComfyUI | |
| Nano Banana 2 Skill | нет | 416 | консольная утилита и скилл для Claude Code |
Коротко о README
Документация начинается с быстрого старта на 60 секунд и отдельного блока предупреждений об аккаунте и цене ошибок. Для ИИ-агентов описано несколько способов подключения.