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.

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

ler a página do projeto

Gravura, branco sobre preto: uma musa coroada de louros flutua na diagonal, puxando dois feixes de linhas retas que viram tiras de filme, diante de uma grade de fotogramas e de um halo de raios finos.

direção_visual

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.

A prancha da marca VVV sobre azul-marinho: o título The art of making things move, uma gravura de Hermes num painel azul, seis cards de app com suas cores e a paleta sunset.
A prancha da marca, como está desenhada até agora.

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

  • Gravura de Hermes em voo, capacete e sandálias aladas, um caduceu na mão, panejamento azul.

    Ícone do VVV Video Editor: Hermes de capacete alado sobre um quadrado azul.VVV Video Editor

    Hermes#2462F4

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

  • Gravura de Hécate, a deusa tripla, coroada, com tocha e lua crescente.

    Ícone do VVV Effects Studio: a deusa tripla Hécate sobre um quadrado magenta.VVV Effects Studio

    Hécate#F22996

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

  • Gravura de Orfeu coroado de louros, segurando uma lira.

    Ícone do VVV Audio Studio: Orfeu com uma lira sobre um quadrado verde-azulado.VVV Audio Studio

    Orfeu#15CDBB

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

  • Gravura de Hefesto, musculoso, martelo erguido, trabalhando na forja.

    Ícone do VVV 3D Studio: Hefesto na forja sobre um quadrado roxo.VVV 3D Studio

    Hefesto#8C57F6

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

  • Gravura de Mnemosine coroada de folhas, segurando livros e pergaminhos.

    Ícone do VVV Media Library: Mnemosine com livros sobre um quadrado verde-limão.VVV Media Library

    Mnemosine#A4E635

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

  • Gravura de Atlas ajoelhado sob um globo celeste nos ombros.

    Ícone do VVV Cloud: Atlas carregando um globo celeste sobre um quadrado laranja.VVV Cloud

    Atlas#FF5D33

    Sincronização, armazenamento, backup e colaboração. Atlas segura o céu inteiro para o resto ficar no lugar.

o_pipeline

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

o_que_faz

Seis estágios, cada um checado antes do próximo.

  1. #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. #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. #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. #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. #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. #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.

a_regra

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.
Gravura, branco sobre preto: Láquesis, a Moira que mede, sentada de perfil, apoia um compasso numa tira de filme que atravessa a imagem inteira.

duas_contas

Um pipeline, dois negócios diferentes.

Gravura, branco sobre preto: um busto de Jano, de duas faces, num arco de pedra, uma olhando para a esquerda e outra para a direita, cada uma lançando um feixe de raios para a sua borda.

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.

medido

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

perguntas

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