Pyrefly: a nova ferramenta da Meta para Python
Neste post te explicamos o que é o Pyrefly e como funciona a nova ferramenta da Meta que vai transformar o jeito de programar em Python.
A Meta, do Facebook e Instagram, lançou o Pyrefly, uma ferramenta de verificação que acelera o desenvolvimento e melhorar a qualidade do seu código. Ele é rápido, eficiente e se integra perfeitamente no terminal ou em editores como o Visual Studio Code.
Quer saber mais? Resumimos suas principais utilidades aqui embaixo!
O que é o Pyrefly e por que ele facilita a tipagem automática no Python?
O Pyrefly é um verificador de tipos estáticos (type checker) para Python, criado para identificar erros antes que o código seja executado. Você pode usar ele em projetos novos ou já existentes, integrado às principais IDEs, como o VSCode.

A velocidade do Pyrefly é impressionante: testes mostram que ele pode verificar 1,85 milhão de linhas de código por segundo, superando ferramentas como MyPy e Pyre.
Comparação entre Ferramentas
| Ferramenta | Tempo para verificar PyTorch | Tempo para verificar Instagram | Suporte a IDE | Tipagem Automática |
|---|---|---|---|---|
| Pyrefly | 2,4 segundos | 13,4 segundos | Sim (VSCode) | Sim |
| Pyre | >100 segundos | >100 segundos | Limitado | Não |
| MyPy | Mais lento que Pyrefly | Mais lento que Pyrefly | Parcial | Parcial |
Por que isso importa? Porque definir tipos em Python melhora a legibilidade, facilita a manutenção e reduz bugs, especialmente em sistemas complexos como APIs ou aplicações corporativas. O Pyrefly torna esse processo mais rápido e acessível, mesmo para quem não está acostumado a usar tipagem estática.
Principais benefícios do Pyrefly:
- Detecção precoce de erros: Identifica problemas de tipagem durante o desenvolvimento.
- Melhor legibilidade: Tipos servem como documentação viva do código.
- Integração com IDEs: Oferece autocomplete e sugestões em tempo real.
- Suporte a projetos legados: Funciona com códigos sem anotações de tipo.
Como adicionar tipagem automática em arquivos já existentes usando Pyrefly?
Se você tem um projeto Python sem anotações, o Pyrefly pode identificar todos os tipos automaticamente. Por exemplo, imagine um script com variáveis como nome (uma string), lista_arquivos (uma lista de strings) e locais (um dicionário com chaves de string e valores como listas de strings). Sem o Pyrefly, você precisaria definir esses tipos manualmente, o que pode ser trabalhoso.
Com o Pyrefly, o processo é simples:
- Comece intalando a extensão do Pyrefly no VSCode:
- Abra o VSCode, vá até a aba de extensões e pesquise por “Pyrefly”.
- Clique em “Instalar” para ativar a extensão.
- Abra seu arquivo Python no VSCode.
- O Pyrefly automaticamente analisa o código e sugere tipos para variáveis, parâmetros de funções e retornos.
Tipagem em tempo real: como o Pyrefly sugere tipos enquanto você escreve o código?
O Pyrefly sugere os tipos em tempo real enquanto você codifica, o que é útil para desenvolvedores que estão criando novos scripts ou expandindo projetos existentes.
Por exemplo, ao abrir um arquivo com uma variável caminho = "diretorio/teste", o Pyrefly indica que caminho é uma str. Para um dicionário como locais = {"chave": ["valor1", "valor2"]}, ele sugere Dict[str, List[str]]. Isso economiza tempo e garante consistência.
Veja como funciona:
- Exemplo prático: Ao criar uma lista
nomes = ["Lira", "Marcos", "Amanda"], o Pyrefly imediatamente identifica que é umaList[str]. - Dicionários e tipos complexos: Para um dicionário como
salarios = {"Lira": 2000, "Marcos": 5000, "Amanda": 7000}, ele sugereDict[str, int]. - Integração fluida: As sugestões aparecem como dicas visuais no VSCode, e você pode aceitá-las com um duplo clique, sem interromper seu fluxo de trabalho.

Essa funcionalidade é ideal para manter a consistência do código e evitar erros desde o início, especialmente em projetos colaborativos onde diferentes desenvolvedores podem interpretar tipos de maneira diferente.
Como o Pyrefly identifica e corrige erros de tipagem no seu código Python?
Erros de tipagem, como tentar concatenar uma string com um número inteiro, são comuns em Python. O Pyrefly ajuda a evitá-los ao sinalizar problemas diretamente no editor, antes mesmo de executar o código. Por exemplo:
- Cenário: Você escreve
print("Salário do Lira é" + salarios["Lira"])ondesalarios["Lira"]é um inteiro (ex.: 2000). - Alerta do Pyrefly: Ele destaca o erro e explica que o operador
+não suporta concatenarstrcomint. - Solução sugerida: Converta o inteiro em string, como
str(salarios["Lira"]).

