h0wzy

vvv (Viral Video Visualizer)

antigo viralvideogen

produto próprio funcional, sem deploy

2026-07-03 → 2026-09-27 · 338 commits

ShowcaseO resumo desenhado: o que faz, a regra por trás, e as duas contas que atende.
abrir showcase →

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

← voltar para todos os trabalhos