一款友好、由 AI 驱动的开源替代方案，可替代 Capcut 和 Canva。
Discord   Twitter   官网

✨功能

高级多轨道编辑 在无限轨道上进行精确控制的编辑，支持吸附和轻松的图层管理。	实时预览 以低延迟播放即时查看每一处改动——无需等待，无需渲染。	快速导出 快速渲染高质量视频，并将其导出到您需要的任何位置。
Vibe AI 助手 描述您的想法，让 Kimu 自动为您生成剪辑、时间轴和布局。	智能媒体库 按类型、标签和情感分类整理——几秒钟内即可搜索和筛选素材。	云端同步项目 在不同设备间保持时间线和素材同步，让您随时可以从上次中断的地方继续工作。

转场效果、离线数据存储、基于 OAuth 的安全机制、变更控制
以及更多...

💻 开发

🐳 Docker 推荐

快速入门：

docker compose -f docker-compose.yml \
  -f docker-compose.dev.yml up -d

端口：

• 前端：5173
• 后端：8000
• FastAPI：3000

🛠️ 本地开发

适用于不使用 Docker 的本地开发：

# 安装依赖
pnpm install

# 启动服务
pnpm run dev                                    # 前端（端口 5173）
pnpm dlx tsx app/videorender/videorender.ts     # 后端（端口 8000）
uv run backend/main.py                          # FastAPI（端口 3000）

# 注意：AI 功能需要 GEMINI_API_KEY

要求

• Node.js 20+
• Python 3.9+
• PostgreSQL
• pnpm

🚀 生产环境

快速启动：

docker compose up -d

使用自定义域名：

PROD_DOMAIN=yourdomain.com docker compose up -d

或者直接编辑 docker-compose.yml

端口：

• HTTP：80
• HTTPS：443

⚙️ 环境配置

创建一个 .env 文件以进行自定义设置：

# 域名配置
PROD_DOMAIN=yourdomain.com

# 数据库
DATABASE_URL=postgresql://user:pass@localhost:5432/videoeditor

# 身份验证（Google OAuth）
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

# AI 功能（可选 -> /backend）
GEMINI_API_KEY=your_gemini_api_key

# Supabase（可选）
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_key

环境变量说明：

• PROD_DOMAIN：您的生产域名（仅主机部分，例如 yourdomain.com）
• DATABASE_URL：PostgreSQL 连接字符串
• GOOGLE_CLIENT_ID/SECRET：用于身份验证的 Google OAuth 凭证
• GEMINI_API_KEY：AI 驱动的视频编辑功能所需
• VITE_SUPABASE_*：可选的 Supabase 集成，用于额外功能

❤️ 贡献

我们非常欢迎您的贡献！❤️ 请查看 贡献指南。

📜 许可证

本项目采用双重许可协议。详情请参阅 LICENSE。项目的相关部分还适用 Remotion 许可证。

videoeditor 快速上手指南

videoeditor 是一款由 AI 驱动的开源视频编辑工具，旨在提供类似 CapCut（剪映）和 Canva 的友好体验，支持多轨道编辑、实时预览及 AI 辅助创作。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux / macOS / Windows (需安装 WSL2 或 Docker Desktop)
• Node.js: 版本 20 或更高
• Python: 版本 3.9 或更高
• 数据库: PostgreSQL
• 包管理器: pnpm
• 容器引擎 (推荐): Docker & Docker Compose

注意：若需使用 AI 功能（如 Vibe AI Assistant），您需要准备一个 GEMINI_API_KEY。

安装步骤

推荐使用 Docker 方式进行部署，这是最快捷且依赖最少的方法。

方式一：使用 Docker (推荐)

1. 克隆项目代码（如果尚未下载）：

   git clone <repository-url>
   cd videoeditor
   

2. 启动开发环境服务：

   docker compose -f docker-compose.yml \
     -f docker-compose.dev.yml up -d
   

3. 服务启动后，可通过以下端口访问：

   • 前端界面: http://localhost:5173
   • 后端服务: http://localhost:8000
   • FastAPI: http://localhost:3000

方式二：本地开发环境 (无 Docker)

如果您希望在本地直接运行服务，请按以下步骤操作：

1. 安装前端依赖：

   pnpm install
   

2. 分别启动三个核心服务（建议在三个不同的终端窗口中运行）：

   • 启动前端:

     pnpm run dev
     

   • 启动视频渲染后端:

     pnpm dlx tsx app/videorender/videorender.ts
     

   • 启动 FastAPI 服务:

     uv run backend/main.py
     

3. 配置环境变量： 在项目根目录创建 .env 文件，填入必要配置（特别是数据库和 AI 密钥）：

   # 数据库连接
   DATABASE_URL=postgresql://user:pass@localhost:5432/videoeditor
   
   # Google OAuth 认证 (可选，用于登录)
   GOOGLE_CLIENT_ID=your_google_client_id
   GOOGLE_CLIENT_SECRET=your_google_client_secret
   
   # AI 功能必需 (用于智能剪辑)
   GEMINI_API_KEY=your_gemini_api_key
   

基本使用

完成安装并启动服务后，即可开始使用：

1. 访问界面：打开浏览器访问 http://localhost:5173。
2. 创建项目：登录后（如配置了 OAuth）或直接进入工作台，点击新建项目。
3. 导入素材：利用 Smart Media Library 上传视频、音频或图片，支持按类型和标签管理。
4. AI 辅助编辑：
   • 找到 Vibe AI Assistant 功能。
   • 用自然语言描述您的创意（例如：“创建一个快节奏的旅游视频，搭配欢快的音乐”）。
   • AI 将自动生成剪辑节奏、布局和时间线。
5. 实时预览与导出：
   • 在多轨道时间轴上微调素材，所有更改将通过 Real-Time Preview 即时呈现，无需等待渲染。
   • 编辑完成后，点击 Fast Export 快速渲染并导出高质量视频。

---

如需部署生产环境，可运行 docker compose up -d，并通过 PROD_DOMAIN=yourdomain.com 指定自定义域名。