Essa verificação em tempo real elimina a necessidade de esperar erros aparecerem na execução ou em pipelines de CI/CD, economizando tempo e reduzindo frustrações.
Verificação rápida: como checar tipagem em projetos Python inteiros usando o terminal?
Para projetos grandes com múltiplos arquivos, o Pyrefly permite verificar a tipagem de todo o codebase pelo terminal, o que é ideal para integração em pipelines de CI/CD ou para revisar projetos legados.
Siga estes passos:
- Instale o Pyrefly via pip:
pip install pyrefly - Inicialize o Pyrefly:
pyrefly initIsso cria um arquivo de configuração (pyproject.tomloupyrefly.toml) e escaneia o projeto. - Execute a verificação:
pyrefly checkO comando analisa todos os arquivos Python no projeto, listando erros de tipagem com detalhes, como o arquivo, a linha e a descrição do problema.
Por exemplo, ao rodar pyrefly check, você pode receber uma mensagem como: “Erro na linha 10 de main.py: não é possível concatenar str com int”. O processo é rápido (ex.: 0,18 segundos para um projeto pequeno) e permite tratar erros individualmente ou suprimi-los com a opção --suppress-errors.
Conclusão: Vale a pena usar o Pyrefly no Python?
O Pyrefly é uma ferramenta que melhora eficiência do Pythjon através da análise de tipagem estática. Sua velocidade, integração com VSCode e capacidade de inferir tipos automaticamente o tornam ideal para projetos de todos os tamanhos, desde scripts simples até codebases complexos como o do Instagram.
Embora esteja em fase alfa, a Meta planeja lançar uma versão beta em breve, com melhorias contínuas baseadas no feedback da comunidade.
Se você trabalha com Python e quer reduzir erros, melhorar a legibilidade do código e acelerar seu fluxo de trabalho, o Pyrefly é uma excelente escolha. Experimente instalando a extensão no VSCode ou usando o comando pip install pyrefly e veja como ele pode transformar seu desenvolvimento.
Quer ver mais guias e dicas com esta? Acesse nossos outros posts sobre python no blog!
E caso prefira esse conteúdo no formato de vídeo, assista aqui embaixo ou acesse o nosso canal do YouTube!
O que você aprende neste vídeo
Resposta rápida: A aula mostra o Pyrefly, verificador de tipos para Python criado pela Meta, em quatro usos: sugerir tipos em um arquivo pronto pela extensão do VS Code, sugerir tipos enquanto o código é escrito, sinalizar erros de tipagem antes de rodar e checar o projeto inteiro pelo terminal com init e check.
Neste vídeo (9 min):
- 0:17 - As quatro funções do Pyrefly em resumo
- 1:40 - O verificador de tipos da Meta e a comparação de tempo com outras ferramentas
- 3:25 - Instalar a extensão do Pyrefly no VS Code
- 3:40 - Tipos sugeridos para as variáveis de um arquivo já pronto
- 4:24 - Tipo identificado na hora, enquanto a lista e o dicionário são criados
- 5:40 - Erro de tipagem sinalizado ao escrever, sem rodar o código
- 6:25 - Arquivo fechado e a necessidade de verificar o projeto pelo terminal
- 7:03 - Primeira verificação do projeto com
pyrefly init - 8:02 - Nova verificação com
pyrefly check, que mostra o arquivo e a linha do erro
Trechos do vídeo:
- Com um arquivo fechado, o Pyrefly não verifica a tipagem automaticamente: para checar os arquivos de um projeto, a aula usa o terminal.
- Depois que o projeto foi inicializado com
pyrefly init, a verificação seguinte é feita compyrefly check: rodarinitde novo avisa que o Pyrefly já foi inicializado. - O sinal de
+não concatena texto com número inteiro, e o Pyrefly aponta isso ao passar o mouse sobre o erro. Para corrigir, o número é transformado em string. - As sugestões de tipo do Pyrefly são só sugestões: um duplo clique escreve o tipo no código.
Hashtag Treinamentos
Para acessar outras publicações de Python, clique aqui!
Posts mais recentes de Python
- Cursor para iniciantes: tutorial completo passo a passoCursor para iniciantes: aprenda a instalar, configurar o modelo, usar os modos Plan e Ask e criar sua primeira automação em Python com IA.
- Agente de IA local com Python: crie o seu com OllamaAprenda a criar um agente de IA local com Python, Ollama e LangChain: rode modelos no seu PC, sem pagar por API e sem expor os dados da empresa.
- Como Criar CRM com Codex no VS Code usando Python e FlaskAprenda a criar CRM com Codex no VS Code usando Python, Flask e SQLite, com login, orçamentos e PDF, em fases com testes e commits no Git.
Posts mais recentes da Hashtag Treinamentos
- ChatGPT para criar fórmulas no Excel: 5 exemplos práticosAprenda a usar o ChatGPT para criar fórmulas no Excel com 5 exemplos práticos de SOMA, SOMASES, SE, PROCV e CONT.SES, e veja como pedir certo e validar.
- Cursor para iniciantes: tutorial completo passo a passoCursor para iniciantes: aprenda a instalar, configurar o modelo, usar os modos Plan e Ask e criar sua primeira automação em Python com IA.
- Claude Artifacts: crie dashboards, slides e sites com IAAprenda a usar o Claude Artifacts para criar dashboards, apresentações e sites com IA a partir de um prompt, com exemplos e prompts prontos para copiar.







