ViMax

导演编剧制片全包圆，你说想法它出片

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署视频生成 🍴 复刻 1948 🐛 待处理 55 👀 关注 81

GitHub ↗

GitHub 星标 ★ 12878

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可免费使用和部署。

项目预览

分类视频生成

开发团队HKUDS

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可免费使用和部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agentic-aigc,video-generation

GitHub 星标★ 12878

上线时间2025-03-30 00:00:00

代码更新2026-09-30

仓库体积182.3 MB

本站数据更新2026-11-09

维护状态维护中

收录时间2026-08-09

浏览次数4

智能体驱动的视频生成框架，将导演、编剧、制片人与视频生成器集于一体，通过多智能体协同完成从创意策划到成片生成的全流程，实现真正可控、可编排的视频创作体验。

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 12878

video-generation

难度：进阶约 20 分钟部署方式：命令行工具 7 步

1克隆仓库

把 ViMax 源码拉到本地并进入项目根目录，后续所有命令都在该目录执行。
```
git clone https://github.com/HKUDS/ViMax.git
cd ViMax
```
2安装依赖

项目使用 uv 管理环境，执行 uv sync 安装 Python 依赖，首次运行会拉取较多包。
```
uv sync
```
3生成私有配置

复制官方示例配置为本地私有配置，后续模型与密钥都填在 local 文件里，不要改示例文件。
```
cp configs/agent.example.yaml configs/agent.local.yaml
```
4填写模型与密钥

在 configs/agent.local.yaml 中依次填写 LLM、图像生成器、视频生成器的模型、base_url 和 api_key 三项。
5启动 TUI

在 ViMax 根目录执行 vimax tui 进入交互式智能体界面，用 new 新建会话、resume 恢复会话。
```
vimax tui
```
6启动 Web UI

进入 web 目录安装前端依赖并启动本地服务，默认监听 127.0.0.1:4173。
```
cd web
npm install
npm run dev
```
7配置脚本生成模式

若走脚本流程，需配置 configs/idea2video.yaml 或 configs/script2video.yaml，并在对应 main_*.py 中填写创意或剧本。

配置项	必填	说明	示例
`llm.model`	是	对话/编排所用大模型名称	`google/gemini-2.5-flash-lite-preview-09-2025`
`llm.model_provider`	是	LLM 服务提供方，示例中为 openai 兼容协议	`openai`
`llm.api_key`	是	LLM 接口密钥，也可用 VIMAX_LLM_API_KEY 环境变量提供	`sk-xxxxxxxx`
`llm.base_url`	是	LLM 接口地址，可指向 OpenRouter 等兼容服务	`https://openrouter.ai/api/v1`
`image.api_key`	是	图像生成模型密钥，也可用 VIMAX_IMAGE_API_KEY	`sk-xxxxxxxx`
`video.api_key`	是	视频生成模型密钥，也可用 VIMAX_VIDEO_API_KEY	`sk-xxxxxxxx`