← all repositories
HKUDS/ViMax

An AI film crew that reads novels and directs its own footage

ViMax exists because most AI video tools cap out at short, inconsistent clips, so it agentically orchestrates scripting, storyboarding, and generation to turn raw ideas and full novels into finished footage.

11.3k stars Python AgentsImage · Video · Audio
ViMax
Velocity · 7d
+17
★ / day
Trend
steady
star history

What it does

ViMax is a Python framework that treats video creation as a multi-agent workflow. Feed it a raw idea, a screenplay, or an entire novel and it attempts to handle the full production chain: scripting, storyboarding, character reference management, shot design, and final generation. It also offers an AutoCameo mode that inserts a user-supplied photo into the narrative as a recurring character.

The interesting bit

Rather than generating isolated seconds-long clips, the system uses a RAG-based engine to chop long texts into multi-scene scripts and tries to maintain visual consistency across shots. It also claims to sync character voices and sound effects with the generated visuals, binding audio to the pipeline instead of tacking it on afterward.

Key highlights

  • Idea2Video, Novel2Video, Script2Video, and AutoCameo cover four distinct input modes, from vague concepts to full literary adaptations.
  • Explicitly targets long-form content, promising cross-scene continuity and multi-storyboard processing rather than single-shot generation.
  • Automates consistency checks and reference-image alignment, which are usually manual bottlenecks in AI video workflows.
  • Binds audio generation (voice and SFX) into the same agentic pipeline as the visuals.

Caveats

  • The README lists core items like “Agents Loop” and “Technical Report” under Coming Soon, suggesting the architecture is still being wired up.
  • Architecture details and any quantitative evaluation are truncated or absent, so most performance claims remain unverified in the source material.

Verdict

Worth a look if you’re experimenting with automated long-form video pipelines and can tolerate a work-in-progress feel. If you need battle-tested, production-ready tooling today, this is probably not it yet.

Frequently asked

What is HKUDS/ViMax?
ViMax exists because most AI video tools cap out at short, inconsistent clips, so it agentically orchestrates scripting, storyboarding, and generation to turn raw ideas and full novels into finished footage.
Is ViMax open source?
Yes — HKUDS/ViMax is open source, released under the MIT license.
What language is ViMax written in?
HKUDS/ViMax is primarily written in Python.
How popular is ViMax?
HKUDS/ViMax has 11.3k stars on GitHub and is currently holding steady.
Where can I find ViMax?
HKUDS/ViMax is on GitHub at https://github.com/HKUDS/ViMax.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.