air-verse/air

O que é?

Recursos principais

• 01Recompila e reinicia automaticamente o app Go quando os arquivos mudam
• 02Permite configurar comandos de build e execução via .air.toml ou flags da CLI
• 03Exclui subdiretórios e monitora diretórios recém-criados
• 04Regras de monitoramento executam comandos personalizados para assets ou geração de código
• 05Proxy opcional que recarrega o navegador após cada build
• 06Carrega arquivos .env antes de fazer o build e executar o app

Casos de uso

• Desenvolver um servidor web em Go, como um feito com gin, e recarregá-lo a cada salvamento
• Executar builds de assets do frontend ou etapas de templ/go generate junto com o app Go
• Executar o Air em um contêiner Docker com o projeto montado para ter live reload

Início rápido

1. 1

   Instale o Air com go install (requer Go 1.25 ou superior).

   go install github.com/air-verse/air@latest
2. 2

   Adicione o diretório bin do Go ao PATH.

   export PATH="$PATH:$(go env GOPATH)/bin"
3. 3

   Entre no diretório do projeto e execute air.

   air

Antes de usar

• !O README informa que o Air é apenas para desenvolvimento e não tem relação com hot-deploy em produção.
• !Licenciado sob GPL-3.0, uma licença copyleft que exige que distribuições derivadas sejam de código aberto.

Tópicos

Perguntas frequentes

O que é air?

Ferramenta de linha de comando que monitora arquivos Go e recompila e reinicia o app automaticamente durante o desenvolvimento. Air é uma ferramenta de linha de comando com live reload para desenvolver aplicações Go. Execute-a na raiz do projeto para recompilar e reiniciar o programa sempre que os arquivos-fonte mudarem, sem precisar parar e iniciar o processo manualmente. Ela foi feita apenas para desenvolvimento e não tem relação com hot deployment em produção.

air é gratuito? Qual é a licença?

air é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

air ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de air foi em 27 de ago. de 2026.

Para que posso usar air?

Desenvolver um servidor web em Go, como um feito com gin, e recarregá-lo a cada salvamento Executar builds de assets do frontend ou etapas de templ/go generate junto com o app Go Executar o Air em um contêiner Docker com o projeto montado para ter live reload

Como instalar air?

Instale o Air com go install (requer Go 1.25 ou superior).: go install github.com/air-verse/air@latest Adicione o diretório bin do Go ao PATH.: export PATH="$PATH:$(go env GOPATH)/bin" Entre no diretório do projeto e execute air.: air

Onde consigo air?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/air-verse/air