How baalebos-cloud/video-platform works
This is an AI video creation and monetization platform. Creators authenticate, create a project, submit a video brief, and follow asynchronous generation through script/storyboard planning, per-scene audio and visuals, rendering, and asset delivery; publishing and analytics extend the workflow. The graph reflects the documented capabilities and the sampled pipeline, auth, storage, and rendering code. Several API, task, and provider implementations were not sampled, so uncertain internal wiring is omitted.
Main entry points: pipeline_task.py Generation orchestrator · main.py FastAPI assembly · auth.py Authentication API · client.ts Typed API client
Components 31
Creator experience
- Studio and dashboard
frontend/app/studio/new/page.tsx - Auth state
frontend/hooks/useAuth.ts - Typed API client
frontend/lib/api/client.ts
Platform API
- FastAPI assembly
backend/app/main.py - Authentication API
backend/app/api/v1/auth.py - Video API
backend/app/api/v1/videos.py - Projects API
backend/app/api/v1/projects.py - Jobs API
backend/app/api/v1/jobs.py - JWT security
backend/app/security/auth.py
Video generation
- Generation orchestrator
backend/app/workers/tasks/pipeline_task.py - Plan and script
backend/app/workers/tasks/script_task.py - AI video director
backend/app/ai/director/director.py - Plan validation schema
backend/app/ai/schemas/video_plan.py - Storyboard scenes
backend/app/workers/tasks/storyboard_task.py - Voice generation
backend/app/workers/tasks/voice_task.py - Visual generation
backend/app/workers/tasks/visual_task.py - Render task
backend/app/workers/tasks/render_task.py - FFmpeg composition
backend/app/services/render_service.py - Async worker
backend/app/workers/worker.py - Content persistence
backend/app/services/content_service.py
Persistence and media
- Database sessions
backend/app/db/session.py - Platform records
backend/app/db/models - Media storage service
backend/app/services/storage_service.py - S3-compatible storage
Monetization
- Publishing API
backend/app/api/v1/publishing.py - Publishing task
backend/app/workers/tasks/publish_task.py - Publishing service
backend/app/services/publishing_service.py - Analytics API
backend/app/api/v1/analytics.py - Billing API
backend/app/api/v1/billing.py
Other components
- Creator
- Publishing platforms
Connections 33
- Creator → Studio and dashboard: creates video
- Studio and dashboard → Typed API client: requests API
- Auth state → Typed API client: authenticates via
- Typed API client → FastAPI assembly: sends HTTP
- FastAPI assembly → Authentication API: routes auth
- FastAPI assembly → Video API: routes videos
- FastAPI assembly → Projects API: routes projects
- FastAPI assembly → Jobs API: routes jobs
- Authentication API → JWT security: issues tokens
- Authentication API → Database sessions: queries users
- Video API → Generation orchestrator: queues generation
- Async worker → Generation orchestrator: runs task
- Generation orchestrator → Database sessions: loads and updates
- Generation orchestrator → Plan and script: requests plan
- Plan and script → AI video director: creates plan
- AI video director → Plan validation schema: validates plan
- Generation orchestrator → Storyboard scenes: persists scenes
- Storyboard scenes → Content persistence: persists plan
- Content persistence → Platform records: writes scripts and scenes
- Generation orchestrator → Voice generation: generates narration
- Generation orchestrator → Visual generation: generates scene visuals
- Generation orchestrator → Render task: renders scenes
- Render task → FFmpeg composition: composes video
- Generation orchestrator → Platform records: registers final asset
- Database sessions → Platform records: reads and writes
- Media storage service → S3-compatible storage: uploads and reads media
- FastAPI assembly → Publishing API: routes publishing
- Publishing API → Publishing task: dispatches publish
- Async worker → Publishing task: runs task
- Publishing task → Publishing service: publishes video
- Publishing service → Publishing platforms: uploads video
- FastAPI assembly → Analytics API: routes analytics
- FastAPI assembly → Billing API: routes billing