gflow-cli
Integrates with Google Flow to generate and edit images with Imagen and Nano Banana, generate and extend videos with Veo and Omni Flash, manage Flow projects and characters, check credits, and run image or video batches through a signed-in Google account.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
gflow-studio
Tiếng Việt · English
Tạo ảnh và video bằng Google Flow ngay trong terminal. gflow-studio điều khiển Imagen, Nano Banana (ảnh) và Veo, Omni Flash (video) qua chính tài khoản Flow của bạn. Cả một storyboard chạy bằng một lệnh, thay cho một buổi chiều ngồi bấm chuột.
gflow-studio do ABM.DũngTQ xây dựng và phát triển cho dây chuyền làm phim hoạt hình: tải video 1080p, chạy Chrome ẩn trên macOS, lô ảnh tự dừng khi Google chặn, và lệnh chạy lô video. Lệnh là gflow. Danh sách đầy đủ ở mục Điểm nổi bật.
Công dụng · Điểm nổi bật · Cài đặt · Cách dùng · Chạy lô · Ẩn trình duyệt · Demo · Khi có lỗi · Tài liệu · Tác giả
⚠️ Đọc trước khi cài. gflow-studio không liên quan đến Google. Công cụ này dò ngược cách Flow hoạt động và điều khiển một cửa sổ Chrome thật đã đăng nhập tài khoản Google của bạn, nên mọi thao tác tự động diễn ra trên tài khoản đó và chịu điều khoản của Google. Flow có thể đổi giao diện bất cứ lúc nào. Tạo ảnh không tốn credit; tạo video Veo trừ credit Flow của bạn. Hãy đọc DISCLAIMER và docs/ACCOUNT_SAFETY.md.
Công dụng
Bạn muốn… | Lệnh |
Tạo ảnh từ câu mô tả |
|
Sửa hoặc ghép ảnh |
|
Tạo video từ câu mô tả |
|
Làm ảnh tĩnh chuyển động |
|
Tạo video từ ảnh tham chiếu |
|
Lấy clip 1080p | thêm |
Chạy cả storyboard ảnh |
|
Chạy nhiều clip ảnh-thành-video trong một phiên |
|
Giữ một nhân vật nhất quán qua nhiều cảnh |
|
Nối dài clip quá 8 giây |
|
Xem số credit Veo |
|
Cho AI agent dùng Flow |
|
Kiểm tra máy đã cài đúng chưa |
|
Lệnh nào cũng nhận --profile để chọn tài khoản Google và --project để làm việc trong một project Flow có sẵn. Phần lớn lệnh có --json để dùng trong script. gflow docs in tài liệu đi kèm, không cần mạng.
Prompt nên viết bằng tiếng Anh: các mô hình của Flow hiểu tiếng Anh ổn định nhất.
Related MCP server: google-flow-mcp
Điểm nổi bật
--upscale: giữ bản 1080p. Tải video xong, gflow lấy bản xuất 1080p của Flow (không tốn thêm credit) và ghi đè lên file 720p ở đúng đường dẫn đó. Nếu xuất 1080p lỗi, file 720p vẫn được giữ và lệnh in ra câu lệnh để thử lại. Có ởvideo t2v,i2v,r2v,video batchvà tool MCPgflow_generate_video(upscale=True).gflow video batch. Chạy 1–50 dòng ảnh-thành-video từ một file JSON trong cùng một phiên trình duyệt và một project Flow, có--resume,--jittervà--json. Clip nào đã tạo xong, đã bị trừ credit nhưng tải về lỗi thì được tải lại miễn phí chứ không mất.Chrome chạy ẩn trên macOS.
GFLOW_CLI_WINDOW_MODE=backgroundchạy Chrome như một ứng dụng nền: không hiện biểu tượng trên Dock, không giành bàn phím khi bạn đang làm việc.Lô dừng ngay khi Google chặn.
gflow run,image batchvàimage t2inhiều prompt sẽ dừng ở lần đầu gặp WAF 403, bị giới hạn tốc độ hoặc phiên đăng nhập hết hạn, kể cả khi có--continue-on-error, và thoát với mã lỗi của chính lỗi đó. Tài khoản đã bị để ý sẽ không phải nhận tiếp phần còn lại của lô.Đặt tên cho ảnh tham chiếu trong
gflow run. Khai báo{"name": "cuong", "path": "cuong.png"}rồi viết@cuongtrong prompt. Mỗi dòng nhận được nhiều ảnh tham chiếu (refs) và có đường dẫnoutputriêng.Tự gia hạn phiên đăng nhập. Nếu phiên Google hết hạn khi chưa gửi gì, gflow gia hạn một lần rồi chạy lại. Đã gửi lệnh tạo rồi thì không bao giờ gửi lại. Tắt bằng
GFLOW_CLI_AUTO_RENEW=false.Sửa lỗi.
-otrỏ sang ổ đĩa khác không còn lỗi sau khi tạo xong. Lô ảnh dài tự tải lại ảnh tham chiếu đã trôi khỏi project. Tab Chrome chỉ được đưa lên trước khi nó thực sự bị ẩn.
Chi tiết ở CHANGELOG.md mục Unreleased. Số đo về chế độ không cửa sổ (headless) nằm ở docs/superpowers/spikes/2026-10-28-headless-generation.md.
Cài đặt
Cần có
Một tài khoản Google dùng được Google Flow. Muốn tạo video thì tài khoản cần có credit Flow.
Google Chrome cài theo cách thông thường.
uv; uv tự cài Python 3.11 trở lên.
macOS, Windows hoặc Linux có giao diện đồ hoạ. Lần đăng nhập đầu tiên cần Chrome mở được cửa sổ.
1. Cài
uv tool install "git+https://github.com/abm-dungtq/gflow-studio.git@main"
uvx --from "git+https://github.com/abm-dungtq/gflow-studio.git@main" playwright install chromium
gflow --versionMuốn nâng cấp, chạy lại đúng lệnh uv tool install ở trên và thêm --force.
2. Đăng nhập một lần
gflow auth login --browser chrome --profile mainMột cửa sổ Chrome sẽ mở ra. Đăng nhập Google và chờ đến khi thấy màn hình làm việc của Flow; gflow lưu phiên đăng nhập vào thư mục profile riêng của nó. Phải có --browser chrome, vì về sau mỗi lần tạo ảnh hay video, gflow mở lại profile này bằng Chrome thật. Mỗi tài khoản Google dùng một tên --profile khác nhau.
3. Kiểm tra
gflow auth status
gflow credits user --profile main
gflow doctorBa lệnh này không tốn credit. gflow doctor thoát với mã 33 khi thấy chỗ cần sửa và nói rõ phải sửa gì.
4. Cấu hình thêm (tuỳ chọn)
Chép .env.template thành .env trong thư mục bạn chạy gflow, hoặc vào thư mục gốc của gflow để áp dụng cho cả máy. Các thiết lập hay dùng:
Thiết lập | Tác dụng |
| macOS: chạy Chrome ẩn, không giành bàn phím |
| Nơi lưu file khi không truyền |
| Project Flow mặc định, để mỗi lần chạy không sinh project mới |
| Khoảng nghỉ giữa các lần gửi trong lô; nới rộng ra nếu gặp WAF 403 |
| Chờ khi profile đang bị một lệnh gflow khác dùng, thay vì báo lỗi |
Mọi thiết lập được giải thích trong docs/CONFIGURATION.md. gflow chỉ đọc file .env; file .env.local bị bỏ qua.
Cách dùng
Ảnh (miễn phí)
gflow image t2i "a hot air balloon over Tokyo at sunrise" --aspect 16:9 -o out/balloon.png
gflow image t2i "a cat mom, flat 2D" --model nano2 -n 4 --out out/cats/
gflow image i2i "the same cockroach, now sitting on a keyboard" --ref refs/cuong.png -o out/k1.pngMô hình: nano2 (Nano Banana 2.1, mặc định), nano2-lite, nano-pro, imagen4. Tỉ lệ khung: 16:9, 4:3, 1:1, 3:4, 9:16. -n tạo 1–4 biến thể.
Video (tốn credit)
gflow video t2v "slow cinematic push-in on a sunlit forest clearing" --aspect 16:9 -o out/forest.mp4
gflow video i2v "the paper lantern sways gently, slow push in" \
--initial-frame out/lantern.jpg --model veo-lite --aspect 16:9 --upscale -o out/lantern.mp4
gflow video upscale <media_id> --scale 1080p # lấy 1080p cho clip đã làm trước đóMô hình: omni-flash, veo-lite, veo-fast, veo-quality. --duration nhận 4, 6 hoặc 8 giây; 10 giây chỉ có ở Omni Flash. --end-frame đặt khung hình cuối cho i2v. Nếu không truyền --aspect, video mặc định là dọc 9:16.
Project, nhân vật và kho dữ liệu
gflow project list --profile main # các project gflow đã ghi lại
gflow character create --project <id> --name "Aria" --face-prompt "..." --body-prompt "..."
gflow data --help # tra cứu mọi thứ bạn đã tạoDành cho AI agent (MCP)
gflow mcp setup # đăng ký server stdio với agent của bạn
gflow mcp run --no-spend # server không có các tool tạo ảnh, videoCLI và server MCP có cùng một bộ tính năng. docs/MCP.md liệt kê đủ các tool.
Chạy lô
Storyboard ảnh: gflow run
storyboard.json:
{
"prompts": [
{"text": "@cuong stands on a desk at night, flat 2D", "aspect_ratio": "16:9",
"refs": [{"name": "cuong", "path": "refs/cuong.png"}], "output": "gen/k1.jpg"},
{"text": "@cuong jumps onto the keyboard", "aspect_ratio": "16:9",
"refs": [{"name": "cuong", "path": "refs/cuong.png"}], "output": "gen/k2.jpg"}
]
}gflow run --config storyboard.json --profile main --project <id>
gflow run --config storyboard.json --profile main --project <id> --resumeMỗi file ảnh tham chiếu chỉ tải lên một lần cho cả lượt chạy. --resume bỏ qua những dòng đã có file đầu ra, nên chạy lại sau khi lỗi chỉ tạo phần còn thiếu. Dòng nào đã sửa prompt, thông số hay ảnh tham chiếu thì được tạo lại, vì gflow ghi đầu vào của mỗi file vào một file ẩn .<tên>.gflow.json bên cạnh. Muốn làm lại một ảnh thì dùng --redo k3 thay cho việc tự xoá file.
Nhiều clip ảnh-thành-video trong một phiên: gflow video batch
videos.json:
{
"project": "<existing-flow-project-id>",
"videos": [
{"start": "gen/k1.jpg", "prompt": "the cockroach looks around, slow push in",
"model": "omni-flash", "duration": 4, "aspect": "16:9", "output": "clips/v1.mp4"},
{"start": "gen/k2.jpg", "prompt_file": "prompts/v2.txt",
"model": "omni-flash", "duration": 6, "aspect": "16:9", "output": "clips/v2.mp4"}
]
}gflow video batch --config videos.json --profile main --upscale --jsonDòng nào đã gửi thì không bao giờ gửi lại, vì clip Flow đã nhận có thể đã bị trừ credit. Nếu một dòng lỗi, chạy lại với --resume. Clip có prompt hay khung đầu đã đổi sẽ được tạo lại; --redo v3 ép làm lại một clip.
Có hai profile đăng nhập cùng một tài khoản Google thì chạy song song bằng --profiles meo-muop,meo-muop-2 --project <id>. gflow chia đều các dòng còn thiếu cho hai profile, mỗi profile một trình duyệt, khởi động cách nhau 25 giây, và in ra dòng nào chạy ở profile nào. Một profile gặp WAF hay hết phiên thì cả lô dừng sau dòng đang làm. gflow run cũng nhận --profiles.
Ẩn trình duyệt
Google chỉ phục vụ Flow cho trình duyệt thật, nên gflow phải điều khiển một cửa sổ Chrome thật. Bạn nhìn thấy nó nhiều hay ít tuỳ hệ điều hành:
Hệ điều hành | Thiết lập | Kết quả |
macOS |
| Ẩn hoàn toàn, không có biểu tượng trên Dock, không bao giờ giành bàn phím. Nên dùng. |
macOS, Windows, Linux |
| Cửa sổ được thu nhỏ ngay sau khi mở, kể cả khi máy có nhiều màn hình, nhưng Chrome giành bàn phím lúc khởi động. |
mọi hệ |
| Không có cửa sổ nào. Đang thử nghiệm, xem bên dưới. |
mọi hệ |
| Cửa sổ hiện bình thường, tiện khi muốn xem gflow làm gì. |
Trên một tài khoản thử (macOS, 28/10/2026), Chrome thật chạy headless tạo ảnh thành công 6/6 lần, không gặp 403 hay lỗi reCAPTCHA. Chrome headless vốn tự ghi HeadlessChrome trong user agent; gflow giờ thay chuỗi đó bằng user agent của Chrome thường, nên trang Flow không thấy dấu headless nào ở user agent. Lần thử ngày 30/10/2026 tạo ảnh bình thường, không mở cửa sổ và không giành bàn phím. Ngoài ra chưa ai đo với video, trên Windows hay về lâu dài với tài khoản. Vì thế mặc định vẫn là Chrome có cửa sổ. Muốn dùng headless, hãy thử trên tài khoản phụ trước. Nếu Chrome vẫn hiện hoặc giành bàn phím, kể cả trên Windows, cách tìm nguyên nhân và sửa nằm ở docs/HIDDEN_BROWSER.md.
Demo

