Does supoclip use paid AI services?

Can use OpenAI, Anthropic or OpenRouter. Its settings have keys for these paid APIs. Its README says whether one is required.

Is supoclip still maintained?

Yes, active. Last change yesterday.

Can I trust supoclip?

Widely used. 2.8k stars, 1 years old. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to set up supoclip (FujiwaraChoki/supoclip) · gitmanual

Assembly instructions

FujiwaraChoki/supoclip

An open-source OpusClip alternative

Shell scripts

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Paid AI services?: Can use OpenAI, Anthropic or OpenRouterIts settings have keys for these paid APIs. Its README says whether one is required.
Still maintained?: Yes, activeLast change yesterday.
Can I trust it?: Widely used2.8k stars, 1 years old. As with any download, get it from the official repo.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 2,758
Activity: Updated this month

GitHub didn't answer, so this is the saved copy from 1 days ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗supoclip.comThe project's own site.

Heads-upBuilding it yourself? It also needs Redis, PostgreSQL and 178 settings in .env (27 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker-compose up -d

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Docker tool
1×Redis service
1×PostgreSQL service

178× settings in .env

SUPOCLIP_API_KEYsecret
WHISPER_MODEL_SIZE
TRANSCRIPTION_PROVIDER
ASSEMBLY_AI_SPEECH_MODELoptional
OPENAI_API_KEYsecret
GOOGLE_API_KEYsecret
YOUTUBE_DATA_API_KEYsecret
ANTHROPIC_API_KEYsecret
OPENROUTER_API_KEYsecret
OLLAMA_BASE_URLoptional
OLLAMA_API_KEYsecretoptional
LLM
QUEUED_TASK_TIMEOUT_SECONDS
YOUTUBE_METADATA_PROVIDER
YOUTUBE_PREFLIGHT_TIMEOUT_SECONDS
DEFAULT_PROCESSING_MODE
FAST_MODE_MAX_CLIPS
FAST_MODE_TRANSCRIPT_MODEL
COMPOSE_BAKE
POSTGRES_DB
POSTGRES_USER
POSTGRES_PASSWORDsecret
ASSEMBLY_AI_API_KEYsecret
DISCORD_FEEDBACK_WEBHOOK_URL
DISCORD_SALES_WEBHOOK_URL
SELF_HOST
BACKEND_AUTH_SECRETsecret
APP_SETTINGS_ENCRYPTION_KEYsecret
ALLOW_UNSIGNED_BACKEND_AUTH
AUTH_SIGNATURE_TTL_SECONDS
CORS_ORIGINS
PRO_PLAN_MINUTE_LIMIT
SCALE_PLAN_MINUTE_LIMIT
MEDIA_STORAGE
MEDIA_S3_BUCKET
MEDIA_S3_PREFIX
MEDIA_S3_REGION
MEDIA_S3_ENDPOINT
MEDIA_S3_ACCESS_KEY_IDsecret
MEDIA_S3_SECRET_ACCESS_KEYsecret
MEDIA_S3_SESSION_TOKENsecret
MEDIA_FALLBACK_BUCKEToptional
MEDIA_FALLBACK_ENDPOINToptional
MEDIA_FALLBACK_REGIONoptional
MEDIA_FALLBACK_ACCESS_KEY_IDsecretoptional
MEDIA_FALLBACK_SECRET_ACCESS_KEYsecretoptional
MEDIA_FAILOVER_ENABLEDoptional
MEDIA_URL_TTL_SECONDSoptional
MEDIA_CACHE_TTL_SECONDSoptional
MEDIA_ORPHAN_GRACE_SECONDSoptional
MEDIA_UPLOAD_CONCURRENCYoptional
MEDIA_UPLOAD_DAILY_LIMIToptional
BACKEND_CPU_ONLY
BACKEND_PLATFORM
ASSEMBLY_AI_HTTP_TIMEOUT_SECONDSoptional
ASSEMBLY_AI_REQUEST_TIMEOUT_SECONDSoptional
TRANSCRIPTION_LANGUAGEoptional
MAX_VIDEO_UPLOAD_BYTES
OPENROUTER_FALLBACK_MODEL
PEXELS_API_KEYsecret

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/FujiwaraChoki/supoclip/badge.svg)](https://gitmanual.com/FujiwaraChoki/supoclip)

Good to know

Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: backend/pyproject.toml, frontend/package.json, mcp/pyproject.toml

Details

License: AGPL-3.0
Open issues: 40
Branch: main

Files we read (9)

.env.example

.github/workflows/image-security.yml

.github/workflows/tests.yml

Makefile

README.md

backend/.env.example

docker-compose.yml

docs/setup.md

mcp/.env.example

1,165 files in the repo