How acm-projects/cascade works
Cascade is a video-to-clips product with project management, AI research, a nondestructive editor, and export/publishing features. The main workflow is upload and describe a video, generate searchable clips, refine them in the editor, then export or publish. AI Studio supports creating and revising generations from project media; video search and trends research are additional capabilities. The React app is the current interface, with FastAPI services behind it. The map uses README workflow statements and sampled source references; unsampled feature internals and some frontend-to-API wiring are not asserted.
Main entry points: App.jsx Application routes · clips.py Upload and generation routes · routes.py Editor routes · website.py Clip selection agent
Components 24
React application
- Application routes
frontend/src/App.jsx - AI Studio
frontend/src/pages/StudioPage.jsx - Editor
frontend/src/pages/EditorPage.jsx - Export
frontend/src/pages/ExportPage.jsx - Projects
frontend/src/pages/ProjectsPage.jsx
Clip generation
- Upload and generation routes
backend/routers/clips.py - Jobs and progress
backend/core/jobs.py - Clip selection agent
backend/agent/website.py - Speech transcription
backend/cascade_stt/transcribe.py - Media storage
backend/core/storage.py
Research and discovery
- Search and clip matching
backend/video_search/router.py - Research agent
backend/agent/research.py - Trend analysis
backend/trends/pipeline.py - Studio sessions
backend/studio.py
Editing and rendering
- Editor routes
backend/editor/routes.py - Timeline rendering
backend/editor/render.py - Editor media access
backend/editor/media_routes.py - B-roll assets
backend/broll.py
Projects and delivery
- Project records
backend/services/projects_store.py - Social publishing
backend/publishing_providers.py
Other components
- Creator
- Deepgram
- AI provider
- S3 storage
Connections 24
- Creator → Application routes: uses
README.md - Application routes → Projects: routes to
frontend/src/App.jsx - Application routes → AI Studio: routes to
frontend/src/App.jsx - Application routes → Editor: routes to
frontend/src/App.jsx - Application routes → Export: routes to
frontend/src/App.jsx - Creator → Upload and generation routes: uploads video
README.md - Upload and generation routes → Jobs and progress: tracks job
backend/routers/clips.py - Upload and generation routes → Clip selection agent: selects clips
backend/routers/clips.py - Clip selection agent → Speech transcription: transcribes media
- Upload and generation routes → Media storage: stores media
backend/routers/clips.py - Speech transcription → Deepgram: transcribes with
README.md - Clip selection agent → AI provider: uses configurable AI
README.md - Media storage → S3 storage: uploads media
backend/core/storage.py - Creator → Search and clip matching: searches video
README.md - Creator → AI Studio: creates generations
README.md - AI Studio → Studio sessions: uses sessions
- Creator → Research agent: requests research
README.md - Creator → Trend analysis: explores trends
README.md - Editor → Editor routes: edits clips
README.md - Editor routes → Timeline rendering: renders edits
backend/editor/routes.py - Editor routes → Editor media access: serves media
backend/editor/routes.py - Editor routes → B-roll assets: uses B-roll
- Projects → Project records: manages projects
README.md - Export → Social publishing: publishes clips
README.md