⚡ Flow Agent v1.0.0 — First Stable Release

⚡ Flow Agent v1.0.0

Generate AI images and videos from Google Flow — via CLI, REST API, or your AI assistant.

---

🆕 What's in this release

🖼️ Image Generation

• Text-to-image with 3 models: narwhal, harbor_seal, gem_pix_2
• Aspect ratios: 1:1 16:9 9:16 4:3 3:4 square landscape portrait
• Up to 4 variations per generation
• Multi-account support (pool credits across Google accounts)

🎬 Video Generation

• Text-to-video: 4s 6s 8s 10s clips at 360p / 720p
• Image-to-video animation (animate any photo)
• Video upload to Flow project storage (with content-hash cache)

🌐 REST API Server

• Native endpoints: POST /api/v1/image, POST /api/v1/video, GET /api/v1/balance, etc.
• OpenAI-compatible: POST /v1/images/generations, POST /v1/chat/completions (+ SSE)
• Route aliases: every /api/v1/* also reachable via /v1/*
• Interactive docs at http://127.0.0.1:8001/docs

🤖 MCP Server

• 5 tools: flow_generate_image, flow_generate_video, flow_get_balance, flow_get_stats, flow_get_projects
• Works with Claude Desktop, Cursor, AGY, and any MCP-compatible client
• Stdio and SSE transport support

🔧 Engine Binaries (Cross-platform)

Platform	Binary
macOS (Apple Silicon + Intel)	bin/flow-macos
Linux	bin/flow-linux
Windows	bin/flow-windows.exe

Auto-detected by platform — no config needed.

📊 Data & History

• SQLite-backed generation history (data/flow.db)
• Credit tracking per account
• stats, balance, projects commands

---

🚀 Quick Start

# 1. Install
pip install -e '.[test]'

# 2. Check your setup
./bin/flow doctor

# 3. Generate an image
python main.py image "a glowing crystal lotus on calm water" --aspect 16:9

# 4. Or start the API server
python main.py server --port 8001

---

✅ Quality

• 77 tests passing (CLI, REST API, MCP, SQLite, engine)
• Full input validation — invalid args rejected with clear errors
• All 5 reported defects (D1–D5) resolved

---

📚 Documentation

• 📘 API Reference
• ⌨️ CLI Reference
• 🤖 MCP Guide
• 🏗️ Architecture