AB
AiBoss
project

mortiflix-oss - 把动效设计工作室装进自己机器的开源流水线

mortiflix-oss 是一个运行在本机的动效设计工作流框架:由 Claude 分阶段产出脚本、风格帧、动态分镜与成片,每个阶段都停下来等人工审核。本文据事实表与项目自述,介绍其维护状态、主要能力、使用入口与许可限制。

mortiflix-oss 是一个把「动效设计工作室」搬到自己机器上的开源项目。按项目自述,它并不做「一句提示词换一条视频」的抽卡式生成,而是把制作拆成 brief、脚本、风格帧、转场板、动态分镜、成片等阶段,每个阶段结束都会停下来等人工审核,通过后才进入下一步。具体执行工作由 Claude 完成,使用使用者自己的 Claude Code 登录或自己的 Anthropic API key;mortiflix-oss 本身提供的是流水线、审核关卡、评审界面,以及跨会话延续项目的记忆。它面向的是单人创作者:自己写 brief、自己逐阶段把关,工作室跑在自己的机器上。

维护者与状态

仓库由 GTKottman 维护,地址为 github.com/GTKottman/mortiflix-oss。仓库创建于 2026-10-05,最后一次提交在 2026-10-21。截至 2026-11-01,项目获得 676 个星标,尚无正式 release。也就是说,目前只能从仓库直接获取代码,没有版本化的发行包可依赖,接口与目录结构仍可能随提交变动。

主要能力

以下能力均据项目 README 自述,未经本站实际运行验证。

  • 分阶段流水线:README 给出的路径是 brief → script → style frames → animatic → build → final → delivered,每个关卡都会暂停,等待使用者批准、钉注释或回答问题。
  • 会话在关卡处结束:一个 Claude 会话工作到有东西可审时,提交成果、写交接记录并停止;使用者回应后,新的会话从日志继续。项目称等待人工的这段时间不产生成本,可以等数小时甚至数天。
  • 规则写在代码里:据项目说明,只有使用者本人能批准某个审核步骤;提交若未报告该类工作的全部错误检查项,或未逐条回应上一版留下的注释,会被拒绝;已审核的内容会被复制到会话触及不到的位置,防止事后被改动。
  • 积累个人偏好:当使用者指出一个真实错误时,会话可以提议新增一条检查规则,批准一次后对之后所有视频生效;跨项目的审美偏好记录在 TASTE.md 中。
  • 流水线即文件夹:一条流水线由 pipeline.json(步骤、审核方式、错误检查)、PIPELINE.md(工艺说明)和若干 skill 组成,项目称任何人都可以自己写一条。
  • 内置流水线:README 列出四类——explainer(30 秒到 2 分钟讲解片,可配旁白与原创配乐)、social-short(45 秒到 3 分钟竖屏短片,先做钩子、静音可看)、logo-sting(3 到 8 秒 logo 动画,项目称是最快的真实运行)、song(按流派与主题生成器乐曲,含 MIDI、分轨与母带)。
  • 渲染与质检:成片基于 Remotion(React 视频)构建,每次渲染用 ffmpeg 检查格式、黑帧或冻结帧、响度,并生成帧表交由 Claude 查看。
  • 旁白两条路:可接入 ElevenLabs(使用自己的 key,可选声音、模型、稳定性与相似度、语言、发音词典等),也可用本机显卡上的 Qwen3-TTS(开源、Apache-2.0)经 ComfyUI 运行,项目称后者免费且私密。

使用入口

代码与文档都在 GTKottman/mortiflix-oss。据 README,前置条件是 Node 20+ 与 ffmpeg;要产出真实视频,还需要已登录的 Claude Code(由自己的套餐付费)或一个 Anthropic API key(按 token 付费)。安装与初始化命令如下:

git clone https://github.com/GTKottman/mortiflix-oss.git && cd mortiflix-oss
npm install
npm link
mortiflix init
mortiflix setup
mortiflix demo

之后有三种使用方式:在终端里用 mortiflix new、mortiflix run、mortiflix review 循环推进;用 mortiflix serve 打开本地网页工作室,在浏览器里看等待审核的内容、钉注释、回答问题并批准;或在 Claude Code 中通过插件市场安装后使用 /mortiflix 引导。README 还提到一个 demo 后端,用占位素材走完全部关卡,不需要 Claude,也不产生费用。

许可与限制

项目许可证为 AGPL-3.0。需要注意,README 明确说明其依赖的 Remotion 有独立许可:个人与小团队免费,超过规模需要公司许可,使用者需自行核对自己的适用情形。

已知限制方面,项目自述目前主要在 Linux 上测试;README 提到 Windows 版本计划在 2026-10-20 前推出,安装器已就绪、会话部分待完成;macOS 大体可用但尚未测试。此外,项目依赖使用者自备的第三方账号与密钥(Anthropic、ElevenLabs、Upload-Post 等),密钥保存在工作室目录下的 secrets.json 与 session.env 中。README 还提示,Postiz 已从项目中移除,改为仅通过 Upload-Post 发布,并建议此前配置过 Postiz 的用户吊销其 API key、检查已关联的社交账号。由于项目尚无正式 release,上述行为与命令均以仓库当前内容为准。