vvv (Viral Video Visualizer)
o_problema
Fazer vídeo curto com IA é barato por tentativa e caro no conjunto. Cada prompt errado é uma chamada paga, um personagem que muda de rosto entre cenas estraga a história, e um vídeo de produto que mostra algo diferente do produto real é uma oferta enganosa. As falhas que mais custam são as que parecem sucesso.
o_que_faz
- Video intelligence: detecção de cena, extração de keyframes, transcrição local e análise visual, escolhendo frames representativos em vez de mandar todo frame para um modelo.
- Story intelligence: uma história original construída a partir da estrutura da referência (gancho, open loops, virada, desfecho), com character e visual bibles fixando o que não pode mudar entre cenas.
- Dois prompts por cena: o de imagem define o estado visual, o de animação o que muda no tempo.
- Montagem medida: clipes devolvidos são decodificados e cronometrados, a narração é transcrita de volta contra o roteiro e checada contra deriva de voz, e o corte é unido com os níveis igualados.
- Uma faixa de TikTok Shop Brasil: vídeos de produto barrados por checagens de produto, alegação e compliance, e um cliente da Affiliate Creator API do TikTok Shop, acionado pelo operador ou por agendamento.
- Um portão de pré-publicação que mede o vídeo final, rotula cada achado como verificado ou atestado, e nunca publica sozinho.
stack
backend
Python 3.11+ · Go 1.25 · Typer · Pydantic 2 · SQLAlchemy 2 · PostgreSQL 16
infra
GitHub Actions · Terraform
outros
OpenCV · faster-whisper · Anthropic SDK · Model Context Protocol · pytest · GitHub Spec Kit
medido
- Specs
- 37specs/, 03/07/2026 a 27/09/2026
- Contratos machine-readable
- 28schemas/, um JSON Schema por shape persistida
- Funções de teste
- 1782tests/, Python, 27/09/2026; mais 21 em Go
- Comandos da CLI
- 71src/h3v/cli.py, 27/09/2026
- Portão de lint
- 9.9 / 10fail-under do pylint, exigido no CI
como_foi_construido
Spec-driven: 37 specs, cada uma com spec, plano e tarefas. A camada de pipeline orquestra, um módulo por comando seguindo ler, checar, escrever; os pacotes de domínio ao lado não tomam decisão de I/O; toda shape persistida tem um contrato JSON Schema.
O `record` não aceita resultado reportado como verdade. Um clipe reportado como completo é decodificado antes: arquivo que não é vídeo legível vira ausente, e o que é tem a duração medida gravada no lugar da declarada. A regra existe porque o primeiro render plan gravou um PNG como vídeo pronto, e um exists-check acreditou.
Um launcher nativo em Go abre o harness interativo em milissegundos e roda o worker de publicação agendada, que segura um lock de instância única e nunca dispara um job atrasado; todo outro comando passa para a CLI em Python.
limitacoes_conhecidas
- Sem comando fim a fim, de propósito: três estágios fazem chamada paga a modelo, então a cadeia é conduzida estágio a estágio.
- A conta de storytelling é publicada à mão, depois que o portão reporta pronto.
- O caminho de publicação no TikTok Shop está construído e testado contra um cliente falso; nenhum post real foi registrado ainda.
- Resultado remoto sem arquivo local é gravado como reportado, não como medido.
- Só local, a partir de um repositório privado; não é oferecido ao público.
tempo de código rastreado
127 hrs 15 mins Fonte: WakaTime · rastreado desde 2026-03-17 até 2026-09-22