vvv · repositório privadoantigo viralvideogen
Entra vídeo. Sai original. Tudo medido no caminho.
O vvv (h3v na linha de comando) analisa um vídeo de referência e produz um pacote original e pronto para produção: a história, suas character e visual bibles, prompts de imagem e animação, narração, um corte medido e sua legenda. Atende uma conta de storytelling nos EUA e uma loja no TikTok Shop Brasil, e nunca acredita num resultado que não mediu.

Seis figuras da mitologia, seis apps que quero construir.
Em volta do pipeline estou desenhando uma família de seis apps. Cada um ganha uma figura da mitologia grega e uma cor de assinatura, em gravura clássica com textura de impressão em dither sobre um azul-marinho profundo.
Escolhi a mitologia porque cada figura já tem um ofício. Hermes leva as coisas de lá pra cá, Orfeu faz som, Atlas carrega o peso. Por enquanto é direção visual e conceito: os apps estão em desenvolvimento, e o pipeline acima é a parte que existe hoje.

Status: direção visual e conceito, em desenvolvimento. As linhas abaixo dizem o que cada app pretende fazer, não o que já roda.

VVV Video EditorTimeline, cortes, transições e narração. Hermes leva coisas de um lugar a outro, que é o que um corte faz.

VVV Effects StudioEfeitos visuais, composição e máscaras. Hécate guarda a encruzilhada, onde uma imagem vira outra.

VVV Audio StudioEdição, mixagem, sound design, voz e trilhas. Orfeu movia o mundo com uma lira.

VVV 3D StudioModelagem, malhas, materiais, cenas e assets 3D. Hefesto é o deus da forja.

VVV Media LibraryBusca, organização e gestão de mídias. Mnemosine é a memória, e uma biblioteca é onde a memória mora.

VVV CloudSincronização, armazenamento, backup e colaboração. Atlas segura o céu inteiro para o resto ficar no lugar.
Um comando por estágio, três passos humanos.
Não existe comando único da referência ao post, de propósito. Cada estágio escreve um arquivo que o próximo checa, e três passos continuam humanos: escrever a história, gerar a mídia pelas ferramentas MCP que um agente chama, e decidir publicar.
h3v analyze ./reference.mp4# mapa de cenas, keyframes e transcrição, sem mandar todo frame para um modeloh3v draft promote ./story_idea.json# uma história escrita no chat entra aqui, validada e sem custoh3v validate ./tiktok_project.json# schema, linha do tempo e prompts, checados offline antes de gastar um créditoh3v render ./tiktok_project.json# a lista ordenada de jobs; o agente executa cada um via MCPh3v verify-narration ./tiktok_project.json --plan ./render_plan.json# cada clipe transcrito de volta e comparado com sua fala, e sua voz com as demaish3v concat ./tiktok_project.json --plan ./render_plan.json# um arquivo, níveis igualados, legendas gravadas na conta de storytellingh3v publish check ./tiktok_project.json --video ./final.mp4 --profile ./publishing_profile.json# pronto ou bloqueado, cada achado marcado como verificado ou atestado; nunca publica
Seis estágios, cada um checado antes do próximo.
#1 analisar
Ler a referência
Mudanças de cena, similaridade visual e limites da transcrição escolhem os frames que valem ser vistos. O que se extrai é a estrutura: ritmo, beats, arquétipos, a virada.
#2 escrever
Escrever uma história original
A referência empresta a mecânica, nunca o enredo: um gancho novo, open loops, uma virada entre 55% e 75% da duração, um desfecho e uma moral.
#3 fixar
Fixar quem é quem
Uma character bible guarda o rosto, a idade e o figurino de cada personagem; uma visual bible guarda a luz, a lente e a paleta. Todo prompt as reusa palavra por palavra.
#4 descrever
Dois prompts por cena
O prompt de imagem define o estado visual; o de animação define o que muda no tempo. Juntar os dois é como os personagens derivam.
#5 gerar
Gerar pelo agente
O h3v planeja os jobs e registra o que volta; o agente chama os modelos de imagem e vídeo via MCP. O h3v não guarda credencial de provedor, então não pode fingir que chamou um.
#6 montar
Montar o que foi medido
Clipes são decodificados e cronometrados, a narração é lida de volta, os níveis são igualados, as legendas são gravadas, e um portão diz pronto ou bloqueado antes de alguém publicar.
Um resultado é medido antes de ser acreditado.
Provedores de IA reportam sucesso com generosidade. Um job marcado como completo pode apontar para uma imagem em vez de um vídeo, um clipe pode voltar mais curto do que foi pedido, e um take pode dizer as palavras certas com a voz de outro ator. O primeiro e o último caso aconteceram aqui, antes de existir uma checagem para eles.
- O `record` decodifica todo arquivo devolvido. O que não é vídeo legível vira ausente; o que é tem a duração medida gravada no lugar da declarada.
- O `assemble` soma durações medidas, não pedidas, e avisa quando a diferença passa de um segundo.
- O `verify-narration` transcreve cada clipe localmente e compara com sua fala, depois sinaliza o clipe cujo pitch mediano se afasta dois semitons do corte, e bloqueia a partir de três.
- O `compose verify` mede quanto uma foto de produto mudou dentro da região que o modelo foi instruído a preservar, porque o produto num vídeo de Shop tem de ser o real.
- O `publish check` rotula cada achado como verificado, quando mediu o próprio arquivo, ou atestado, quando uma pessoa afirmou. Apresentar um como o outro seria verificação fabricada.

Um pipeline, dois negócios diferentes.

Storytelling nos EUA
Histórias emocionais de 65 a 90 segundos em inglês americano nativo, montadas a partir de clipes curtos. O espectador paga com atenção, e o vídeo termina quando ele sente algo. É publicado à mão, depois que o portão diz pronto.
TikTok Shop Brasil
Vídeos de produto em português que precisam mostrar o produto real, até a marca impressa nele, e terminar num pedido claro. Passam por checagens de produto, alegação e compliance; o caminho de publicação usa a API do próprio TikTok Shop (upload, a pré-checagem do TikTok, post, status) e está construído e testado, sem post real registrado ainda. Numa LIVE, a máquina prepara o apresentador e nunca fala.
Contado, não lembrado.
Contado no repositório em 27/09/2026. O registro do projeto mostra os mesmos números.
- 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
O que se pergunta primeiro.
O código é público?
Não. O repositório é privado, então esta página resume o que o projeto faz e não aponta para nada dentro dele. O registro do projeto tem o relato mais longo, e os números daqui foram contados no próprio repositório.
Ele publica sozinho?
Não na conta de storytelling: o portão reporta pronto ou bloqueado, e uma pessoa publica. Na conta de Shop, o caminho pela API do TikTok está construído e testado contra um cliente falso; só roda quando o operador confirma ou agenda um job, e nenhum post real foi registrado ainda.
Por que não existe um comando único do vídeo ao post?
Três estágios fazem chamadas pagas a modelos, e uma cadeia que roda de ponta a ponta gasta dinheiro com os próprios erros. Conduzir estágio a estágio põe um arquivo checado, não uma esperança, entre cada passo pago.
Ele promete alcance ou monetização?
Não. Nenhuma hashtag, duração, resolução ou modelo produz alcance, e um vídeo com mais de um minuto não garante pagamento. O pipeline deixa cada tentativa mais barata e mais honesta; o que a plataforma faz depois é com a plataforma.
ler a página do projeto · política de privacidade deste app · termos de serviço deste app