How alexandru-sacasanu/creatorsplan works
CreatorsPlan is an AI video platform with three creator-facing tools: long-video clip generation, AI-generated UGC shorts, and YouTube packaging. The main workflow runs from dashboard submission through the Python job coordinator into media analysis and clip rendering, then returns results to the dashboard. Separate branches cover UGC production, YouTube assets, and optional cloud accounts, billing, and durable storage. README documents several domain stages whose internal calls were not sampled; those branches are shown without speculative implementation links.
Main entry points: main.py Clip Pipeline · app.py Job Coordinator · App.jsx Creator Dashboard · AuthContext.jsx Auth Session
Components 27
Dashboard
- Creator Dashboard
dashboard/src/App.jsx - Auth Session
dashboard/src/contexts/AuthContext.jsx - Auth Intent
dashboard/src/lib/authIntent.js - API Client
dashboard/src/lib/api.js
Clip Generator
- Job Coordinator
app.py - Clip Pipeline
main.py - Moment Selection
clip_selection.py - Gemini Analysis
gemini_worker.py - LLM Backend
llm_backend.py - Transcription
transcribe_backends.py - Scene Detection
scene_detection.py - Smart Reframing
reframe_v2.py - Subtitles
subtitles.py - Hook Overlays
hooks.py - FFmpeg Media
ffmpeg_utils.py
AI Shorts
- UGC Generation
saasshorts.py
YouTube Studio
- YouTube Studio UI
dashboard/src/components/ThumbnailStudio.jsx - Thumbnail Generator
thumbnail.py - YouTube Clients
yt_clients.py
Cloud Platform
- Cloud Auth
cloud/auth.py - Usage Metering
cloud/metering.py - Account Records
cloud/models.py - Cloud Database
cloud/database.py - Video Storage
cloud/storage.py
Other components
- Creator
- S3-Compatible Storage
- AI Media Services
Connections 29
- Creator → Creator Dashboard: uses
- Creator Dashboard → API Client: submits jobs
dashboard/src/App.jsx - Creator Dashboard → Job Coordinator: requests processing
dashboard/src/App.jsx - Job Coordinator → Clip Pipeline: launches job
app.py - Clip Pipeline → Moment Selection: selects moments
main.py - Moment Selection → Gemini Analysis: scores moments
gemini_worker.py - Gemini Analysis → Moment Selection: uses selection logic
gemini_worker.py - LLM Backend → Gemini Analysis: provides backend
llm_backend.py - Clip Pipeline → Transcription: transcribes audio
main.py - Clip Pipeline → Scene Detection: detects scenes
main.py - Clip Pipeline → Smart Reframing: reframes clips
main.py - Clip Pipeline → Subtitles: adds subtitles
main.py - Clip Pipeline → Hook Overlays: adds hooks
main.py - Hook Overlays → FFmpeg Media: renders overlays
hooks.py - Creator → UGC Generation: describes product
- UGC Generation → AI Media Services: generates actors and video
- Creator → YouTube Studio UI: creates YouTube assets
- YouTube Studio UI → Thumbnail Generator: generates thumbnails
- YouTube Studio UI → YouTube Clients: uses YouTube tooling
- Creator Dashboard → Auth Session: uses session
dashboard/src/main.jsx - Auth Session → API Client: calls API
dashboard/src/contexts/AuthContext.jsx - Auth Session → Auth Intent: stores auth intent
dashboard/src/contexts/AuthContext.jsx - Job Coordinator → Cloud Auth: loads cloud auth
app.py - Job Coordinator → Usage Metering: uses metering
app.py - Cloud Auth → Cloud Database: opens sessions
cloud/auth.py - Cloud Auth → Usage Metering: loads entitlements
cloud/auth.py - Cloud Database → Account Records: registers tables
cloud/database.py - Job Coordinator → Video Storage: stores durable videos
app.py - Video Storage → S3-Compatible Storage: uploads and retrieves
cloud/storage.py