HKUDS/ViMax

Project overview

hkuds/vimax is an agent-based framework that converts concepts or screenplays into multi-scene videos through scriptwriting, storyboarding, character creation, and video generation. It requires command-line usage, Python configuration, and paid external APIs for language, image, and video generation.

Project type

AI Agent · Workflow · Video

Use cases

Video Creation

Deployment

Refer to project documentation

License

MIT

Best for

• Creators and developers comfortable with command-line tools and Python configuration who need to generate structured, multi-scene videos from text concepts or scripts.

Key capabilities

• Converts explicit screenplays into controllable multi-scene, multi-shot video while preserving the original creative intent.
• A user interface for the framework is planned for future release.

Limitations and risks

• The underlying AI tools are typically limited to generating only seconds of footage, which may impact the length of individual generated segments.
• The framework requires external API keys for LLM, image, and video generation models, which may incur costs.

Getting started

• Setup requires configuring external API keys and editing Python files for certain workflows. Users must clone the repository, install uv and run uv sync, configure API keys in configs/agent.local.yaml, and run vimax tui.

Evidence and sources

• GitHub project description: "ViMax: Agentic Video Generation (Director, Screenwriter, Producer, and Video Generator All-in-One)"
• README: - ❌ **Limited to Short Clips** - Most AI tools generate only seconds of footage. <br> - ❌ **Consistency Chaos** - Characters and scenes change unpredictably across frames. <br> -…
• README: Simply input your concept. ViMax autonomously handles the rest. It orchestrates scriptwriting, storyboarding, character creation, and final video generation—all end-to-end. 🚀
• README: ViMax is an agentic video creation framework that connects narrative planning, visual consistency, image generation, video generation, and final assembly in one extensible workflo…
• README: ViMax also provides a minimal TUI for interactive agent-based video creation.

Reviewed at: 2026-07-20T14:31:29Z