How bouchta65/navi-pilot works
NAVI is a command-center application for configuring, generating, rendering, and publishing short-form videos. The principal workflow starts with an operator using the React Operations screen to create a project; the backend runs its Master Video Plan workflow through queued jobs, produces narration and timed captions, assembles the video, and can upload it to YouTube. Configuration, analytics, authentication, and project progress via WebSocket are additional product capabilities. Several workflow implementations are unsampled, so their documented connections are identified as such rather than inferred from filenames.
Main entry points: master_stages.py Master plan stages · LiveDashboard.tsx Operations console · client.ts API client · video_assembler.py Video assembly
Components 23
Operator interface
- Operations console
frontend/src/pages/LiveDashboard.tsx - Statistics view
frontend/src/pages/Statistics.tsx - API client
frontend/src/api/client.ts
API and configuration
- Project API
backend/app/api/projects.py - Configuration API
backend/app/api/configuration.py - Analytics API
backend/app/api/analytics.py - Session security
backend/app/core/security.py - Configuration service
backend/app/services/configuration.py - PostgreSQL records
backend/app/core/database.py - Project progress socket
frontend/src/services/projectSocket.ts
Video job pipeline
- Project worker
backend/app/workers/project_tasks.py - Master workflow stages
backend/app/workers/workflow.py - Master plan stages
backend/app/workers/master_stages.py - AI planning
backend/app/services/gemini - Research
backend/app/services/research - Narration and timing
backend/app/services/audio/tts_service.py - Caption rendering
backend/app/services/video/caption_engine/professional/engine.py - Subtitle timing
backend/app/services/video/subtitle_service.py - Video assembly
backend/app/services/video/video_assembler.py
Media and publishing
- Media matching
backend/app/services/media - Media storage
backend/app/services/storage.py - YouTube publishing
backend/app/services/youtube/upload_service.py
Other components
- Operator
Connections 23
- Operator → Operations console: uses
README.md - Operations console → API client: calls API
frontend/src/pages/LiveDashboard.tsx - API client → Project API: sends requests
README.md - Project API → Project worker: queues jobs
README.md - Project worker → Master workflow stages: runs workflow
backend/app/workers/project_tasks.py - Master workflow stages → Master plan stages: dispatches stages
- Operator → Configuration API: sets configuration
README.md - Configuration API → Configuration service: loads and saves
- Configuration service → PostgreSQL records: persists settings
backend/app/services/configuration.py - API client → Session security: authenticates
- Master plan stages → AI planning: requests AI planning
- Master plan stages → Research: gathers sources
- Master plan stages → Narration and timing: synthesizes narration
- Narration and timing → Subtitle timing: provides alignment
backend/app/services/video/subtitle_service.py - Subtitle timing → Caption rendering: supplies timed cues
- Master plan stages → Media matching: matches footage
- Master plan stages → Video assembly: assembles render
- Video assembly → Caption rendering: composites captions
- Video assembly → Media storage: stores output
- Master plan stages → YouTube publishing: publishes video
README.md - Operations console → Project progress socket: tracks progress
frontend/src/pages/LiveDashboard.tsx - Operator → Statistics view: views metrics
README.md - Statistics view → Analytics API: requests analytics