Repolode
提交项目
HKUDS

HKUDS/ViMax

面向视频生成的智能体框架，可将创意、剧本或小说自动转化为多镜头视频，涵盖编剧、分镜、角色与视频生成。

在 GitHub 查看官网
Star
12,707
Fork
1,927
未关闭 Issue
53
最近提交
20天前

这是什么？

ViMax 是一个智能体式视频创作框架，可把一段故事从构思到成片的流程自动化，覆盖剧本编写、分镜设计、角色与参考图制作、镜头规划、图片与视频生成以及最终合成。用户既可以从一句简短创意开始，也可以直接输入长篇文本，无需手动逐镜头制作。

项目提供多种入口流程：Idea2Video 将简短创意扩展为角色、剧本和分镜；Script2Video 把明确的剧本转化为可控的多场景视频；Novel2Video 将长篇小说改编为分集的视觉叙事；AutoCameo 则可把参考照片中的人物或宠物放入生成的故事中。兼容的镜头和媒体素材可以并行生成。

除了可交互的命令行 TUI（支持会话恢复），ViMax 还提供本地 Web UI，支持命名项目、文件上传、产物与分镜预览以及模型服务配置。项目基于 Python 3.12，使用 uv 管理环境，并支持可配置的对话、图像和视频模型服务商。

核心功能

  • 01从一句简短创意自动生成包含剧本、分镜和镜头的完整视频。
  • 02将明确的剧本转化为多场景、多镜头的可控视频。
  • 03把长篇小说改编为分集式视觉叙事。
  • 04在生成的多个场景中保持人物或宠物外观一致。
  • 05提供交互式 TUI 与本地 Web UI，用于规划、修改和控制渲染。
  • 06并行生成兼容的镜头与媒体素材。

适用场景

  • 根据文字创意快速制作短片或预告片原型。
  • 将剧本转化为粗剪多镜头视频以供审阅。
  • 把小说章节改编为分集式动画风格视频。
  • 制作以用户自己照片为主角的个性化短故事。

快速上手

  1. 1

    安装 uv(参见 README 中的 uv 文档链接)

  2. 2

    克隆仓库

    git clone https://github.com/HKUDS/ViMax.git
  3. 3

    进入项目目录并安装依赖

    cd ViMax && uv sync
  4. 4

    创建本地 agent 配置并填入 API 密钥,然后启动 TUI

    cp configs/agent.example.yaml configs/agent.local.yaml

使用前须知

  • 需要为大模型、图像和视频生成服务提供商配置 API 密钥,可能产生较高费用。
  • 运行前需要配置包含模型和服务商信息的 YAML 文件。
  • README 仅列出支持 Linux 和 Windows 系统。

标签

#video-generation#ai-agents#llm#storyboard#screenwriting#image-generation#python#multimodal#agentic-aigc

常见问题

ViMax 是什么？
面向视频生成的智能体框架，可将创意、剧本或小说自动转化为多镜头视频，涵盖编剧、分镜、角色与视频生成。 ViMax 是一个智能体式视频创作框架，可把一段故事从构思到成片的流程自动化，覆盖剧本编写、分镜设计、角色与参考图制作、镜头规划、图片与视频生成以及最终合成。用户既可以从一句简短创意开始，也可以直接输入长篇文本，无需手动逐镜头制作。
ViMax 可以免费使用吗？用的什么许可证？
ViMax 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
ViMax 还在维护吗？
活跃维护中。ViMax 最近一次提交是在 2026年9月30日。
ViMax 适合用来做什么？
根据文字创意快速制作短片或预告片原型。 将剧本转化为粗剪多镜头视频以供审阅。 把小说章节改编为分集式动画风格视频。 制作以用户自己照片为主角的个性化短故事。
ViMax 怎么安装和运行？
安装 uv(参见 README 中的 uv 文档链接) 克隆仓库: git clone https://github.com/HKUDS/ViMax.git 进入项目目录并安装依赖: cd ViMax && uv sync 创建本地 agent 配置并填入 API 密钥,然后启动 TUI: cp configs/agent.example.yaml configs/agent.local.yaml
在哪里获取 ViMax？
源代码和安装说明在 GitHub 上：https://github.com/HKUDS/ViMax

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目