gflow-cli – Google Flow(Veo 및 Imagen)용 명령줄 드라이버

개요

• Python 기반 CLI(및 선택적 MCP 서버)로, 터미널에서 Google의 Flow 서비스(Veo 비디오 생성 및 Imagen 텍스트-이미지 변환을 지원하는 UI)를 제어할 수 있습니다.
• Playwright로 실제 Chrome/Chromium 인스턴스를 시작하고 Google 계정에 로그인하여 Flow UI를 자동화합니다. 모든 생성은 Google 서버에서 이루어지며 사용자의 Flow 크레딧 잔액으로 청구됩니다.

주요 기능

기능	사용 방법
배치 생성	셸 루프에서 gflow image t2i "프롬프트" 또는 gflow video t2v "프롬프트"를 사용합니다. CLI는 전송 전에 각 항목을 로컬에 기록하므로 충돌 시 크레딧이 낭비되지 않습니다.
재사용 가능한 캐릭터	gflow character create …는 얼굴+신체 참조를 저장하여 동일한 "인물"이 여러 생성에 나타나도록 합니다.
프롬프트 도구	--tool creative-director는 짧은 프롬프트를 Google 권장 5구성 요소 형식으로 재작성합니다. docs/TOOLS.md를 통해 사용자 정의 도구를 추가할 수 있습니다.
파이프라인 및 스토리지	출력은 기본적으로 $GFLOW_CLI_OUTPUT_DIR에 저장됩니다. GFLOW_CLI_STORAGE_URI로 S3, MinIO 또는 GCS를 지정할 수 있습니다.
에이전트 통합	4개의 진입점(gflow mcp run, gflow serve 등)이 Claude Code, Codex 또는 기타 LLM 기반 도구와 같은 AI 에이전트에 동일한 명령을 노출합니다.
인증 및 세션 처리	gflow auth login --browser chrome은 첫 로그인을 위해 실제 Chrome 창을 엽니다. gflow auth renew는 사용자 상호 작용 없이 영구 Playwright 프로필을 새로 고칩니다.

중요성

• 개발자와 콘텐츠 파이프라인에 웹 UI가 제공하는 것과 동일한 고품질 Veo/Imagen 모델에 대한 프로그래밍 방식 액세스를 제공하며, 비공개 Google SDK가 필요 없습니다(공식 SDK는 아직 대기 중).
• 비용을 투명하게 유지합니다: 비디오 생성만 크레딧을 소비하고 이미지 관련 작업은 무료입니다.
• 재현성을 위해 설계되었습니다. 각 배치 항목은 제출 전에 로컬에 저장되며, 별도의 종료 코드로 UI 드리프트 또는 기타 오류를 나타냅니다.

설치 빠른 시작

uv tool install gflow-cli                     # 권장 설치 프로그램
uv tool run --from gflow-cli playwright install chromium   # 일회성 브라우저 다운로드
gflow auth login --browser chrome            # Chrome을 열고 로그인
gflow image t2i "a hot air balloon over Tokyo" # 첫 생성

(pip install gflow-cli도 사용할 수 있습니다.)

제한 사항

• 헤드형 Chrome 세션에 의존합니다. Google의 봇 방지 검사가 헤드리스 호출을 차단하므로 비디오 생성을 위한 순수 HTTP API는 아직 사용할 수 없습니다.
• 프로젝트는 알파 단계입니다. Google 측의 UI 변경으로 자동화가 중단될 수 있지만 작성자는 빠른 패치를 제공합니다.
• 프록시 또는 지문 스푸핑이 없습니다. 이 도구는 계정 플래그를 피하기 위해 "평범함"을 유지하는 것을 목표로 하지만 보장되지는 않습니다.

문서 및 커뮤니티

• 전체 사용자 가이드, 구성 및 문제 해결 문서는 docs/ 아래에 있습니다(예: docs/USER_GUIDE.md).
• 저장소에는 로드맵, 변경 로그 및 단독 유지 관리자를 지원하는 스폰서 페이지가 포함되어 있습니다.
• 특히 Chrome 자동화 계층을 직접 REST 전송으로 대체할 수 있는 기여를 환영합니다.

결론 gflow-cli는 명령줄에서 Google Flow의 이미지-비디오 및 텍스트-이미지 기능을 자동화하는 진정한 프로덕션 지향 도구로, 배치 처리, 재현 가능한 파이프라인 또는 AI 에이전트 통합이 필요한 개발자를 대상으로 합니다.