Nomi

Nomi 快速入门

「把 AI 视频的成本打下来」——Nomi（aqm857886159/Nomi）是一个开源、本地优先的 AI 视频桌面工作台（macOS/Windows）。你已经有的东西——模型会员积分、API key、本地 ComfyUI——全部可以直接接进来，跑完「脚本 → 分镜 → 生成 → 剪辑」整条流水线；素材、生成的每一条 take、工作流全部留在你自己机器上。无账号、无遥测。AGPL-3.0，TypeScript。2026-09-24 核验：GitHub 522★ / 114 fork，最新版本 v0.21.0（2026-08-26 发布），提交活跃（最近 push 2026-09-23）。

这是什么？适合谁？

Nomi 补的是「AI 视频生产降本」这个位置：真正贵的是生成环节，而 Nomi 让你自由组合便宜的生成来源——中转批发价、平台限时活动、Agent 会员送的图像积分、ModelScope 免费额度、你自己的本地 ComfyUI——哪个便宜用哪个。再叠一层「草稿 → 参考 → 成片」工作流：用便宜/免费模型画分镜草图、姿态帧、参考视频（随便重生成），挑出好的喂给高质量模型做参考，把贵的积分只花在最后一步，单条成本显著下降。

适合人群：

• 批量做 AI 视频的个人创作者：会员积分和 API 余额各处都有，缺一个统一调度台
• 对素材隐私敏感的团队：素材、生成物、工作流全部本地，不经过第三方云端
• 想用 Claude Code / Codex / Cursor 直接指挥视频工作流的人：官方提供 agent 集成文档

不适合谁：想要开箱即用云端托管、不想装桌面软件的用户；只做单条视频、不关心成本优化的轻度用户（网页版生成工具更省事）。

准备工作

• 运行环境：macOS 或 Windows 桌面；从 Releases 下载安装包（当前 v0.21.0）
• 账号要求：Nomi 本身无账号、无遥测；但生成来源需要你自备——任选其一：OpenAI 兼容/Anthropic/中转 API（DeepSeek、自建 vLLM 等）、本地或云端 ComfyUI、或模型平台会员积分
• 时间预算：下载安装 10 分钟；接入第一个模型 5 分钟（粘贴 URL + key 即可）；跑通「脚本→分镜→生成」首条流水线约 30-60 分钟
• 前置知识：知道什么是 API key；用过 ComfyUI 更好（不是必须）
• 费用：Nomi 软件本身免费开源（AGPL-3.0）；生成费用取决于你选的来源，本地 ComfyUI 路线可以做到零 API 费用

快速上手

第一步：下载安装

到 GitHub Releases 下载对应平台安装包，安装后打开。无需注册任何账号。

第二步：接入第一个生成来源

打开设置，选择你要接入的东西（对应官方 agent 集成文档的四条路径）：

• API 类（DeepSeek、中转站、自建 vLLM 等_openAI 兼容端点）：粘贴 base URL + key，无需重新构建
• 本地 ComfyUI：填写 ComfyUI 地址即可，keyless 接入；支持导入 ComfyUI「Save」格式的工作流
• Agent 驱动：把官方文档 docs/integrate-with-your-agent-en.md 交给你的 Codex / Claude Code / Cursor，它会引导你完成连接——每一步都会告诉你应该看到什么、下一步点什么

第三步：跑通「脚本 → 分镜 → 生成」

1. 新建项目，把你的素材（footage）导入本机素材库
2. 写或生成分镜脚本；用便宜来源生成草稿图/参考帧（这一步可以无限重试不心疼）
3. 挑出满意的草稿作为参考，切换到高质量模型生成正式 take
4. 在内置剪辑环节里把 take 和素材排成时间线

预期产出：一条由你全程掌控成本结构的短视频成品，所有中间产物（脚本、分镜、take、工作流）都存在你本机项目里。

第四步（可选）：让 AI 编程工具指挥 Nomi

把 docs/integrate-with-your-agent-en.md 这份文档直接交给 Claude Code / Codex / Cursor，说「帮我把模型/ComfyUI/技能接进 Nomi」。文档是专门写给 agent 看的：先问你要接什么，再按对应路径逐步引导，每条路径都有「成功信号」让你确认真的通了。

常见踩坑

1. 症状：生成一直失败或质量差。 根因：草稿和成片用了同一个贵模型。解法：严格分层——草稿/参考帧用免费或便宜来源（ModelScope、会员赠送积分、本地 ComfyUI），只把筛选后的参考喂给高质量模型做最后一步。
2. 症状：ComfyUI 工作流导入后报错。 根因：导出的不是 ComfyUI「Save」格式（API 格式）。解法：在 ComfyUI 里用 Save（而非 Export）导出 JSON 再导入 Nomi。
3. 症状：想改 Nomi 的行为但不知道从哪下手。 根因：默认把它当黑盒闭源软件用。解法：代码全开源，官方明确鼓励「用你自己的 Codex / Claude Code 改造成你想要的样子、加自己的 skill」；clone 仓库即可二开。
4. 症状：团队协作时权限混乱。 根因：本地优先架构默认单机。解法：官方有 For Teams 方案（官网 teams 页），涉及 AGPL 合规的定制开发可联系维护者。
5. 症状：Windows 上首次启动慢或被杀毒拦截。 根因：桌面应用首次解压资源、未签名二进制触发误报。解法：加入白名单后重启；仍异常去 GitHub Discussions 反馈（维护者有微信群，README 有二维码）。

权限、安全与成本边界

• 隐私：无账号、无遥测（README 明示）；素材与生成物只存在本机磁盘
• 许可：AGPL-3.0-only——个人使用免费；把它作为网络服务提供给别人用会触发 AGPL 开源义务，商用二开前先读 LICENSE
• 成本模型：软件免费；生成成本 = 你所选来源的价格。用「便宜来源打草稿 + 贵模型只出成片」的分层策略是官方推荐的核心省钱路径
• 平台：macOS / Windows 桌面端（README badge 口径）；无官方 Linux 桌面包

小技巧

1. 把各平台的限时免费额度（图像积分、活动配额）都登记进 Nomi 的来源列表，生成前先切到免费来源试构图。
2. 给项目建立「草稿→参考→成片」三层文件夹习惯，Nomi 的本地项目结构支持你完全自管理中间产物。
3. 重活（批量参考帧生成）交给本地 ComfyUI 夜里跑，白天只用 API 出成片。
4. 用 agent 集成文档让 Claude Code 帮你写自定义 skill，比手工配置来源更快。
5. 升级前备份项目目录——本地优先意味着备份责任也在你。

进阶学习方向

• 成本分层策略：研究 Nomi 的「relay 批发价 + 限时活动 + 会员积分 + ModelScope 免费额度」组合定价思路，把它套到你自己的生成管线（不止视频）上。
• ComfyUI 工作流集成：导入 Save 格式工作流后，探索把 Nomi 当作 ComfyUI 的「带剪辑台的前端」用。
• Agent 二开：docs/integrate-with-your-agent-en.md 是一份高质量的「写给 agent 的文档」范本，学习它的分路径引导 + 成功信号写法，用于你自己的工具集成文档。
• 组合链路：Nomi（调度与剪辑）→ 本地 ComfyUI（免费生成）→ Claude Code（自动化脚本），官方 60 秒宣传片展示了完整工作流形态。

参考链接

• 官方仓库
• 官网
• 最新 Release v0.21.0
• Agent 集成文档
• Bilibili 视频教程