How peerapolselanon/flowkit works
FLOW KIT is an AI-video production system driven through a FastAPI agent, Chrome extension bridge, and local dashboard. The principal workflow is: user creates a project and scenes, the worker queues generation, Google Flow produces reference images, scene images, clips and optional upscales, then post-processing adds narration and assembles outputs. Reviews provide Claude-based scene feedback, while SQLite persists state and events refresh the dashboard. Some documented publishing, music, and TTS paths are represented from the tree/README; their detailed implementations were not sampled.
Components 23
Client Applications
- Web Dashboard
dashboard/src/App.tsx - Pipeline View
dashboard/src/components/pipeline/PipelineView.tsx
API Orchestration
- FastAPI Agent
agent/main.py - Project APIs
agent/api/projects.py - Scene APIs
agent/api/scenes.py - Request APIs
agent/api/requests.py - Review APIs
agent/api/reviews.py
Generation Pipeline
- Generation Worker
agent/worker/processor.py - Request Queue
agent/sdk/services/queue.py - Media Operations
agent/sdk/services/operations.py - Flow Client
agent/services/flow_client.py - Result Handler
agent/sdk/services/result_handler.py - Post Processing
agent/services/post_process.py - Narration TTS
agent/services/tts.py - Music Generation
agent/services/suno.py - YouTube Publishing
agent/services
State and Review
- SQLite State
agent/db/schema.py - Event Bus
agent/services/event_bus.py - Video Reviewer
agent/services/video_reviewer.py
External Services
- Chrome Bridge
extension/background.js
Other components
- Producer
- Google Flow
- Claude Vision
Connections 30
- Producer → Web Dashboard: drives
- Web Dashboard → FastAPI Agent: calls API
- Pipeline View → FastAPI Agent: loads state
- FastAPI Agent → Project APIs: dispatches
- FastAPI Agent → Scene APIs: dispatches
- FastAPI Agent → Request APIs: dispatches
- FastAPI Agent → Review APIs: dispatches
- Project APIs → SQLite State: reads/writes
- Scene APIs → SQLite State: reads/writes
- Request APIs → SQLite State: creates requests
- Request APIs → Request Queue: enqueues
- Generation Worker → Request Queue: consumes
- Generation Worker → Media Operations: runs stages
- Media Operations → Flow Client: requests media
- Flow Client → Chrome Bridge: sends RPC
- Chrome Bridge → Google Flow: executes calls
- Google Flow → Chrome Bridge: returns media
- Chrome Bridge → Flow Client: delivers results
- Result Handler → SQLite State: updates results
- Generation Worker → Result Handler: applies results
- Generation Worker → Narration TTS: generates narration
- Generation Worker → Music Generation: generates music
- Generation Worker → Post Processing: assembles output
- Post Processing → YouTube Publishing: publishes video
- Review APIs → Video Reviewer: starts review
- Review APIs → SQLite State: loads scenes
- Video Reviewer → Claude Vision: analyzes frames
- Video Reviewer → SQLite State: stores review
- FastAPI Agent → Event Bus: publishes events
- Event Bus → Web Dashboard: pushes updates