Parolar
Documentação · Parolar

Simulador de comportamento em redes sociais

O Parolar é um instrumento de ensaio: você escreve um post, ele mostra a reação provável — quem reage, em que tom, com que alcance e quanto vira silêncio — e te diz na cara quando não sabe. Roda no seu computador, de graça. E as reações não são chute de IA: vêm de um modelo calibrado em dado real (3.352 árvores de discussão, 262 mil comentários).

Calibrado em
262k comentários
Núcleo
Leis + resíduo
Execução
Offline / CPU
Código
Aberto
01

O que você faz com ele hoje

Tudo gira em torno de um trabalho: ensaiar uma mensagem antes de publicar. Você escreve, escolhe a rede, e a reação se forma na sua frente — no seu computador, de graça. Concretamente, o que já funciona:

  • 01
    Reação provávelApoio, crítica ou neutro, em proporção e com banda de erro.
  • 02
    As reações escritasO texto que as pessoas provavelmente escreveriam — você pega a objeção antes de tomar na cara.
  • 03
    O silêncio medidoQuanto da rede simplesmente ignora — separa “repercutiu” de “teve três respostas”.
  • 04
    Alcance × opiniãoSe espalha muito mas convence pouco, ou o contrário. As duas coisas em separado.
  • 05
    Alerta de tom divisivoQuando o assunto tende a rachar a audiência — um aviso de risco antes da hora.
  • 06
    Fôlego no tempoSe a mensagem tem vida de dias ou é um estouro de minutos.
  • 07
    Comparar A/BDuas versões do post, com pré-registro para a métrica não ser reescrita depois.
  • 08
    Física por plataformaX, Reddit e TikTok reagem diferente — medido. Escolher a rede muda o resultado, e ninguém mais tem isso calibrado.
  • 09
    Laudo + recibo auditávelResultado rápido no alto; grafo, prova e fontes embaixo, para conferir.
  • 10
    ExportarArquivo HTML, PDF com o recibo (precedentes, similaridade, fontes) e JSON — dá para levar a um cliente ou arquivar.
  • 11
    A recusa honestaQuando não há base, ele responde “sem precedente” e o selo de confiança marca frágil. Ele te avisa quando não confiar — é funcionalidade, não defeito.
  • 12
    Roda offline, na CPU, de graçaUm botão, privado, no seu notebook. A MatrAIx precisa das big labs; o Parolar roda no seu computador.
Interface completa do Parolar em uso: grafo da cascata à esquerda, reações escritas à direita, métricas no rodapé.
Fig. 1 — o Parolar em uso: à esquerda a rede reage, ponto a ponto; à direita, o texto que cada pessoa publicaria; em baixo, o tom da rodada, o alcance e a fração em silêncio.
Onde é forte de verdade

Em copy de marca e consumo — o único terreno com prova dura: +79% de skill sobre a baseline. Uma agência testar duas versões e pegar a objeção antes = valor real, hoje.

O limite honesto

Político não — hoje perde para um chute trivial. Não é bola de cristal — dá probabilidade com banda. Fora da bolha (r/brasil) a confiança cai — e ele te avisa quando não sabe.

Em uma frase

O Parolar é um instrumento de ensaio: você escreve, ele mostra a reação provável — com o texto das reações, o alcance, o silêncio e o risco — e te diz na cara quando não sabe. Roda no seu computador, de graça.

02

Para que serve, na prática

O Parolar responde a uma pergunta cara de errar: “se eu publicar isto, o que acontece?” Comunicação, marca e pesquisa usam para ensaiar antes de gastar alcance real.

  • A
    Ensaiar antes de publicarVer a reação provável de uma campanha ou comunicado sem queimar a publicação real.
  • B
    Comparar duas versões (A/B)Rodar a mesma ideia em dois textos e ver qual reparte melhor apoio, crítica e silêncio.
  • C
    Separar alcance de opiniãoUma mensagem pode espalhar muito e convencer pouco. As duas coisas aparecem em separado.
  • D
    Ler o que as pessoas escreveriamO texto provável de cada reação antecipa objeções e mal-entendidos que você ainda corrige.
  • E
    Medir o silêncio92% a 99% de uma rede nunca reage. Saber quanto é silêncio separa “repercutiu” de “teve três respostas”.
  • F
    Antecipar tom divisivoO rodapé sinaliza quando um assunto tende a rachar a audiência — risco antes da hora.
