Generative media in your terminal.

A single-binary Go CLI and stdio Model Context Protocol (MCP) server for image, video, audio, and chat generation across Gemini, MiniMax, and Google Flow.

Installation

irm https://xibodev.github.io/gflow-cli/install.ps1 | iex

Installs binary to ~/.gflow/bin and adds it to your user PATH automatically.

Terminal Session Output directory: ./output/

$ gflow image "a golden origami butterfly on black velvet"

Generating image via Gemini (Imagen 3)...

Saved: ./output/gemini_20260911_191945.jpg (35.3 KB, JPEG)

$ gflow video "ocean waves crashing against stormy cliffs" -P minimax -d 4

Submitting video to MiniMax H3 [16:9, 4s, 768P]...

Job submitted: Nr7DeLdkPnZx

Rendering video... Done

Saved: ./output/minimax_20260911_201720.mp4 (1.1 MB, MP4)

$ gflow chat "What is the capital of Portugal? One word."

Lisbon

Supported Backends

Select via --provider or GFLOW_PROVIDER.

Provider	Modalities	Underlying Models	Transport	Auth Method
gemini (default)	Image, Video, Audio, Chat	Imagen 3, Veo (w/ audio & cuts), Lyria, Flash	Direct HTTPS / Headless CDP (port 9223)	Local session token (zero popups)
minimax	Video	MiniMax H3 (768P & 2K)	Direct HTTPS	Desktop app token
flow	Image, Video, 4K Upsampling	Imagen 4, Veo 3.1	Direct CDP (port 9222)	Active browser session

Command Reference

Clean, composable subcommands designed for interactive use and shell scripting.

gflow image <prompt>

Generate images via Gemini Imagen 3 (default) or Google Flow Imagen 4.

Flags: -P, --provider [gemini|flow] · -a, --aspect · -o, --output

gflow video <prompt>

Generate video clips via Gemini Veo (default), MiniMax H3, or Google Flow.

Flags: -P, --provider [gemini|minimax|flow] · -d, --duration · -r, --resolution

gflow audio <prompt>

Generate music and audio tracks using Gemini's Lyria / MusicFX pipeline.

Example: gflow audio "upbeat acoustic guitar with light percussion"

gflow chat <prompt>

Direct conversational chat in your terminal with Gemini Flash. Prints plaintext to stdout.

Pipeable: gflow chat "explain JSON" | jq .

gflow status

Inspect connection readiness across Gemini, MiniMax, and Google Flow.

Flags: --json for automated health checks and tooling.

gflow browser

Launches a dedicated Chrome instance on port 9222 for Google Flow.

Enables direct CDP connection without any developer extensions.

Model Context Protocol (MCP)

Connect gflow as a native tool server for Claude Desktop, Cursor, OpenCode, Cline, or Windsurf.

Run gflow mcp setup to automatically configure all installed AI coding assistants (Claude Desktop, OpenCode, Cursor, Claude Code), or run over stdio with gflow mcp.

• generate_flow_image (Imagen 3 / 4)

• generate_flow_video (Async Veo / H3, headless background)

• upsample_flow_video (1080p / 4K)

• get_flow_status (Quota & prescriptive recovery telemetry)

claude_desktop_config.json / mcp.json

{
  "mcpServers": {
    "gflow": {
      "command": "gflow",
      "args": ["mcp"]
    }
  }
}