How hkuds/vimax works
ViMax turns an idea, screenplay, or novel into generated video, coordinating narrative planning, storyboarding, visual assets, shot rendering, and interactive project workspaces. The documented principal workflow runs from an idea through script and storyboard into video; Script2Video and Novel2Video provide distinct entry paths. Source excerpts show portions of the Idea2Video and Script2Video orchestration, image-provider calls, and Web UI bridge. Several documented capabilities are represented by their existing pipeline or directory paths because their implementation was not sampled.
Main entry points: script2video_pipeline.py Script2Video · novel2movie_pipeline.py Novel2Video · idea2video_pipeline.py Idea2Video · server.mjs Web API server
Components 23
Creation workflows
- Idea2Video
pipelines/idea2video_pipeline.py - Script2Video
pipelines/script2video_pipeline.py - Novel2Video
pipelines/novel2movie_pipeline.py
Creative agents
- Novel compression
agents/novel_compressor.py - Event extraction
agents/event_extractor.py - Scene extraction
agents/scene_extractor.py - Global planning
agents/global_information_planner.py - Screenwriting
agents/screenwriter.py - Character extraction
agents/character_extractor.py - Character portraits
agents/character_portraits_generator.py - Storyboard design
agents/storyboard_artist.py - Reference selection
agents/reference_image_selector.py - Camera images
agents/camera_image_generator.py
Media generation
- Shot rendering
tools/render_backend.py - Image providers
tools - Video providers
tools
Interactive workspaces
- Agent TUI
ui/src/cli.tsx - Agent loop
agent_runtime/loop.py - Web workspace
web/src/App.tsx - Web API server
web/server.mjs - Session index
agent_runtime/session_index.py - Project artifacts
web/server-lib.mjs
Other components
- Creator
Connections 25
- Creator → Idea2Video: submits concept
- Idea2Video → Screenwriting: develops story
pipelines/idea2video_pipeline.py - Idea2Video → Character extraction: extracts characters
pipelines/idea2video_pipeline.py - Idea2Video → Character portraits: generates portraits
pipelines/idea2video_pipeline.py - Idea2Video → Script2Video: hands off script
pipelines/idea2video_pipeline.py - Script2Video → Storyboard design: designs storyboard
pipelines/script2video_pipeline.py - Script2Video → Camera images: constructs camera tree
pipelines/script2video_pipeline.py - Script2Video → Shot rendering: renders shots
pipelines/script2video_pipeline.py - Script2Video → Reference selection: selects references
pipelines/script2video_pipeline.py - Shot rendering → Image providers: requests images
- Shot rendering → Video providers: requests video
- Creator → Script2Video: provides screenplay
- Creator → Novel2Video: provides novel
- Novel2Video → Novel compression: compresses narrative
- Novel2Video → Event extraction: extracts events
- Novel2Video → Scene extraction: plans scenes
- Novel2Video → Global planning: tracks characters
pipelines/novel2movie_pipeline.py - Novel2Video → Script2Video: uses video pipeline
- Creator → Agent TUI: starts conversation
- Agent TUI → Agent loop: sends requests
- Creator → Web workspace: manages project
- Web workspace → Web API server: calls API
web/src/App.tsx - Web API server → Agent loop: starts agent
- Web API server → Session index: reads sessions
- Web API server → Project artifacts: streams artifacts
web/server.mjs