How saipranav1506/smart-rough-cut works
Smart Rough Cut turns a customer brief and supplied footage into an AI-planned, matched rough cut, then supports editing and export. The API routes orchestrate planning, scene analysis, matching, timeline state, and rendering; the frontend provides processing, editor, and export experiences. The README documents microphone transcription, missing-take handling, and CSV/JSON exports. Some frontend-to-API wiring and unsampled service internals are not shown, so those links are omitted or marked unverified.
Main entry points: routes.py Project API · smart-rough-cut-app.tsx App shell · realtime_shot_finder.py Shot matching · audio_transcriber.py Audio transcription
Components 20
Editor experience
- App shell
frontend/components/smart-rough-cut-app.tsx - Processing view
frontend/app/project/[id]/processing/page.tsx - Editor workspace
frontend/components/editor-workspace.tsx - Export view
frontend/app/project/[id]/export/page.tsx
API and project state
- FastAPI app
backend/app/main.py - Project API
backend/app/api/routes.py - Project and timeline state
backend/app/api/routes.py - Runtime settings
backend/app/core/config.py
Brief and speech
- Shot planner
backend/app/services/shot_planner.py - Audio transcription
backend/app/services/audio_transcriber.py
Footage intelligence
- Media metadata
backend/app/services/media_probe.py - Scene and quality analysis
backend/app/services/scene_detector.py - Shot matching
backend/app/services/realtime_shot_finder.py - Shot finding
backend/app/services/shot_finder.py
Timeline and delivery
- Video renderer
backend/app/services/renderer.py
Other components
- Editor
- NVIDIA NIM
- Speech recognition service
- Video footage
- MP4 and decision lists
Connections 22
- Editor → App shell: uses
README.md - App shell → Processing view: shows processing
- App shell → Editor workspace: opens editor
- App shell → Export view: opens export
- Editor → Audio transcription: speaks brief
README.md - FastAPI app → Project API: mounts routes
backend/app/main.py - Project API → Project and timeline state: reads and updates
backend/app/api/routes.py - Project API → Shot planner: plans shots
backend/app/api/routes.py - Project API → Shot matching: matches shots
backend/app/api/routes.py - Project API → Scene and quality analysis: uses scene cache
backend/app/api/routes.py - Project API → Video renderer: renders timeline
backend/app/api/routes.py - Project API → Audio transcription: transcribes audio
backend/app/api/routes.py - Project API → Media metadata: probes footage
backend/app/api/routes.py - Shot matching → Scene and quality analysis: evaluates scenes
backend/app/services/realtime_shot_finder.py - Shot planner → NVIDIA NIM: requests plan
backend/app/services/shot_planner.py - Audio transcription → Speech recognition service: recognizes speech
backend/app/services/audio_transcriber.py - Scene and quality analysis → Video footage: analyzes frames
README.md - Shot matching → Video footage: selects takes
README.md - Project API → Video footage: accepts uploads
backend/app/api/routes.py - Video renderer → MP4 and decision lists: writes MP4
README.md - Project API → MP4 and decision lists: exports JSON and CSV
README.md - Runtime settings → NVIDIA NIM: configures model
backend/app/core/config.py