How akash4406pal/gitvideo works
GitVideo is an AI codebase-to-video product with a web studio and a backend generation engine. The main workflow accepts a repository, ingests and analyzes it into a verified skeleton, generates a storyboard and architecture blueprint, synthesizes narration, and renders a walkthrough video. The graph also preserves the documented storyboard-review, export, authentication, quota, blueprint, and repository-chat capabilities. Backend flow is supported by the CLI entrypoint; frontend-to-backend API relationships are limited to the shown pipeline request and documented capabilities.
Main entry points: index.ts Generation orchestrator · usePipeline.ts Pipeline controller · 4_components Review & explore · StudioClientApp.tsx Studio application
Components 25
Web Studio
- Studio application
frontend/src/app/StudioClientApp.tsx - Pipeline controller
frontend/src/3_hooks/usePipeline.ts - Review & explore
frontend/src/4_components - Pipeline data model
frontend/src/1_domain/pipeline.ts
Studio API
- Pipeline run API
frontend/src/app/api/pipeline/run/route.ts - Job status API
frontend/src/app/api/pipeline/status/route.ts - Blueprint API
frontend/src/app/api/repo/blueprint/route.ts - Repository chat API
frontend/src/app/api/repo/chat/route.ts - Auth & quota
frontend/src/5_shared/security/quotaService.ts
Ingestion & Analysis
- Generation orchestrator
backend/src/index.ts - Repository ingestion
backend/src/ingest/cloner.ts - Skeleton analysis
backend/src/analyzer/skeletonBuilder.ts - Filters & extraction
backend/src/analyzer - Verified skeleton
backend/src/types/skeleton.ts
Narrative Generation
- Storyboard generation
backend/src/storyboard/storyboardGenerator.ts - Prompt & validation
backend/src/storyboard - Storyboard schema
backend/src/types/storyboard.ts - BharatCode model
- Architecture blueprint
backend/src/analyzer/architectureDoc.ts
Audio & Video
- Narration synthesis
backend/src/tts/audioSynthesizer.ts - Edge TTS client
backend/src/tts/edgeTtsClient.ts - Remotion renderer
backend/src/remotion/renderVideo.ts - Video scenes
backend/src/remotion - Walkthrough MP4
Other components
- Repository contributor
Connections 24
- Repository contributor → Studio application: opens studio
README.md - Studio application → Pipeline controller: uses controller
frontend/src/app/StudioClientApp.tsx - Studio application → Review & explore: renders features
frontend/src/app/StudioClientApp.tsx - Pipeline controller → Pipeline data model: uses types
frontend/src/3_hooks/usePipeline.ts - Pipeline controller → Pipeline run API: posts job
frontend/src/3_hooks/usePipeline.ts - Pipeline controller → Job status API: polls status
- Review & explore → Blueprint API: requests blueprint
- Review & explore → Repository chat API: requests answers
- Review & explore → Auth & quota: uses account controls
- Repository contributor → Pipeline run API: submits repository
- Pipeline run API → Generation orchestrator: starts generation
- Generation orchestrator → Repository ingestion: ingests source
backend/src/index.ts - Generation orchestrator → Skeleton analysis: builds skeleton
backend/src/index.ts - Skeleton analysis → Filters & extraction: filters and extracts
backend/src/analyzer/skeletonBuilder.ts - Skeleton analysis → Repository ingestion: reads repository metadata
backend/src/analyzer/skeletonBuilder.ts - Generation orchestrator → Storyboard generation: generates script
backend/src/index.ts - Storyboard generation → BharatCode model: requests completion
- Storyboard generation → Prompt & validation: uses prompt and checks
backend/src/storyboard/storyboardGenerator.ts - Generation orchestrator → Architecture blueprint: writes blueprint
backend/src/index.ts - Generation orchestrator → Narration synthesis: synthesizes narration
backend/src/index.ts - Narration synthesis → Edge TTS client: synthesizes speech
backend/src/tts/audioSynthesizer.ts - Generation orchestrator → Remotion renderer: renders walkthrough
backend/src/index.ts - Remotion renderer → Video scenes: renders scenes
- Remotion renderer → Walkthrough MP4: produces MP4
backend/src/remotion/renderVideo.ts