supoclip README

项目的 README,来自 github.com/FujiwaraChoki/supoclip。合并为一个 markdown 文件:README.md。

SupoClip dashboard with video input, caption controls, and recent clips

Fuck OpusClip.

... because good video clips shouldn't come with ugly watermarks or platform lock-in.

License: AGPL-3.0 Hosted at supoclip.com Documentation

Download SupoClip on the App Store   SupoClip on Product Hunt


SupoClip is an open-source, AI-powered video clipping tool. Give it a long video — a podcast, a talk, a stream VOD — and it finds the most viral-worthy moments, scores them, and renders them as vertical 9:16 clips with face-centered cropping, word-synced subtitles, hook titles, and optional B-roll. Run it yourself, customize it, inspect it — or use the hosted version and skip the setup.

See it first: watch real clips SupoClip generated from a long-form interview, or follow the self-hosting tutorial to run it on your own machine.

Ways to Use SupoClip

Option Details
Hosted web app www.supoclip.com — no infrastructure to run
iOS app SupoClip on the App Store — the same hosted pipeline, from your iPhone
Self-host Docker Compose setup below, or the step-by-step self-hosting tutorial — AGPL-3.0, unlimited usage on your own hardware
MCP server mcp/ — use SupoClip from Claude, Cursor, and other MCP clients
REST API API keys from /settings/api-keys authenticate the backend directly — see the API reference

Why SupoClip Exists

OpusClip is genuinely good at what it does — AI clip selection, accurate captions, virality scoring. But your usage is metered by plan, some exports carry platform branding, and your content and workflows live on their servers under their terms.

SupoClip gives you the same core pipeline without the leash:

Features

Quick Start

You need Docker, an AssemblyAI API key for transcription, and one LLM provider key (Google, OpenAI, Anthropic, or a local Ollama).

git clone https://github.com/FujiwaraChoki/supoclip.git
cd supoclip

Create a .env in the root with your keys:

ASSEMBLY_AI_API_KEY=your_assemblyai_api_key
LLM=google-gla:gemini-3-flash-preview
GOOGLE_API_KEY=your_google_api_key

Then start everything:

docker-compose up -d

First startup takes a few minutes; watch it with docker-compose logs -f. Once healthy, open http://localhost:3107, create an account, and start clipping. The backend API lives at http://localhost:8000 with interactive docs at /docs.

The template sets FRONTEND_PORT=3107. Existing deployments without this setting keep port 3001; preserve that port if your production reverse proxy uses it. See the setup guide for custom ports and public URLs.

To run fully local with Whisper and Ollama (including the Docker networking Ollama needs), see the self-hosting tutorial. To use a different LLM provider or configure the optional pieces (B-roll, analytics, emails, YouTube metadata), see the configuration guide. If something misbehaves, the troubleshooting guide covers the common failure modes.

Documentation

Everything beyond this page lives in docs/:

Guide What it covers
Setup Docker-first install, local development, first-run checklist
Configuration Every environment variable, operating modes, provider options
App Guide Screens, workflows, admin features, hosted vs self-host
Architecture How the frontend, API, worker, queue, and pipeline fit together
API Reference Backend endpoints, API keys, admin and billing routes
Development Running locally without Docker, testing, contributing workflow
Troubleshooting Fixes for the common ways things go wrong

Development & Testing

The stack runs locally without Docker too — see development for the backend (uv + FastAPI + ARQ worker) and frontend (Next.js + pnpm) commands. The test suite spans pytest, Vitest, and Playwright, all reachable from the repo root:

make test

License

SupoClip is released under the AGPL-3.0 License.

Contributions are accepted under the terms in CONTRIBUTING.md, including a license grant that allows the project owner to sublicense and relicense contributed code.

supoclip (FujiwaraChoki/supoclip)

正在搜索数据库…

这是什么?SupoClip 是一款开源的 AI 视频剪辑工具,定位为 OpusClip 的替代品。你可以输入一段长视频(播客、演讲、直播回放等),它会找出最具传播潜力的片段并为其打分,然后生成 9:16 竖屏剪辑,包括以人脸为中心的裁剪、同步字幕、开场钩子标题,以及可选的 B-roll 画面。
这是托管的网页应用,还是需要我自己运行的程序?两种都有:supoclip.com 上提供托管的网页应用和一款 iOS 应用,二者使用相同的处理流程;你也可以通过 Docker Compose 自托管整套服务,遵循 AGPL-3.0 许可证。它还提供面向 Claude 和 Cursor 的 MCP 服务器,以及 REST API。
我要怎么把自托管版本跑起来?在代码仓库根目录创建一个 .env 文件,填入你的 API 密钥,然后用 Docker Compose 启动所有服务(运行 docker-compose logs -f 可以查看首次启动时的日志)。服务状态正常后,打开应用,注册账号,就可以开始剪辑了。
运行它需要准备哪些 API 密钥?你需要 Docker、一个用于语音转写的 AssemblyAI API 密钥,以及一个大语言模型服务商的密钥。服务商可以选择 Google、OpenAI 或 Anthropic,也可以使用本地的 Ollama 模型。
它支持直播吗?不支持直播本身。它支持 YouTube 视频、Twitch/Kick 的直播回放和精彩片段,以及你自己上传的文件。
自托管真的能保证我的内容私密吗?能。在你自己的硬件上运行 SupoClip,意味着你的视频和工作流程都保存在自己的基础设施上,而不是存放在第三方服务器中,并且没有用量计费,也没有水印。
它是怎么挑选视频中哪些部分做成片段的?大语言模型(Gemini、GPT、Claude 或本地 Ollama 模型)会分析转写文本,挑选出 3–7 个最值得剪辑的片段,然后分别从开场吸引力、互动度、价值感和分享性四个维度为每个片段打分。
SupoClip 能直接把片段发布到社交平台吗?可以。你可以绑定自己的 YouTube、TikTok 和 Instagram 账号,直接在任务页面发布或定时发布生成的片段,还能利用各平台的数据表现,改进之后的片段选择。
如果我想在导出前调整片段,有编辑器吗?有。内置编辑器支持裁剪、分割和合并片段,并提供适用于 TikTok、Reels 和 Shorts 的导出预设。
前端和后端分别用的是什么技术栈?后端基于 FastAPI,搭配 ARQ 工作进程(通过 uv 管理);前端使用 Next.js,通过 pnpm 管理。测试框架包括 pytest、Vitest 和 Playwright。
大小
109.7 MB
星标
3.4K
更新
提交Nov 18
时长
1年
提交 · 90 天