Repolode
Enviar
air-verse

air-verse/air

Herramienta de línea de comandos que observa archivos fuente de Go y recompila y reinicia automáticamente tu app durante el desarrollo.

Ver en GitHub
Estrellas
24,088
Forks
928
Issues abiertos
14
Último commit
hace 2 meses

¿Qué es?

Air es una utilidad de recarga en caliente para desarrollar aplicaciones de Go. Ejecútala en la raíz del proyecto y recompilará y reiniciará el programa cada vez que cambien los archivos fuente, para que puedas seguir editando sin detener y volver a iniciar el proceso manualmente. Está pensada solo para desarrollo y no tiene relación con el hot deployment en producción.

El comportamiento se controla mediante un archivo .air.toml, que puedes generar con `air init`, o mediante flags de línea de comandos. Puedes definir comandos personalizados de compilación y ejecución, excluir directorios, observar directorios nuevos mientras la herramienta está en ejecución, cargar archivos .env y pasar argumentos al binario compilado. Las reglas pueden ejecutar comandos arbitrarios, como compilaciones de frontend o generadores de código como templ, en lugar de hacer una recompilación completa. Un proxy opcional inyecta un script en las respuestas HTML para que el navegador se recargue después de cada compilación.

Air se puede instalar con go install, Homebrew, Scoop, mise, un script de instalación o como imagen de Docker; además, un proyecto puede fijar su versión con `go get -tool`.

Funciones clave

  • 01Recompila y reinicia automáticamente la app de Go cuando cambian los archivos
  • 02Permite configurar los comandos de compilación y ejecución mediante .air.toml o flags de CLI
  • 03Excluye subdirectorios y observa los directorios que se crean
  • 04Las reglas de observación ejecutan comandos personalizados para procesar recursos o generar código
  • 05Proxy opcional que recarga el navegador después de cada compilación
  • 06Carga archivos .env antes de compilar y ejecutar

Casos de uso

  • Desarrollar un servidor web de Go, por ejemplo uno creado con gin, y recargarlo con cada guardado
  • Ejecutar compilaciones de recursos de frontend o pasos de templ/go generate junto con la app de Go
  • Ejecutar Air en un contenedor de Docker con el proyecto montado para habilitar la recarga en caliente

Inicio rápido

  1. 1

    Instala Air con go install (requiere Go 1.25 o posterior).

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

    Añade el directorio bin de Go a PATH.

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

    Entra en el directorio del proyecto y ejecuta air.

    air

Antes de usarlo

  • El README indica que Air es solo para desarrollo y no está relacionado con el hot-deploy en producción.
  • Está bajo la licencia GPL-3.0, una licencia copyleft que exige que las distribuciones derivadas sean de código abierto.

Temas

#go#live-reload#file-watcher#hot-reload#developer-tools#docker#gin#task-runner#tools#watcher

Preguntas frecuentes

¿Qué es air?
Herramienta de línea de comandos que observa archivos fuente de Go y recompila y reinicia automáticamente tu app durante el desarrollo. Air es una utilidad de recarga en caliente para desarrollar aplicaciones de Go. Ejecútala en la raíz del proyecto y recompilará y reiniciará el programa cada vez que cambien los archivos fuente, para que puedas seguir editando sin detener y volver a iniciar el proceso manualmente. Está pensada solo para desarrollo y no tiene relación con el hot deployment en producción.
¿air es gratuito? ¿Qué licencia tiene?
air es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿air sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de air fue el 27 ago 2026.
¿Para qué puedo usar air?
Desarrollar un servidor web de Go, por ejemplo uno creado con gin, y recargarlo con cada guardado Ejecutar compilaciones de recursos de frontend o pasos de templ/go generate junto con la app de Go Ejecutar Air en un contenedor de Docker con el proyecto montado para habilitar la recarga en caliente
¿Cómo se instala air?
Instala Air con go install (requiere Go 1.25 o posterior).: go install github.com/air-verse/air@latest Añade el directorio bin de Go a PATH.: export PATH="$PATH:$(go env GOPATH)/bin" Entra en el directorio del proyecto y ejecuta air.: air
¿Dónde consigo air?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/air-verse/air

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados