GTKottman/mortiflix-oss

A motion design studio on your own machine: Claude makes the video step by step, you approve every stage. Bring your own Claude Code or API key.

Mortiflix – 在本地运行的 AI 驱动动态设计工作室

它是什么
Mortiflix 是一个命令行/网页应用程序,让单一创作者通过逐步编排 Claude 生成的内容来制作短视频(解说视频、社交短片、标志片头)。它将视频创作视为一个工作室管线——简报 → 脚本 → 风格帧 → 动态分镜 → 最终版——并在每个阶段后暂停,让用户审查、留下笔记,并在下一个 Claude 会话运行前批准。

运作方式

  • 后端 – Mortiflix 可以通过已登录的 Claude Code 会话或 Anthropic API(您自己的 API 密钥)与 Claude 通信。一个“demo”后端提供一个脚本化的占位运行,无需任何费用。
  • 会话门控 – 每个阶段在自己的 Claude 会话中运行。当模型完成一个交付物时,它会停止并写下交接;用户审查它、添加笔记,然后一个新的会话从持续的日志中接续。这意味着系统可以闲置数小时或数天而不消耗 token。
  • 管线 – 管线是一个 JSON 描述(pipeline.json)加上一个 Markdown 工艺指南。管线定义了步骤、必须通过的检查,以及如何进行审查。仓库附带三个内置管线(explainer、social-short、logo-sting),用户可以复制编辑它们来创建新的管线。
  • 生产堆栈 – 视频渲染使用 Remotion(基于 React 的视频库)完成,并通过 ffmpeg 检查(格式、冻结帧、响度等)进行验证。
  • 旁白 – 可选的配音可以通过 ElevenLabs、在 GPU 上运行的本地 Qwen-3 TTS 模型生成,或由用户录制。语音转文字验证确保音频与脚本匹配。
  • 音乐 – 原创配乐在 Strudel(一种声明式音乐语言)中创作,并导出为 MIDI 加音频的分轨。
  • 资产与 3D – 资产可以从用户提供的网站使用浏览器挂钩工具获取,3D 场景在 Blender 中使用自定义的“Nova FX”粒子引擎构建。

开始使用

  1. 安装 Node 20+ 和 ffmpeg。
  2. 克隆仓库,运行 npm install 和 npm link(或 node bin/mortiflix)。
  3. mortiflix init 创建一个 ~/Mortiflix 工作室文件夹,并询问您的 Claude/Anthropic 密钥(以及可选的 ElevenLabs)。
  4. 运行 mortiflix demo 查看一个使用占位资产的完整运行(无需 Claude)。
  5. 对于真实项目,使用终端工作流程(mortiflix new …、mortiflix run、mortiflix review)或使用 mortiflix serve 启动网页界面并通过浏览器交互。

为什么重要

  • 成本效益 – 系统只在有需要您批准的内容时调用 Claude,因此 token 使用仅限于您实际需要的创意步骤。
  • 用户参与 – 与“单一提示词视频生成器”不同,Mortiflix 提供精细控制,使其适合需要准确性和品牌一致性的专业级解说视频。
  • 开源且可扩展 – 管线只是 JSON 文件;任何人都可以添加新风格、音乐视频管线或自定义检查。AGPL-3.0 许可证确保如果您将工具作为服务运行,修改必须共享。

适用对象

  • 独立创作者、教育工作者或小型团队,希望获得 AI 辅助的视频制作,而不将数据交给托管服务。
  • 有兴趣构建或扩展 AI 驱动动态设计管线的开发者。

限制

  • 目前最佳支持 Linux;Windows 支持预计于 2026 年 10 月推出,macOS 未测试。
  • 需要付费的 Claude 方案或 Anthropic API 使用;demo 后端是唯一免费的选择。
  • 繁重的步骤(渲染、3D、音乐合成)仍需要一台功能强大的本地机器(本地 TTS 需要 GPU,3D 需要 Blender)。

以上所有细节直接取自仓库的 README。

相关

  • 项目
  • 项目
  • 项目
  • 项目