Guia de auto-hospedagem
Como auto-hospedar o GR6 Hype com Docker Compose
Um passo a passo prático da pilha Docker Compose do repositório: o que cada serviço faz, quais chaves você precisa, como rodar sem IA na nuvem e o que reforçar antes da produção.
Por GR6 Hype · Atualizado em · Leitura de 9 min
O GR6 Hype é o cortador de vídeo com IA de código aberto por trás do app hospedado em supoclip.com. O mesmo repositório traz uma pilha Docker Compose que você pode rodar num laptop, num servidor de casa ou num VPS. Este guia segue essa pilha exatamente como ela existe no repositório. Quando um passo depende do seu provedor ou do hardware, dizemos isso em vez de adivinhar.
Prefere não operar infraestrutura? O app hospedado roda o mesmo processo. Ainda escolhendo entre ferramentas? Leia primeiro a nossa comparação GR6 Hype versus OpusClip.
O que você está executando
docker compose up inicia estes contêineres, todos definidos em docker-compose.yml:
| Serviço | Função | Porta do host |
|---|---|---|
| frontend | App web Next.js, autenticação e proxy da API | FRONTEND_PORT (3107 em .env.example; 3001 se não for definido) |
| backend | API FastAPI; documentação em /docs | 8000 |
| worker | Worker ARQ: baixa, transcreve, analisa e renderiza | nenhuma |
| postgres | PostgreSQL 15: usuários, tarefas, clipes | nenhuma |
| redis | Redis 7: fila de jobs e progresso ao vivo | 6379 |
| mcp | Servidor MCP para clientes de IA (opcional mantê-lo rodando) | 9100 |
Cada porta publicada fica presa a 127.0.0.1, então uma instalação nova só é acessível a partir da própria máquina. Clipes gerados, envios, Postgres e Redis ficam em volumes nomeados do Docker, então sobrevivem a reinícios de contêineres. Se você não usa MCP, pare esse contêiner com docker compose stop mcp.
Requisitos
- Docker com Compose v2 (
docker compose) ou odocker-composeavulso, mais Git. - Uma fonte de transcrição, definida com
TRANSCRIPTION_PROVIDER:assemblyai(padrão, precisa deASSEMBLY_AI_API_KEY),whisper(local, sem chave) ouyoutube_captions(só links do YouTube). - Um LLM para escolher clipes, definido com
LLM=provider:model: OpenAI, Google, Anthropic, OpenRouter (cada um precisa da própria chave de API) ou um modelo localollama:. - Opcional:
PEXELS_API_KEYpara sobreposições de B-roll.
A primeira build das imagens baixa dependências de Python e Node. O início rápido estima 5–10 minutos; varia com a sua conexão e a CPU.
Instalar com Docker Compose
1. Clone e crie o seu arquivo de ambiente
git clone https://github.com/FujiwaraChoki/supoclip.git
cd supoclip
cp .env.example .env2. Escolha provedores em .env
O modelo usa por padrão LLM=openrouter:anthropic/claude-sonnet-5.5. O processamento falha se você não definir OPENROUTER_API_KEY ou não apontar LLM para um provedor do qual você tenha chave. Uma configuração mínima na nuvem fica assim:
TRANSCRIPTION_PROVIDER=assemblyai
ASSEMBLY_AI_API_KEY=your_assemblyai_key
LLM=google-gla:gemini-3-flash-preview
GOOGLE_API_KEY=your_google_key
# Replace every placeholder secret, even for local use
BETTER_AUTH_SECRET=generate_with_openssl_rand_base64_32
BACKEND_AUTH_SECRET=generate_another_one
APP_SETTINGS_ENCRYPTION_KEY=and_another_oneGere cada segredo com openssl rand -base64 32. SELF_HOST=true (o padrão) deixa a cobrança desligada e remove os limites de geração por conta.
3. Faça o build e inicie
docker compose up -d --build
# or: ./start.sh (checks .env and Docker first, then does the same)Abra http://localhost:3107, crie uma conta e cole um link do YouTube, da Twitch ou da Kick ou envie um arquivo. A documentação da API fica em http://localhost:8000/docs.
Opção: transcrição e seleção de clipes totalmente locais
Para manter transcrições e análise no seu próprio hardware, combine o Whisper local com um modelo do Ollama:
TRANSCRIPTION_PROVIDER=whisper
WHISPER_MODEL_SIZE=medium # tiny | base | small | medium | large | large-v3
LLM=ollama:gpt-oss:20b
# Empty = http://host.docker.internal:11434/v1 inside the containers.
# If you set it yourself, keep the /v1 suffix.
OLLAMA_BASE_URL=O worker faz as chamadas ao Ollama de dentro do contêiner, então o Ollama precisa ser alcançável a partir dali, não só do seu shell. Como chegar lá depende de onde o Ollama roda:
Ollama no host, com Docker Desktop (macOS, Windows)
Não precisa de configuração extra. O Docker Desktop encaminha host.docker.internal para o host, então deixe OLLAMA_BASE_URL vazio e baixe o modelo com ollama pull gpt-oss:20b.
Ollama no host, com Docker Engine (Linux)
O Compose mapeia host.docker.internal para o gateway da bridge do Docker, mas o Ollama escuta só em 127.0.0.1 por padrão, então a conexão do worker é recusada. Faça o Ollama escutar em todas as interfaces:
sudo systemctl edit ollama
# [Service]
# Environment="OLLAMA_HOST=0.0.0.0:11434"
sudo systemctl restart ollama
ollama pull gpt-oss:20bIsso também expõe a porta 11434 nas suas interfaces de rede. O Ollama não tem autenticação, então bloqueie essa porta de fora da máquina com o firewall. Se o firewall filtrar tráfego das redes do Docker, permita também que os contêineres a alcancem.
Ollama no próprio contêiner
Adicione-o à pilha com um arquivo de override e depois aponte o GR6 Hype para o nome do serviço em vez do host:
services:
ollama:
image: ollama/ollama
volumes:
- ollama_models:/root/.ollama
restart: unless-stopped
volumes:
ollama_models:OLLAMA_BASE_URL=http://ollama:11434/v1
docker compose up -d ollama
docker compose exec ollama ollama pull gpt-oss:20b
docker compose up -d backend worker # pick up the new .env valueSeja qual for a configuração, teste de dentro do worker antes de enviar um vídeo. A verificação procura gpt-oss:20b porque esse é o modelo do valor de exemplo de LLM. Se você escolheu outro modelo, troque pelo nome exato depois de ollama: no seu ajuste de LLM. O Ollama lista um modelo baixado sem tag como name:latest, então use essa forma na verificação.
# Host Ollama:
docker compose exec worker curl -s http://host.docker.internal:11434/api/tags | grep -q '"gpt-oss:20b"' && echo "model ready"
# Ollama container:
docker compose exec worker curl -s http://ollama:11434/api/tags | grep -q '"gpt-oss:20b"' && echo "model ready"model ready significa que o worker alcança o Ollama e que o modelo procurado está instalado. Sem saída, a conexão falhou ou o modelo falta, então rode o comando de novo sem o grep para ver qual é. Modelos menores do Whisper trocam exatidão por velocidade, e a qualidade do clipe depende do LLM. Compare um modelo local com um hospedado numa gravação que você conhece antes de trocar o acervo inteiro.
Verifique a instalação
docker compose ps # every service should be "healthy"
curl -f http://localhost:8000/health/db # backend can reach Postgres
docker compose logs -f worker # watch a job move through the pipeline- Crie uma conta e envie primeiro um vídeo curto, para uma configuração errada falhar rápido.
- Confirme que a página da tarefa mostre o progresso. Se ficar na fila, veja os logs do worker.
- Reproduza e baixe um clipe pronto.
Tarefas travadas costumam ser uma chave de provedor faltando ou um worker que não alcança o Redis. O guia de solução de problemas cobre os casos comuns.
Lista para produção
O arquivo do Compose está afinado para começar. Antes de colocá-lo num domínio público:
- Faça o build do frontend de produção. O Compose usa por padrão o target
developmentcom recarga a quente e montafrontend/srcno contêiner. DefinaFRONTEND_BUILD_TARGET=runnereNODE_ENV=productionem.enve depois tire as montagens do código com o override abaixo. - Encerre HTTPS num proxy reverso (Caddy, nginx, Traefik) na frente da porta do frontend.
- Exponha o backend para envios. Com
BACKEND_AUTH_SECRETdefinido, os navegadores enviam arquivos de vídeo direto paraNEXT_PUBLIC_API_URL. Aponte isso para uma URL HTTPS pública do backend e adicione a origem do frontend aCORS_ORIGINS. - Defina a origem pública em todo lugar:
NEXT_PUBLIC_APP_URL,BETTER_AUTH_URLeCORS_ORIGINS. ValoresNEXT_PUBLIC_*entram no build, então refaça o build do frontend depois de mudá-los. - Mude a senha do banco de dados.
docker-compose.ymldeixasupoclip_passwordfixo em quatro lugares:POSTGRES_PASSWORDno serviçopostgreseDATABASE_URLnos serviçosfrontend,backendeworker. Editar sóPOSTGRES_PASSWORDem.envnão muda nenhum deles. Sobrescreva os quatro, como mostrado abaixo. - Defina
REDIS_PASSWORD; o contêiner do Redis ativa AUTH quando o valor não está vazio. - Feche os cadastros com
DISABLE_SIGN_UP=truese a instância for só para a sua equipe. - Revise os limites:
MAX_VIDEO_DURATION(padrão 5400 s, 90 minutos) eMAX_VIDEO_UPLOAD_BYTES(padrão 4 GB).
services:
frontend:
volumes: !reset [] # the runner image already contains the buildPara a senha do banco, coloque um valor novo em POSTGRES_PASSWORD dentro de .env. Gere com openssl rand -hex 24, porque hexadecimal não precisa de escape dentro de uma URL. Depois aponte as quatro configurações para ele no mesmo arquivo de override:
services:
postgres:
environment:
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
frontend:
environment:
DATABASE_URL: postgresql://supoclip:${POSTGRES_PASSWORD}@postgres:5432/supoclip
backend:
environment:
DATABASE_URL: postgresql+asyncpg://supoclip:${POSTGRES_PASSWORD}@postgres:5432/supoclip
worker:
environment:
DATABASE_URL: postgresql+asyncpg://supoclip:${POSTGRES_PASSWORD}@postgres:5432/supoclipO Postgres lê POSTGRES_PASSWORD só quando inicializa um volume de dados vazio. Numa instalação que já tem banco, mudar essa variável não muda a senha real. Troque-a primeiro dentro do Postgres, com o mesmo valor de .env. Depois recrie os serviços para que usem as URLs novas:
docker compose exec -T postgres psql -U supoclip -d supoclip \
-c "ALTER USER supoclip PASSWORD 'your_new_password'"
docker compose up -ddocs/configuration.md lista cada variável, e docs/setup.md cobre portas personalizadas e URLs públicas.
Atualizações e backups
init.sql cria o esquema só quando o volume do Postgres é inicializado pela primeira vez. Depois disso, nada atualiza o esquema automaticamente. Se uma versão nova adicionar arquivos em frontend/prisma/migrations ou backend/migrations, aplique-os você mesmo antes de reiniciar o app. Código novo contra o esquema antigo falha por colunas e tabelas faltando. Faça backup primeiro e pare os serviços do app para que não peguem o código novo cedo demais. O frontend de desenvolvimento recarrega a quente o código montado.
docker compose exec -T postgres pg_dump -U supoclip supoclip > supoclip-$(date +%F).sql
docker compose stop frontend backend worker
old=$(git rev-parse HEAD)
git pull
git diff --name-only --diff-filter=A "$old" HEAD -- \
'backend/migrations/*.sql' 'frontend/prisma/migrations/*/migration.sql'Leia cada arquivo listado e aplique-o numa única transação. Aplique migrações do Prisma em ordem de timestamp e as do backend em ordem numérica:
docker compose exec -T postgres psql -U supoclip -d supoclip -v ON_ERROR_STOP=1 -1 \
< frontend/prisma/migrations/<new_migration>/migration.sql
docker compose up -d --buildUm banco criado por init.sql não tem histórico de migrações do Prisma. Não rode prisma migrate deploy nele: o Prisma repetiria cada migração desde a primeira e falharia em tabelas que já existem. Se você quer que o Prisma gerencie as migrações daqui para frente, primeiro faça o baseline com prisma migrate resolve --applied <migration>, mas só para migrações cujas mudanças já estão no seu esquema. O Prisma pula de forma permanente qualquer migração que você marcar como aplicada, mesmo se as mudanças estiverem faltando.
Faça backup também dos volumes clips e uploads se precisar guardar os vídeos renderizados. Nunca rode docker compose down -v numa instância que importa: isso apaga cada volume, inclusive o banco.
Quer personalizar a saída? Coloque fontes .ttf em backend/fonts/ e transições .mp4 em backend/transitions/. Elas aparecem no app automaticamente. Para automação, crie uma chave de API em Configurações e use a API REST ou o servidor MCP incluído.
Perguntas frequentes
O GR6 Hype auto-hospedado é grátis?
O código é grátis sob AGPL-3.0 e o modo auto-hospedado não tem limites de geração nem paywall. Você ainda paga o próprio hardware ou servidor, e qualquer transcrição na nuvem ou uso de LLM que configurar. Uma instalação com Whisper e Ollama evita taxas de IA por pedido, mas precisa de computação local suficiente.
O GR6 Hype roda sem nenhum serviço de IA na nuvem?
Sim, para a análise de clipes. Defina TRANSCRIPTION_PROVIDER=whisper para transcrever localmente e LLM=ollama:<model> para escolher clipes com um modelo local. Baixar links do YouTube ainda precisa de internet; arquivos enviados não. O B-roll opcional usa a API do Pexels.
Preciso de uma GPU?
Não. O modelo .env.example define BACKEND_CPU_ONLY=true, que instala o PyTorch só para CPU. A transcrição do Whisper só com CPU é mais lenta que uma API na nuvem, então vídeos longos demoram mais em hardware modesto.
Funciona em Apple Silicon?
Sim, com uma ressalva: as imagens de backend e worker rodam como linux/amd64 sob emulação. BACKEND_CPU_ONLY=true evita downloads da NVIDIA, mas não ativa a aceleração da GPU da Apple.
Como mantenho a minha instância privada?
Crie sua conta, depois defina DISABLE_SIGN_UP=true e recrie o contêiner do frontend. O Compose prende cada porta a 127.0.0.1, então nada fica público até você adicionar um proxy reverso.
Teste com uma gravação que você conhece bem.
Use o app hospedado ou rode o mesmo código aberto na sua máquina.
Continue lendo
Código aberto
Um clipper de vídeo de código aberto que você controla
O que a auto-hospedagem muda em controle, provedores de modelo e infraestrutura.
LerComparação
GR6 Hype vs OpusClip: uma comparação com fontes
Modelo de preço, implantação, marcas d'água e fluxo de trabalho, com cada afirmação ligada a uma fonte.
LerDo YouTube para Shorts
Reaproveite vídeos longos do YouTube em Shorts
Um fluxo prático para escolher, legendar, reenquadrar e revisar clipes.
Ler