Một lượt gflow run thật gồm hai dòng, trên tài khoản thử (29/10/2026, khoảng một phút, không tốn credit):
$ gflow run --config run.json --profile thu-headless --project <project-id> --output-dir tmp/f7/out
project: <project-id> (existing)
gflow run
┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ # ┃ prompt ┃ ratio ┃ status ┃ detail ┃
┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 0 │ a small red paper lantern │ 16:9 │ OK │ tmp/f7/out/prompt_0_0.jpg │
│ │ on a wooden table, soft │ │ │ │
│ │ light │ │ │ │
│ 1 │ a green ceramic teapot on a │ 16:9 │ OK │ tmp/f7/out/prompt_1_0.jpg │
│ │ windowsill, morning light │ │ │ │
└───┴─────────────────────────────┴───────┴────────┴───────────────────────────┘
2/2 succeeded · 0 failure(s) · 0 skippedSau đó ảnh đèn lồng đầu tiên được làm thành video bằng gflow video i2v --model veo-lite --upscale trên cùng tài khoản. Kết quả là một clip 4 giây, độ phân giải 1920×1080; kết quả JSON có "upscaled": "1080p".

Khi có lỗi
Khi lỗi, gflow dừng hẳn và trả về một mã thoát cố định chứ không tự gửi lại, để lượt chạy hỏng không âm thầm tiêu credit.
Mã thoát | Ý nghĩa | Nên làm gì |
3 / 8 | Phiên đăng nhập hết hạn hoặc chưa có |
|
4 | Bị giới hạn tốc độ | Chờ một lúc, rồi nới |
5 | Bị chính sách nội dung từ chối | Viết lại prompt đó; lô vẫn chạy tiếp các dòng khác |
10 | WAF 403: Google chặn yêu cầu | Dừng lại và chờ. Đừng chạy lại liên tục trên tài khoản này |
11 | Sai cấu hình, hoặc profile đang bận | Đọc thông báo; nó ghi rõ trường nào sai hoặc ai đang giữ khoá |
23 | Flow đã đổi giao diện | Chạy |
37 | Không đủ credit Veo | Nạp thêm, hoặc dùng mô hình rẻ hơn |
Mọi lỗi được in theo chuẩn RFC 9457 (problem details) kèm gợi ý cách xử lý. KNOWN_ISSUES.md liệt kê các lỗi hiện có và cách né.
Tài liệu
Tài liệu chi tiết hiện chỉ có bằng tiếng Anh.
Chủ đề | Đọc |
Bắt đầu | |
Tài khoản | |
Sản xuất | Nhân vật · Kịch bản nhiều cảnh · Công cụ viết prompt · Cách tham chiếu ảnh |
Agent | |
Bên trong |
docs/INDEX.md là mục lục của toàn bộ tài liệu.
Tác giả
gflow-studio: ABM.DũngTQ · 0976202028 · github.com/abm-dungtq/gflow-studio
Giấy phép: MIT. Giấy phép chỉ áp dụng cho mã nguồn. Flow và mọi thứ bạn tạo bằng Flow chịu điều khoản của Google. Xem DISCLAIMER.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Google Flow's agent: chat that plans and makes images and videos, approvals, your own media
Build and run visual creative-production workflows from your AI agent.
Generate images, video, audio and 3D with FlowNode; results land in your asset library.
Generate and edit images, video, voice, lip-sync and 3D models from your AI agent.
Related MCP Servers
- FlicenseAqualityDmaintenanceControls Google Flow for image and video generation from an AI agent. Enables generating images with models like Imagen 4, creating videos, managing characters and scenes via browser automation.17130-
- AlicenseNot gradedqualityBmaintenanceEnables an AI agent to drive Google Flow through a real logged-in browser session: read projects, media, characters, scenes and credits, create and delete them, upload media, generate Veo video and Nano Banana images, and assemble scenes into a film. Every paid action is priced in its tool description and written to a spend ledger before the click, with a job-id guard against double charges.3MIT
- AlicenseBqualityBmaintenanceEnables users to generate images and videos on Google Flow through browser automation of an already signed-in Chrome session, downloading the finished media to disk without any API keys. It drives Flow's agent with a range of image and video models, plus reference images, first/last frames, and ingredient-based video jobs, while reusing the user's own Google AI Pro credits.17MIT
- AlicenseAqualityBmaintenanceLets an AI agent drive Google Flow (flow.google.com) through a locally logged-in Chrome profile to generate images, videos, characters, and scenes. Uses browser automation via the Chrome DevTools Protocol, so Google credentials are never shared with the agent.2110 npmMIT