SupoClip é uma plataforma open source que transforma vídeos longos em cortes verticais para TikTok, Reels e YouTube Shorts. Ela recebe um vídeo enviado pelo usuário ou uma URL suportada, gera transcrição com timestamps por palavra, pede a um modelo de linguagem que selecione os trechos mais promissores e renderiza clipes em 9:16 com recorte centrado em rosto, legendas, título de abertura, transições e B-roll opcional.
O projeto se apresenta como uma alternativa auto-hospedável a serviços de clipping por assinatura. A proposta não é “baixar qualquer vídeo e repostar”: para operar de forma responsável, use apenas conteúdo próprio, licenciado ou autorizado. A ferramenta pode reduzir o trabalho de edição, mas não concede direitos sobre vídeo, voz, música, marcas ou material de terceiros.

O que é o SupoClip
SupoClip é uma aplicação de processamento assíncrono de vídeo. A pessoa cria uma tarefa com um arquivo ou link compatível; o backend registra a fonte, coloca o trabalho em uma fila e um worker executa as etapas longas. Ao final, os clipes e seus metadados ficam disponíveis para revisão, edição, download e, quando configurado, publicação em redes sociais.
O projeto combina uma interface em Next.js 15 e React 19, API FastAPI, worker ARQ, Redis, PostgreSQL, FFmpeg e integrações de IA. Ele não é um modelo de vídeo único nem um simples editor de legendas: funciona como uma linha de produção que separa criação da tarefa, transcrição, análise, renderização e persistência.
Na análise do NoticIA, a característica mais importante é a separação entre o sistema e os provedores. A instalação auto-hospedada pode escolher LLMs da OpenAI, Google, Anthropic, OpenRouter ou Ollama; a transcrição por padrão requer AssemblyAI, enquanto o modo local pode usar Whisper e Ollama em uma configuração própria. Isso dá flexibilidade, mas não elimina os custos de APIs, computação, armazenamento ou download de mídia.
O pipeline: do vídeo longo aos cortes
A arquitetura documentada pelo projeto segue esta sequência:
- Aquisição da fonte: recebe upload ou busca mídia de plataformas compatíveis, como YouTube, Twitch e Kick.
- Transcrição: cria texto com timing por palavra, necessário para selecionar trechos e sincronizar legendas.
- Seleção de segmentos: um LLM analisa a transcrição e escolhe momentos curtos considerados promissores.
- Renderização: corta, adapta para vertical, aplica legendas, fontes, títulos, recorte centrado no rosto, transições e B-roll quando ativados.
- Persistência e revisão: salva arquivos, textos selecionados, momentos do vídeo e pontuações no banco; a interface acompanha o progresso em tempo real.
A fila é essencial nesse desenho. A criação de uma tarefa responde rápido, enquanto o processamento roda no worker. Se Redis ou o worker estiverem fora do ar, uma tarefa pode permanecer em queued sem produzir corte algum. Em um deploy real, não basta a página carregar: frontend, API, worker, PostgreSQL, Redis e volumes de mídia precisam estar ativos e conectados.
Recursos que o projeto declara
- Seleção de cortes por IA: o modelo escolhe de 3 a 7 segmentos do transcript; o código também permite limites diferentes por configuração.
- Virality scoring: cada corte recebe critérios como hook, engajamento, valor e potencial de compartilhamento.
- Recorte vertical inteligente: detecção de rosto ajuda a manter a pessoa enquadrada no formato 9:16.
- Legendas sincronizadas por palavra: usa timestamps para aplicar estilos, animações, fontes e templates de caption.
- Títulos de abertura: a IA pode sugerir uma headline para os primeiros segundos do clipe.
- B-roll e transições: pode buscar imagens de apoio no Pexels, quando a chave correspondente estiver configurada.
- Editor integrado: permite trim, split, merge e nova exportação com presets para TikTok, Reels e Shorts.
- Publicação e agenda: há conectores para contas próprias de YouTube, TikTok e Instagram, sujeitos às credenciais, auditorias e limites de cada plataforma.
- Feedback de performance: métricas como visualizações, likes, comentários e compartilhamentos podem retroalimentar a seleção, depois que houver dados suficientes.
Esses recursos não são garantia de viralização. Uma pontuação gerada por IA é uma heurística de seleção, não uma previsão verificável de alcance. Tema, audiência, reputação do canal, edição, timing, distribuição e as políticas de recomendação de cada rede continuam determinantes.
Como instalar com Docker
O caminho recomendado pelo repositório é Docker Compose. A stack inicia frontend, backend, worker, PostgreSQL e Redis juntos. Antes de qualquer build, você precisa decidir quais serviços externos usará e entender que algumas chamadas podem gerar cobrança.
git clone https://github.com/FujiwaraChoki/supoclip.git
cd supoclip
cp .env.example .envO mínimo documentado exige uma chave da AssemblyAI e uma configuração de LLM. Um exemplo usa Gemini, mas isso é apenas uma possibilidade:
ASSEMBLY_AI_API_KEY=sua_chave
LLM=google-gla:gemini-3-flash-preview
GOOGLE_API_KEY=sua_chave
BETTER_AUTH_SECRET=troque_por_um_segredo_forte
SELF_HOST=trueDepois, inicie o conjunto:
docker-compose up -d --build
docker-compose logs -f
docker-compose psO frontend padrão usa http://localhost:3107; a API FastAPI roda em http://localhost:8000 e disponibiliza documentação interativa em /docs. Instalações antigas podem usar a porta 3001; se você já tiver um proxy reverso em produção, preserve a porta configurada e mantenha URLs públicas, CORS e origens confiáveis coerentes.
Não copie chaves reais para arquivos versionados. Em produção, altere os segredos de autenticação, coloque o app atrás de HTTPS, use volumes persistentes, faça backup do PostgreSQL e limite quem pode criar contas ou acessar a API.
Requisitos técnicos e custos que a instalação não elimina
Auto-hospedar elimina a taxa da plataforma hospedada, não o custo operacional. O projeto precisa de Docker, banco, Redis, espaço para uploads e renders, CPU ou GPU conforme a carga, FFmpeg e serviços de IA escolhidos. O stack padrão tem caminho CPU-only, útil para começar, porém renderização, transcrição e análise de vídeos longos serão mais lentas.
O repositório informa que a configuração padrão pede AssemblyAI para transcription com timing de palavras. O LLM pode ser hospedado por fornecedores externos ou por Ollama. Assim, uma instalação pode ter custos de AssemblyAI e do provider de LLM mesmo quando roda em hardware próprio. Pexels, Apify, proxies residenciais, RapidAPI, storage S3, Stripe e OAuth social são opcionais, mas cada um adiciona custos, credenciais, termos de serviço e operação.
O pipeline também prevê limites técnicos: a configuração padrão aceita vídeos de até 5.400 segundos, ou 90 minutos, e uploads de até 4 GB. A quantidade máxima padrão é 10 clipes por tarefa. Esses valores são configuráveis, mas aumentar duração, resolução ou paralelismo amplia uso de disco, CPU, memória, tempo de fila e custos de provedores.
Fontes suportadas e direitos de uso
SupoClip documenta entrada por upload e por URLs de YouTube, Twitch e Kick; lives em andamento não são suportadas. O projeto usa uma cadeia de provedores para download, incluindo yt-dlp, proxies e alternativas via Apify. Em redes de datacenter, por exemplo, downloads do YouTube podem encontrar desafios anti-bot e exigir configuração adicional.
Essa capacidade técnica não substitui autorização. Baixar ou recortar um conteúdo público pode violar termos de plataforma, direitos autorais, direitos de personalidade e acordos de distribuição. Use a ferramenta para vídeos seus, de clientes com contrato, entrevistas autorizadas, conteúdo sob licença compatível ou materiais em que você tem direito expresso de edição e publicação.
Também evite representar o corte como fala fora de contexto. Selecionar os segundos mais polêmicos pode aumentar retenção, mas pode distorcer uma entrevista ou declaração. Uma operação editorial responsável mantém o vídeo original, confere o trecho completo e revisa títulos, legendas e B-roll antes de publicar.
Editor, legendas e formato para redes
Depois da geração, o SupoClip mantém registros de timing, texto selecionado, score e arquivos produzidos. O editor permite ajustar trechos, dividir, unir e exportar novamente. O documento de arquitetura explica que uma edição de caption renderiza um novo arquivo a partir das faixas de origem e então aplica a legenda; não é apenas uma camada visual acrescentada por cima de um MP4 anterior.
Isso explica por que o sistema precisa preservar fontes e cache. Se o vídeo original de upload ou a fonte remota não estiver disponível, certas edições podem não ser possíveis. A configuração pode manter cache de fontes de YouTube por um período definido, reduzindo repetição de downloads e facilitando ajustes posteriores; em contrapartida, retém mídia e exige política de armazenamento, limpeza e segurança.
Publicação em YouTube, TikTok e Instagram
O projeto inclui suporte opcional a OAuth e publicação direta em contas próprias. Para ativar, o operador precisa registrar aplicativos nas plataformas e fornecer IDs, segredos, callback URLs e uma chave de criptografia para tokens. O app pode restringir o recurso a administradores, a usuários permitidos ou desligá-lo totalmente.
O status de uma integração não significa que ela está pronta para publicar livremente. O guia alerta que projetos Google não verificados podem enviar uploads somente como privados até passar por auditoria de conformidade; TikTok limita visibilidade e volume de apps não auditados; e Instagram exige conta profissional e, em muitos cenários, App Review. Essas condições são impostas pelas plataformas, não pelo SupoClip.
O fluxo seguro é conectar uma conta de teste, publicar manualmente com a visibilidade permitida, conferir o resultado na rede social e testar agenda e cancelamento antes de liberar acesso a usuários. Nunca conecte credenciais de produção em uma instalação experimental exposta publicamente.
SupoClip via MCP
O repositório inclui um servidor MCP para comandar o pipeline a partir de clientes como Claude Desktop, Claude Code e Cursor. A camada MCP pode consultar saúde, listar templates de captions, checar transições, criar tarefa, esperar o processamento, listar clipes, baixar MP4, exportar com preset e cancelar, retomar ou remover tarefas.
O servidor aponta para a API hospedada por padrão, mas a variável SUPOCLIP_API_URL permite conectar uma implantação própria. Funções que criam, baixam ou gerenciam tarefas exigem API key ou credenciais da instância auto-hospedada. Como esses comandos podem iniciar processamento pago, fazer download de vídeo e gravar arquivos, um agente deve pedir aprovação antes de criar tarefas ou usar contas conectadas.
cd mcp
uv run supoclip-mcpA recomendação é começar em um ambiente controlado, com diretório de download dedicado, API key de escopo mínimo e uma política humana de revisão antes de qualquer publicação social. O MCP facilita automação; ele não transfere a responsabilidade editorial ou jurídica para o agente.
Arquitetura: por que há tantos serviços
A arquitetura é composta por frontend Next.js, API FastAPI, worker ARQ, Redis, PostgreSQL e storage. O frontend autentica usuários e cria tarefas; a API valida pedidos e mantém estado; Redis transporta jobs e atualizações de progresso; o worker faz a parte lenta; PostgreSQL guarda dados de usuário, fontes, tarefas, clips, billing e cache.
Essa separação tem uma consequência prática: subir apenas a página não é suficiente. Se o worker não estiver ativo, os jobs não saem da fila. Se Redis estiver indisponível, não há entrega de job nem progresso em tempo real. Se o volume de mídia for efêmero, o usuário pode perder fontes ou renders ao recriar containers. Para uso sério, monitore saúde de serviços, fila, disco, banco, workers e limites de API.
Licença e decisão de uso
SupoClip usa AGPL-3.0. Você pode executar, estudar, modificar e redistribuir o código dentro dos termos da licença. A obrigação adicional relevante é para versões modificadas disponibilizadas pela rede: quem opera uma versão alterada acessível a usuários precisa disponibilizar o código-fonte correspondente sob a AGPL. A licença do projeto não concede direitos sobre vídeos, músicas, contas sociais, imagens de B-roll ou APIs externas.
Para criadores e equipes que já possuem seus próprios vídeos longos, SupoClip é interessante como infraestrutura de clipping que pode ser auditada e adaptada. Para quem espera uma solução “sem custo”, a resposta é mais complexa: não há cobrança por minuto da ferramenta auto-hospedada, mas há serviços externos, infraestrutura e trabalho operacional. O valor está no controle sobre pipeline, armazenamento e personalização — desde que o uso respeite autorização, contexto e direitos dos conteúdos processados.
Descubra mais sobre noticiAI
Assine para receber nossas notícias mais recentes por e-mail.

1 comentário