03 · O núcleo

O modelo de comportamento

O coração do Parolar aprende como a sociedade age — reação, ação, tempo, prole — e nunca como ela fala. Treinar num texto cru seria imitar a superfície e errar a variância entre grupos. Em vez disso, o comportamento é descrito em três camadas, da mais interpretável à mais cara.

Arquitetura do núcleo · por região e plataformaprevisão = Leis + resíduo
LEIS DE REAÇÃO Camada interpretável, nunca apagada. Empirical-Bayes com recibo (lei, peso, N). Respondem SEMPRE, com banda. Hoje: 31 leis ativas. 31 CANDIDATO NEURAL Aprende o RESÍDUO das Leis: previsão = Leis + correção, com shrinkage de volta às Leis. Lê o texto; alvo = reação medida, nunca o próximo token. GATE PÚBLICO · POR TEMPORADA O candidato só existe se vencer Leis + baseline no held-out temporal, em público. Se quebrar ou mentir, degrada para as Leis.
Fig. 2 — a previsão final é sempre Leis + resíduo. As Leis são o chão auditável e a régua pública; o candidato neural só entra pela porta do gate. Fonte: DECISAO_NUCLEO_COMPORTAMENTAL, engine/leis.py.

Sobre o que as Leis operam

Cada lei é um deslocamento em log-odds da reação, ancorado num prior global e encolhido pelo N que o sustenta (uma lei só é publicada com ≥8 threads de suporte; peso pleno com 400 comentários). Elas não olham as palavras exatas — olham características do estímulo:

eixo — a pauta temática valência — ataque · neutra · defesa transgressão — baixa · média · alta ator — quem fala campo — o campo em disputa

A saída de uma lei é uma distribuição de reação (apoio/crítica/neutro) com retração pelo tamanho da evidência: quanto menor o N, mais a previsão recua para o prior. É o oposto de um chute confiante — a confiança cresce só quando os dados a autorizam.

04 · Dinâmica

A matemática da cascata

A propagação não é desenho: é um processo de ramificação (Galton-Watson) com prole medida em árvores reais. Cada reação gera um número aleatório de reações-filhas; como a média fica abaixo de 1, a cascata é subcrítica — cresce, satura e morre. O interesse é medir como ela morre.

Distribuição de prole medida · pₖ (nº de filhos por reação)μ = 0,559 · subcrítico
65,8%0 filhos 24,8%1 5,7%2 1,9%3 1,8%4+
Fig. 3 — dois em cada três nós não geram nenhuma resposta; a cauda longa (até 383 filhos observados) é o que faz alguns assuntos explodirem. Média μ = 0,559, variância 2,93. N = 1.416.683 comentários. Fonte: engine/ramificacao.py, cascata_ativa.json.
Nós de perto: um nó-pai lança um leque de reações-filhas — a ramificação da cascata.

A ramificação, de perto

Cada nó-pai lança um leque de filhos — é a prole. Onde muitos filhos pegam, um nó vira sub-hub e o assunto se aprofunda; onde a prole seca, o ramo morre. Ampliado, vê-se cada nó (a cor é o tom da reação) e a aresta que liga cada reação a quem a gerou.

Fig. 3b — um trecho da mesma cascata, ampliado: dois sub-hubs e seus leques de reações-filhas.

Sobre esse processo, o motor aplica saturação de população finita (a prole encolhe conforme o público exposto-mas-calado seca), um teto de profundidade (Vosoughi 2018) e bandas por Monte Carlo (percentis p5/p95 sobre 400 réplicas). Para multidões grandes, um teorema central do limite declarado soma a prole por aproximação normal — é o que deixa 1 milhão de expostos → ~41 mil comentários caber num piscar de olhos, na CPU.

