clipforge

环境要求

• 已安装 Docker（推荐方式：自托管无需装 Node / FFmpeg）
• 若走本地开发方式：Node.js 环境 + pnpm 包管理器（README 明确必须用 pnpm）
• 视频合成依赖本机 FFmpeg（需自行安装）
• 至少一个 AI 平台的 API Key（推荐 Atlas Cloud，一个 Key 同时支持 LLM + 生图 + 生视频）

安装与启动步骤

1. 1Docker 一键启动

   最快的自托管方式，无需安装 Node 和 FFmpeg。命令会拉取镜像并后台运行服务。

   docker run -d -p 3000:3000 -v clipforge-data:/data ghcr.io/xixihhhh/clipforge

   复制

2. 2或用本地方式装依赖

   不走 Docker 时使用本地开发方式，必须在项目目录下用 pnpm 安装依赖，不要用 npm。

   pnpm install

   复制

3. 3启动开发服务器

   本地方式安装完依赖后启动开发服务器，启动后按提示在浏览器访问本地服务地址。

   pnpm dev

   复制

4. 4安装 FFmpeg

   视频合成依赖本机 FFmpeg，需自行安装；macOS 用 brew，Ubuntu/Debian 用 apt install ffmpeg。

   brew install ffmpeg

   复制

5. 5配置 API Key

   打开右上角「设置」，配置至少一个 AI 平台 API Key，并配置 LLM（支持任何 OpenAI 兼容接口）。

6. 6选择默认模型

   在「默认设置」里选择默认生图 / 生视频模型，例如 GPT Image 2、Seedance 2.5；可选配置出镜人物与品牌。

7. 7运行测试（可选）

   验证安装是否正常，项目自带 1170+ 用例，可作为环境自检。

   pnpm test

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:3000，能进入首页并点击「新建项目」即表示启动成功。

常见问题

注意事项

• Docker 方式用 -v clipforge-data:/data 挂载数据卷，删除容器不会丢数据。
• README 未给出具体的 Node 版本要求，本地方式请以实际运行结果为准。
• 密钥等敏感信息在页面「设置」中填写，不要写进代码或提交到仓库。
• 首次使用可参考仓库内的 TUTORIAL.md 小白教程（安装、配 Key、出第一条片）。