gflow

Unofficial command-line tool for Google Flow image workflows.

gflow opens your installed Google Chrome with a persistent local profile, uses your Google Flow session, and saves generated images to disk.

Install

npm install -g @toandev95/gflow

Requirements:

• Node.js 22 or newer
• Google Chrome installed
• A Google account with access to Google Flow

Authenticate

Import cookies exported from a Chrome session:

gflow auth import-cookies ./labs.google.json

Verify the saved profile:

gflow auth verify

Generate Images

Text to image:

gflow image t2i "a cinematic product photo of a chrome robot"

Image to image:

gflow image i2i "turn this into a clean studio product render" --ref ./image.png

Useful options:

gflow image t2i "prompt" --model nano2 --aspect 1:1 -n 1 --out ./images

Supported model aliases:

• nano2
• nano-pro
• imagen4

Supported aspect ratios:

• 9:16
• 16:9
• 1:1
• 4:3
• 3:4

Output

By default, generated images are written to ./gflow-output in the directory where you run the command.

You can override the output directory with:

gflow image t2i "prompt" --out ./my-images

or:

GFLOW_OUTPUT_DIR=./my-images gflow image t2i "prompt"

Runtime Data

Browser profile data is stored in the current user's app data directory:

• Windows: %LOCALAPPDATA%/gflow
• macOS: ~/Library/Application Support/gflow
• Linux: $XDG_DATA_HOME/gflow or ~/.local/share/gflow

Set GFLOW_HOME to use a different profile/config location.

Commands

gflow auth import-cookies <cookie-json>
gflow auth verify
gflow image t2i <prompt>
gflow image i2i <prompt> --ref <path...>

Notes

This is an unofficial tool and depends on the Google Flow web experience being available to your account. If Google Flow changes its UI or access rules, generation may require an update.