Ramificação

Galton-Watson

Prole empírica, subcrítica (μ<1). Decide quantas reações cada reação gera.

Caminho

Attachment · Gómez 2013

φ = α·grau + β·[raiz] + τ^idade. Decide a quem cada reação se liga (α = 0,41, τ = 0,998).

Alcance

R · Daley-Kendall

R por janela de 12h = filhos ÷ ativos. R ≥ 1 viraliza; R < 1 morre.

As contas, na tela

Nenhuma é opinião — são as equações que o motor roda, com os parâmetros medidos nos dados. Aqui também ficam claros os dois termos técnicos da interface: o R (viralização) e a margem de erro.

μ = Σₖ k·pₖ = 0,559
Prole média. Quantos filhos, em média, cada reação gera. Como μ<1, a cascata é subcrítica: sempre morre — a questão é como.
R = filhos ⁄ ativos  →  R ≥ 1 viraliza
Viralização (R). Quantas reações cada reação puxa numa janela de tempo. Acima de 1 o assunto cresce; abaixo, esvazia.
φ = α·grau + β·[raiz] + τ^idade
Ligação (Gómez 2013). A chance de uma nova reação se prender a um nó — pelo quanto ele já tem de respostas, se é a raiz, e pela idade.
N(t) = N_pico · e^(−ln2 · Δt ⁄ t½)
Decaimento no tempo. Como o volume cai depois do pico. é a meia-vida: o tempo para cair pela metade.
±pp = 1,96 · √( p(1−p) ⁄ n )
Margem de erro. A incerteza que vem de simular uma amostra de n = 2.000 pessoas — em pontos percentuais (pp).
05 · Calibração

Onde os números vêm

Nada aqui é inventado. Cada constante nasce de medição própria em dados reais ou de fonte da literatura (autor, ano, número). O parâmetro que ainda não foi medido entra declarado como provisório.

3.352
árvores de discussão reais (r/brasil, Arctic Shift)
262 mil
comentários medidos, com pai e tempo
32
momentos garimpados, 97% de cobertura 2014–2026
~3,3
profundidade média — bate Yu, CSCW 2024

A topologia depende da plataforma

A mesma frase forma figuras diferentes em cada rede — e isso é medido, não estético. A fração de reações que se liga direto ao post (geração 1) vai de uma estrela quase total no X a uma árvore profunda no Reddit. Por isso escolher a arena é obrigatório: o motor não unifica plataformas às cegas.

Fração na geração 1 · por plataformaestrela ↔ árvore
X 98,7% YouTube 77,3% TikTok 59,4% Reddit 55,2% ◄ estrela rasa · árvore profunda ►
Fig. 4 — X é quase pura estrela (98,7% liga-se ao post); Reddit é a árvore mais funda. A gramática de propagação é da rede, não do conteúdo. Fonte: data/calibracao/forma_media_arena.json (YouTube e X com >80% dos comentários com pai medido).

O temperamento também

A propensão a criticar é estável por plataforma e não mudou ao dobrar a amostra — outro motivo para a arena ser um parâmetro, não um detalhe. Reddit é o público mais crítico medido; YouTube, o menos.

Fração de reações críticas · por plataformamedido em 2 coletas independentes
60,3%Reddit 50,5%X 44,8%Instagram 35,9%TikTok 25,3%YouTube
Fig. 5 — o gradiente de temperamento ficou imóvel ao dobrar a amostra (1.030 conversas não-Reddit). Não é ruído: é uma propriedade da plataforma. Fonte: MESA_REDONDA 24/jul; PAROLAR_DOSSIE.
Validação em corpus virgem

Testada num corpus 100% não-político nunca visto (r/conversas, 418 threads), a forma da cascata prevista bateu a medida com JSD de 0,003 na distribuição de gerações. A dinâmica generaliza para fora do que foi calibrado.

06 · O tempo

A evolução temporal — a curva na base

