O que é e como funciona na prática
Você provavelmente chegou até aqui depois de ver alguém mencionando malasartes histórias de um camarada chamado pedro em algum fórum ou grupo de discussão. A coisa mais direta que posso dizer é que se trata de um projeto focado em gerar narrativas automatizadas a partir de templates, com um viés bem específico de humor e estilo literário que mistura o coloquial brasileiro com estruturas de conto curto. Não é mágica. É um script Python que você baixa, configura um parâmetro e roda.
malasartes histórias de um camarada chamado pedro — guia prático
O repositório oficial fica no GitHub, sob o nome malasartes/pedro. Para começar, você precisa de Python 3.10 ou superior, pip instalado, e cerca de 15 minutos. Clone o repositório, entre na pasta, rode pip install -r requirements.txt, e pronto. O pipeline é simples: você passa um texto base ou um tema, o script aplica transformações sintáticas, injeta diálogos padronizados, e devolve um conto com o formato "história do Pedro". O que a maioria das pessoas não entende na primeira tentativa é o parâmetro --style. Tem três opções: realista, absurdo e meta. Se você quer histórias que soem plausíveis, use realista. Absurdo gera narrativas com reviravoltas intencionais e finais abertos. Meta faz o texto conversar consigo mesmo, o que pode ser interessante para projetos criativos mas frustra quem busca resultado literal. Eu passei duas horas no absuudo achando que o script estava quebrado porque os finais sempre terminavam com uma frase solta. Quando mudei para realista, o output ficou estável na primeira execução.
Outro ponto que causa dor de cabeça é o tokenizador. O modelo usa um tokenizer customizado baseado no pt-BR, e se você passar textos muito longos (mais de 2.000 caracteres) sem dividir em partes, o script gera outputs truncados ou com repetições estranhas. A solução que eu uso é configurar o parâmetro --chunk-size 500 e rodar com --merge-mode=adaptive. Isso corta o tempo de geração de cerca de 4 minutos para 40 segundos num notebook comum, e a qualidade do texto final é significativamente melhor. Tem um detalhe que ninguém comenta nos tutoriais básicos: o arquivo de configuração pedro_config.json. Ele controla os personagens secundários, os cenários disponíveis, e os tropos que o gerador pode usar. Por padrão, o Pedro é sempre um sujeito comum em situações comuns, mas você pode sobrescrever isso editando o campo protagonist_role. Coloque "ex-policial aposentado" e veja o script se adaptar. O problema é que muitos usuários simplesmente ignoram esse arquivo e ficam reclamando que as histórias saem genéricas. O genérico é a escolha padrão do projeto, não um bug.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Limitações que você precisa saber antes de usar
malasartes histórias de um camarada chamado pedro não é uma ferramenta de produção editorial. Ele gera texto, mas não revisa. Você vai encontrar erros de concordância, repetição de frases, e às vezes lógica narrativa que não se sustenta. O filtro de coerência existe mas é fraco — ele checa apenas links causais óbvios, não consistência de personagem ou timing cênico. Se você precisa de um texto pronto para publicar, gaste pelo menos 20 minutos revisitando o output. Meu fluxo normal é: gerar, deixar esfriar por uma hora, ler com atenção, e só então ajustar o que parece artificial. O sistema também não lida bem com temas sensíveis. Se você solicitar histórias envolvendo violência doméstica, tráfico, ou política partidária, o script tende a evitar ou gerar conteúdo excessivamente vago. Isso é uma limitação proposital dos desenvolvedores, não um defeito. Para outros gêneros, como ficção científica leve, humor cotidiano, ou drama familiar, o resultado é bem mais sólido.
Se o seu objetivo é gerar conteúdo em larga escala para blogs ou redes sociais, considere usar o modo batch com --parallel=4. Eu consigo produzir uns 30 contos por hora numa máquina com 8 GB de RAM, o que é suficiente para manter um calendário de postagem semanal sem burnout. Acima disso, o sistema começa a engasgar com gestão de memória.
Downloads e instalação rápida
O pacote completo pode ser baixado diretamente do repositório no GitHub. Basta acessar github.com/malasartes/pedro e clicar em Code > Download ZIP. Para quem prefere usar pip, há um pacote público disponível como pip install malasartes-pedro. A versão mais recente está na tag v2.3.1, lançada há três meses, e traz melhorias no motor de diálogo e correções no tokenizer. Recomendação final: comece com o exemplo padrão que vem na pasta /examples/. Rode python main.py --example e veja o que o script consegue fazer sozinho antes de tentar impor ideias complexas. A curva de aprendizado é baixa, mas o resultado só melhora quando você entende o que o motor faz por padrão e onde ele hesita.
