Pós-processamento com IA
VPS Agêntica
Uma VPS para os seus agentes trabalharem dia e noite
Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
O pós-processamento envia a transcrição a um modelo de linguagem antes de colar, para corrigir pontuação, reorganizar em tópicos, traduzir ou aplicar qualquer instrução sua. Ele é experimental, tem atalho próprio e, com um provedor na nuvem, envia o texto para fora do computador, enquanto a transcrição comum continua local.
Sumário da página
Da fala crua ao texto arrumado
A fala tem ritmo de conversa. Você repete uma ideia, volta atrás, fala “vírgula” esperando uma vírgula. O modelo de transcrição escreve o que ouviu. O resultado precisa de uma passada antes de virar um prompt limpo ou uma lista de requisitos. O pós-processamento faz essa passada com um modelo de linguagem, entre a transcrição e a colagem.
A documentação oficial marca o recurso como Alpha. Ele pode corrigir gramática, reformatar o texto, traduzir, inserir pontuação ou aplicar qualquer transformação descrita num prompt. O texto que chega ao campo é a saída do modelo, não a transcrição crua.
Um atalho separado
O pós-processamento fica atrás da chave de recursos experimentais. Na aba Advanced, você liga Experimental Features e depois Post Processing. Uma seção nova aparece na barra lateral das configurações. Ali entram o provedor, a chave de API, o modelo e o prompt.
O recurso tem um atalho próprio. A documentação é clara: só esse atalho aciona o pós-processamento. O atalho comum de transcrição entrega só o texto cru. No macOS, o padrão é Option+Shift+Space. Assim você escolhe, a cada ditado, se o texto passa ou não pelo modelo. O README mostra o comando handy --toggle-post-process para acionar o mesmo modo por linha de comando.
Transcrição local
O modelo de fala transcreve o áudio no computador, como num ditado comum.
Prompt montado
A variável
${output}do seu prompt recebe a transcrição crua.Modelo de linguagem
O provedor escolhido, na nuvem ou local, processa o prompt.
Texto colado
A resposta do modelo é colada no campo ativo e entra no histórico.
Os provedores
A documentação lista provedores na nuvem, um modelo no dispositivo e um endpoint próprio. Na nuvem, aparecem a OpenAI, com o GPT-4o-mini recomendado, a Anthropic, com o Claude Haiku, o OpenRouter, que dá acesso a vários modelos com uma chave só, o Groq e o Cerebras, pela velocidade, além da Z.AI, com o GLM-4.5-Air. A política de privacidade inclui ainda o AWS Bedrock entre os provedores suportados.
No dispositivo, o Apple Intelligence funciona em Macs com Apple Silicon e macOS 26 ou mais recente. O provedor Custom aceita qualquer endpoint compatível com a API da OpenAI. É por ele que entram os modelos locais. Desde a 0.10.0, o provedor Custom também aceita o formato da API Messages da Anthropic, segundo as notas da release.
O prompt e a variável de saída
O prompt é seu. A variável ${output} marca o lugar da transcrição crua, que o Handy substitui antes de enviar. A documentação traz exemplos: corrigir gramática e pontuação sem mudar o sentido nem o tom, converter o texto em tópicos curtos, traduzir para outro idioma e trocar palavras faladas como “ponto” ou “vírgula” pelos sinais. O guia de perguntas frequentes informa que os modelos de fala não aceitam pontuação por comando de voz. O prompt de pontuação é o caminho indicado.
Para o ditado de prompts e specs, um prompt de pós-processamento pode exigir a mesma estrutura toda vez: o objetivo numa frase, os arquivos envolvidos, o comportamento esperado e o que não pode mudar. A fala solta chega ao campo já organizada. Você revisa o conteúdo em vez da forma. A discussão 715 do repositório reúne prompts compartilhados pela comunidade.
Modelos locais pelo LM Studio
Para manter o texto no computador, a documentação descreve o uso de um servidor local compatível com a API da OpenAI. Com o LM Studio, você carrega um modelo, liga o servidor local e aponta o provedor Custom do Handy para o endereço http://localhost:1234/v1. O autor relata bons resultados com o Qwen3 8B e modelos maiores. Ele avisa que modelos acima de 8 bilhões de parâmetros costumam ir bem, mas sem perfeição garantida.
Na nuvem, a recomendação é escolher um modelo razoavelmente capaz. Pelo OpenRouter, a sugestão é um modelo com mais de 20 bilhões de parâmetros.
Os limites
A documentação lista outros limites. O pós-processamento acrescenta espera, porque depende de uma chamada à API ou do tempo de inferência local. Sem internet, os provedores na nuvem falham, mas a transcrição continua funcionando. Modelos com menos de 3 bilhões de parâmetros costumam ignorar o prompt. Modelos de raciocínio podem devolver as marcações do raciocínio no texto colado. Desde a 0.10.0, quando o pós-processamento devolve um texto vazio, o Handy preserva o ditado original.
O recurso é opcional e fica fora do caminho comum. Para prompts curtos, a transcrição crua com uma revisão rápida resolve. Para specs longas ou briefings que precisam de formato fixo, o atalho de pós-processamento entrega o texto pronto para editar. O hub de histórico e privacidade mostra o que fica salvo em cada caso.
Continue na comunidade
Leve ao Discord da Promovaweb o modelo que erra o seu idioma, a colagem que não chega ao terminal ou o prompt ditado que o agente entendeu mal. A versão do Handy e o sistema operacional ajudam a comunidade a entender o caso.