A linha fina no pé do palco não é enfeite: é a vida do assunto no tempo. Ela mostra o volume de reações subindo até um pico e depois caindo — e é o que separa “viralizou” de “morreu em uma hora”.

Volume de reações no temposobe até o pico, decai por meia-vida
pico meia-vida reignição t0+6hD+5D+20
Fig. 6 — a curva sobe em rampa até o pico e decai por exp(−ln2 · Δt / meia-vida). O motor reporta o pico (horas), a meia-vida, a duração relevante (dias) e eventuais reignições — cada uma com o precedente de origem. Fonte: engine/resultado.py; atraso filho→pai lognormal, mediana 0,47h (Reddit) a 1,9h (X).

Na prática: você lê ali se a mensagem tem fôlego de dias ou se é um estouro de minutos. O atraso entre reação e reação foi medido por plataforma — mediana de 28 minutos no Reddit contra quase 2 horas no X — e é o que dá o ritmo dessa curva.

07

O mesmo grafo, duas leituras

Terminada a rodada, um botão alterna a mesma simulação entre dois arranjos. Cada leitura responde a uma pergunta diferente sobre os mesmos nós. Nada é recalculado — muda o arranjo, não o dado.

Modo disperso: a cascata por propagação, cada nó ligado a quem o gerou.
Disperso — por propagação

Como se espalhou. Cada nó preso a quem o gerou. Você lê a estrutura: onde a reação ganhou força, quais respostas viraram focos novos, quão fundo desceu.

Modo agrupado: os mesmos nós em três blocos por opinião — crítica, neutro e apoio.
Agrupado — por opinião

No que deu. Os mesmos nós reorganizados por tom. Você lê o saldo: o tamanho de cada campo e, nos fios que cruzam, quem foi convencido pelo lado oposto.

Fig. 7 — a mesma rodada, dois arranjos. Alcance e opinião são coisas distintas: uma mensagem pode espalhar muito e convencer pouco. Um número só esconde isso; as duas leituras mostram.
08 · Rigor

Como sabemos que os números valem

Enquanto um simulador comum apenas imagina a reação, o Parolar mede o próprio limite e valida cada previsão contra uma baseline honesta — e mostra a conta por inteiro. É essa prestação de contas que dá confiança ao número. Três resultados importam.

1 · O teto do fenômeno

O mesmo texto, mostrado à mesma pessoa em dias diferentes, nem sempre recebe a mesma reação. Medido no próprio dono (150 itens, 3 semanas depois, cego): concordância consigo mesmo de 0,507. Esse é o teto — nenhum classificador honesto o ultrapassa. Um simulador anunciando 0,9 estaria mentindo sobre o problema.

Concordância (κ) · régua de opinião vs teto do fenômeno
0,00,51,0 zona impossível — nem o humano chega teto 0,507 ouvido 0,264 · aposentado leitor contextual 0,392
Fig. 8 — o classificador antigo (“ouvido”) ficava em κ 0,264 e foi aposentado em público; o sucessor, um leitor que vê o comentário no contexto da conversa, chega a κ 0,392 (acurácia 0,70 em 3 grupos), encostando no teto de 0,507. Fonte: METHODS.md.

2 · Ganho sobre a baseline, por domínio

Todo relatório do motor carrega, inseparável, uma baseline honesta (a média da biblioteca, sem esperteza) e o ganho sobre ela por domínio. É onde o produto mais brilha — e onde a próxima versão evolui:

Skill vs baseline (1 − erro/erro_base) · por domínio
0 +79% consumo −13% político
Fig. 9 — em copy de marca de consumo o motor supera a baseline em +79% (o caso de uso mais forte); em pauta política a base ainda empata melhor (−13%), e a gente mostra isso em vez de esconder. Foi esse ponto que guiou a camada seguinte, o resíduo neural. Fonte: engine/backtest.py; STATUS_PAROLAR.
O que o motor faz de único

O motor decide, com precisão validada, quem reage, quando e por qual caminho — o coração do comportamento. A forma milimétrica da cascata a estatística de base ainda descreve tão bem quanto (n = 77), e a gente diz isso abertamente em vez de fingir que prevê cada detalhe. Transparência é o nosso diferencial, não um defeito.

