How wanglevy9/vidforge works
VidForge is a self-hostable, knowledge-grounded video production workspace. A user enters through the React studio, manages product spaces and materials, then submits a request that the backend runs through material analysis, script planning, video composition, and quality review; quality feedback can trigger bounded replanning. The README also documents human review, checkpoints, media services, analytics/tracing, templates, exports, and task control. Several links reflect the documented architecture rather than inspected implementation; unsampled subsystem details are not inferred.
Main entry points: app.module.ts NestJS API · orchestrator.service.ts LangGraph runtime · script-agent.service.ts Script agent · App.tsx React studio
Components 25
Workspace
- React studio
apps/frontend/src/App.tsx - Authentication
apps/backend/src/modules/auth/auth.service.ts - NestJS API
apps/backend/src/app.module.ts
Knowledge
- Product spaces
apps/backend/src/modules/product-space/product-space.service.ts - Material library
apps/backend/src/modules/material/material.service.ts - Script planning
apps/backend/src/modules/script/script.service.ts - Script RAG
apps/backend/src/modules/rag
Agent workflow
- Creation tasks
apps/backend/src/modules/creation/creation.service.ts - Run control
apps/backend/src/modules/agent/agent.service.ts - LangGraph runtime
apps/backend/src/modules/agent/orchestrator.service.ts - Material agent
apps/backend/src/modules/agent/agents/material-agent.service.ts - Script agent
apps/backend/src/modules/agent/agents/script-agent.service.ts - Composition agent
apps/backend/src/modules/agent/agents/composition-agent.service.ts - Quality agent
apps/backend/src/modules/agent/agents/quality-agent.service.ts - Agent memory
apps/backend/src/modules/agent/memory/agent-memory.service.ts
Media and operations
- Generation providers
apps/backend/src/modules/ai/services/ark-video.service.ts - Media composition
apps/backend/src/modules/media/services/composer.service.ts - Media storage
apps/backend/src/modules/media/services/storage.service.ts - Video exports
apps/backend/src/modules/export/export.service.ts - Analytics
apps/backend/src/modules/analytics/analytics.service.ts - Workflow traces
apps/backend/src/modules/trace/trace.service.ts - Background queue
apps/backend/src/modules/queue/queue-runner.service.ts - PostgreSQL
apps/backend/src/database/data-source.ts - Redis and BullMQ
apps/backend/src/modules/queue/queue.constants.ts
Other components
- User
Connections 27
- User → React studio: uses
README.md - React studio → NestJS API: calls API
README.md - React studio → Authentication: authenticates
- NestJS API → Product spaces: routes space requests
- NestJS API → Material library: routes material requests
- NestJS API → Creation tasks: routes creation requests
- NestJS API → Run control: controls runs
README.md - NestJS API → PostgreSQL: persists application data
README.md - NestJS API → Background queue: enqueues work
README.md - Background queue → Redis and BullMQ: uses BullMQ
README.md - Creation tasks → Run control: starts workflow
- Run control → LangGraph runtime: runs graph
README.md - LangGraph runtime → Material agent: dispatches
apps/backend/src/modules/agent/orchestrator.service.ts - LangGraph runtime → Script agent: dispatches
apps/backend/src/modules/agent/orchestrator.service.ts - LangGraph runtime → Composition agent: dispatches
apps/backend/src/modules/agent/orchestrator.service.ts - LangGraph runtime → Quality agent: dispatches
apps/backend/src/modules/agent/orchestrator.service.ts - Material agent → Material library: retrieves assets
README.md - Script agent → Script RAG: retrieves evidence
README.md - Script agent → Product spaces: uses product knowledge
README.md - LangGraph runtime → Agent memory: uses scoped memory
README.md - Quality agent → Script agent: feeds replanning
README.md - Composition agent → Generation providers: requests generation
README.md - Composition agent → Media composition: composes video
README.md - Media composition → Media storage: stores artifacts
README.md - LangGraph runtime → Workflow traces: records workflow traces
README.md - NestJS API → Analytics: serves analytics
- NestJS API → Video exports: serves exports