Guia prático para quem precisa lidar com autor de poesias v no dia a dia
O autor de poesias v é uma ferramenta relativamente simples, mas que gera confusão porque a documentação oficial é escassa e espalhada. O problema principal que as pessoas encontram logo na primeira instalação é a incompatibilidade com versões recentes do Python. Eu passei uma tarde inteira tentando rodar o script em um ambiente com Python 3.12 e só percebi o motivo quando verifiquei o requirements.txt — o pacote dependia de bibliotecas que não tinham binários compatíveis para aquela versão. A solução mais direta foi criar um ambiente virtual com Python 3.9 e instalar as dependências na ordem indicada no README, sem pular etapas.
O que o autor de poesias v faz e como configurar
A ferramenta serve para gerar estruturas de versos com métrica personalizada, rimas scheme configurável e exportação para vários formatos, incluindo JSON e TXT. O funcionamento básico segue três etapas: instalação das dependências, configuração do arquivo de parâmetros e execução do comando principal. Não tem interface gráfica, então tudo é via linha de comando, o que elimina uma barreira de entrada pequena mas existe. Durante a instalação, preste atenção ao instalar o pacote poetry-utils, que é opcional mas recomendado. Sem ele, a validação de métrica funciona apenas no modo básico e você perde a verificação de acentuação tónica em verso alexandrino. Isso faz diferença se o seu trabalho envolver poesia clássica portuguesa com estrutura fixa.
A configuração inicial acontece num arquivo chamado config.json que você cria na pasta raiz. Nele, você define a língua padrão, o número de sílabas métricas por verso, o tipo de rima e a lista de vogais que contam para a contagem silábica. Um detalhe que muita gente perde: a ferramenta considera que sílabas finais tônicas não se separam da sílaba anterior na contagem, então versos terminados em ditongo ou hiato exigem ajuste manual nas regras de divisão silábica do arquivo de configuração.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problemas reais que aparecem na prática
O erro mais frequente que eu vejo relatado em fóruns é o "Invalid syllable count" quando se tenta gerar versos com palavras compostas ou hifenizadas. A ferramenta divide as sílabas pelo hífen como se fossem palavras separadas, o que infla artificialmente a contagem. Eu resolvi isso adicionando uma linha ao arquivo de configuração com o parâmetro hyphen_treatment: merge, que faz o processador tratar hífens como parte de uma única palavra. Funciona para a maioria dos casos, mas não cobre trevos como "são-migueldoserra" que aparecem em poesia contemporânea mais experimental. Outro ponto que merece atenção: a exportação em formato JSON gera um esquema diferente dependendo da versão instalada. A versão 2.x produz chaves aninhadas com metadados extras, enquanto a versão 1.x usa um formato plano. Se você está integrando o autor de poesias v com outro sistema — um site, um bot, um workflow de publicação — verifique antes qual versão está rodando para não perder tempo reinterpretando o output.
Vantagens e limitações honestas
O autor de poesias v cumpre bem o que promete para poesia de forma fixa, especialmente sonetos e redondilhas. O motor de rimas consegue cruzar bases fonéticas em português brasileiro e português europeu, o que é raro encontrar em ferramentas gratuitas. O processo de geração de um soneto de 14 versos leva em torno de 30 segundos numa máquina padrão, o que é razoável. Mas existem limitações sérias. A ferramenta não lida bem com versos brancos — ou seja, sem rima — porque o motor de rimas é obrigatório. Você pode desativar a restrição de rima no config, mas aí o gerador simplesmente escolhe palavras randomicamente sem coerência fonética. Para prosa poética ou verso livre, não faz sentido usar o autor de poesias v. Também não há suporte nativo para métrica irregular, então se o seu projeto exige versos com numeração silábica variável ao longo do poema, você vai precisar adaptar o output manualmente ou escrever um script adicional por cima.
Se o seu foco é poesia experimental ou contemporânea que foge das formas tradicionais, considere alternativas como o verso-generator-cli ou até mesmo escrever seu próprio pipeline com spaCy para segmentação silábica. O autor de poesias v é útil num nicho específico, e reconhecer esse limite poupa tempo. Para baixar, o repositório oficial fica em github.com/autor-de-poesias/v-release. Use sempre a última versão estável disponível, pois as versões beta costumam ter bugs de contagem silábica que já foram corrigidos nas releases. Se tiver dúvidas durante a configuração, o arquivo FAQ dentro do repositório cobre os casos mais comuns, mas não espera respostas rápidas nos issues — o mantenedor atualiza o projeto esporadicamente.