3 · O gate e o pré-registro

Nenhum modelo novo entra sem passar por um tribunal pré-declarado: a regra é escrita e assinada (sha256) antes de ver os resultados, e o candidato só promove se vencer as Leis e a baseline num teste temporal, em público. Predições do mundo real são registradas com carimbo de tempo e conferidas dois dias depois — o acerto e o erro ficam ambos no placar público. É a mesma disciplina que separa medida de teatro: sem esse crivo, até agentes-LLM caros perdem para um baseline TF-IDF trivial.

09 · Saída

Os resultados saem da ferramenta

Toda simulação vira arquivo — para arquivar, comparar, auditar ou levar a um relatório. Nada fica preso na tela. Tudo é gerado no seu navegador, sem servidor e sem link público.

Compartilhável

HTML autocontido

Um arquivo com o post testado, o veredito com as margens de erro, os indicadores (tom, alcance projetado, pico, viralização), a curva temporal e o feed de reações. Abre em qualquer navegador.

Comparação A/B

Duas versões + deltas

Dois vereditos lado a lado, o delta B−A com IC95, a manchete “versão X sai melhor” — e um pré-registro (experimento + sha256) para a métrica não ser reescrita depois.

Relatório auditável

PDF com o recibo

Imprimível, com os precedentes usados (similaridade, peso, fontes), o nível de confiança, a população sintética e a física de arena medida. O caminho inteiro até o número.

JSON & boletim

Dados e prova do modelo

Export .json da simulação para reprocessar, e o boletim do modelo (/api/prova) com backtest, retrodição e o placar das predições pré-registradas.

10 · Uso

Rodar na sua máquina

Um comando, dois modos. O demo mostra o produto inteiro sem baixar nenhuma IA. O completo sobe o modelo sozinho e libera simular o que quiser — tudo offline, na CPU.

Demo — em 2 minutos

terminal
# zero IA, zero download além da imagem
docker compose up

# abra no navegador
http://localhost:8123

Completo — simule o que quiser

terminal
# sobe o modelo junto e baixa sozinho
docker compose --profile full up

# 1ª vez baixa o modelo; depois sobe direto

Escolha sua IA

O motor usa um LLM só para dois trabalhos estreitos (ler o estímulo e escrever as vozes). Quatro caminhos, do “só olhar” ao “minha nuvem”:

  • A
    Só quero verdocker compose up — o demo (replay), zero IA, zero chave, zero setup.
  • B
    Usar de verdade, sem instalar IAdocker compose --profile full up — baixa um modelo local sozinho na 1ª vez. Offline, sem chave.
  • C
    Já tenho OllamaAponte o .env pro seu: PAROLAR_LLM_BASE_URL=http://localhost:11434/v1, modelo gemma4:e4b. É o padrão.
  • D
    Prefiro a nuvemOllama Cloud ou qualquer endpoint OpenAI-compatible: troque as 3 linhas PAROLAR_LLM_* no .env (URL, chave, modelo).
01

Escreva e escolha a arena

A arena é obrigatória — cada plataforma tem topologia, temperamento e física próprios.

02

Assista à cascata

O grafo cresce ao vivo, com banda de incerteza; a curva no pé mostra o assunto subir e morrer.

03

Leia o laudo — ou desça e audite

Resultado rápido no alto; grafo, prova e recibo embaixo, para conferir cada número.

04

Extraia e atualize

Exporte HTML, A/B, PDF ou JSON. Atualizar troca o motor e preserva o que a sua instância aprendeu.

11 · Uso

Código aberto, por método

Um instrumento de medida que não se pode inspecionar é um oráculo. O Parolar é aberto porque a única forma de confiar num número é abrir a máquina que o produziu, contestar o mecanismo e ver as falhas ao lado dos acertos. O modelo é publicado à parte, sob licença aberta, sem dado bruto.

Roda offline, na CPU Seus dados ficam com você Mecanismo auditável Método aberto e auditável