FujiwaraChoki/supoclip

▲ 573 stars today★ 3,160⑂ 715

An open-source OpusClip alternative

About FujiwaraChoki/supoclip

FujiwaraChoki/supoclip is an open-source project on GitHub, mainly written in Python. An open-source OpusClip alternative It currently holds 3,160 stars and 715 forks with 64 open issues, and was last pushed on 2026-11-15 (repository created 2025-07-28).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository FujiwaraChoki/supoclip · default branch main · size 54283 KB · watchers 30 · source: GitHub REST API and repository README

README

https://github.com/FujiwaraChoki/supoclip/blob/HEAD/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.

https://github.com/FujiwaraChoki/supoclip/blob/HEAD/License: AGPL-3.0 https://github.com/FujiwaraChoki/supoclip/blob/HEAD/Hosted at supoclip.com https://github.com/FujiwaraChoki/supoclip/blob/HEAD/Documentation

https://github.com/FujiwaraChoki/supoclip/blob/HEAD/Download SupoClip on the App Store   https://github.com/FujiwaraChoki/supoclip/blob/HEAD/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.

GitHub Stars & Activity

3,160Stars
715Forks
64Open issues
PythonLanguage

GitHub Popularity

GitHub stars3,160
Forks715
Open issues64
Primary languagePython
LicenseAGPL-3.0
Stars gained today573
Created2025-07-28
Last pushed2026-11-15

Trending History

Weekly boardrank #69 · ▲ 573 stars

Related GitHub Projects

1

Graphify-Labs / graphify

Python★ 149,279⑂ 14,354▲ 615 stars
→
2

ComposioHQ / awesome-claude-skills

Python★ 79,689⑂ 9,754▲ 88 stars
→
3

usestrix / strix

Python★ 76,182⑂ 8,643▲ 325 stars
→
4

mvanhorn / last30days-skill

Python★ 68,501⑂ 6,101▲ 135 stars
→
5

jingyaogong / minimind

Python★ 65,627⑂ 8,605▲ 188 stars
→
6

virgiliojr94 / book-to-skill

Python★ 38,208⑂ 4,063▲ 161 stars
→
7

elementalsouls / Claude-BugHunter

Python★ 7,963⑂ 1,237▲ 1,094 stars
→
8

kajisho5 / ffmpeg-skill

Python★ 7,450⑂ 681▲ 367 stars
→

More Trending Repositories