Herramienta CLI para ajustar y seguir entrenando LLM con una sola configuración YAML, con opciones para usar GPU de consumo con poca VRAM.
lyogavin/airllm
Biblioteca de Python que ejecuta modelos de lenguaje grandes capa por capa para que los modelos de 70B puedan inferir en una sola GPU de 4 GB, sin cuantización.
- Estrellas
- 39,483
- Forks
- 4,026
- Issues abiertos
- 167
- Último commit
- ayer
¿Qué es?
AirLLM es una biblioteca de Python para ejecutar modelos de lenguaje grandes en GPU con muy poca VRAM. En vez de cargar todo el modelo de una vez, mantiene una sola capa del decodificador en la GPU cada vez, por lo que la memoria necesaria depende del tamaño de las capas y no del número total de parámetros. El proyecto informa que puede ejecutar Llama 3.x 70B con unos 4 GB, DeepSeek-V3 (671B) con unos 12 GB y versiones más recientes, como Qwen3-235B y Kimi K3, en una sola tarjeta.
Los modelos se cargan con una única llamada a AutoModel.from_pretrained que acepta el ID de un repositorio de Hugging Face o una ruta local. La compresión opcional por bloques de 4 o 8 bits puede reducir aún más el tiempo de carga desde disco y acelerar la inferencia. La biblioteca también es compatible con macOS en Apple silicon mediante MLX y permite inferencia en CPU. Las versiones recientes añaden ajuste fino basado en LoRA, que transmite desde el disco los pesos base congelados.
La principal contrapartida es la velocidad: como las capas se leen del disco en cada pasada, primero se divide el modelo original en archivos por capa, lo que requiere bastante espacio libre en disco.
Funciones clave
- 01Ejecuta modelos de 70B en una sola GPU de 4 GB, manteniendo una capa a la vez en VRAM.
- 02Carga modelos desde el ID de un repositorio de Hugging Face o una ruta local mediante una sola llamada a AutoModel.
- 03Ofrece compresión opcional por bloques de 4 y 8 bits para acelerar la carga.
- 04Es compatible con macOS en Apple silicon mediante MLX y permite inferencia en CPU.
- 05Incluye ajuste fino con LoRA que transmite desde el disco los pesos base congelados.
Casos de uso
- Probar modelos abiertos grandes, como Llama 70B, en una GPU de consumo con VRAM limitada.
- Ejecutar un modelo MoE muy grande, como DeepSeek-V3, en una sola tarjeta de una estación de trabajo.
- Ajustar un modelo grande con LoRA en una GPU pequeña.
- Ejecutar modelos grandes localmente en una Mac con Apple silicon.
Inicio rápido
- 1
Instala el paquete airllm
pip install airllm - 2
Carga un modelo mediante el ID de repositorio de Hugging Face y ejecuta la inferencia (consulta el código de Quickstart en el README)
model = AutoModel.from_pretrained("Qwen/Qwen3-32B")
Antes de usarlo
- La primera vez que se ejecuta la inferencia, el modelo original se descompone en fragmentos por capas, por lo que necesitas suficiente espacio en disco en la caché de Hugging Face.
- Algunos modelos más recientes necesitan versiones específicas de transformers o paquetes adicionales; por ejemplo, Kimi K3 requiere compressed-tensors y flash-attn.
- La compatibilidad con MacOS se limita a Apple silicon y requiere instalar mlx y torch.
Temas
Preguntas frecuentes
- ¿Qué es airllm?
- Biblioteca de Python que ejecuta modelos de lenguaje grandes capa por capa para que los modelos de 70B puedan inferir en una sola GPU de 4 GB, sin cuantización. AirLLM es una biblioteca de Python para ejecutar modelos de lenguaje grandes en GPU con muy poca VRAM. En vez de cargar todo el modelo de una vez, mantiene una sola capa del decodificador en la GPU cada vez, por lo que la memoria necesaria depende del tamaño de las capas y no del número total de parámetros. El proyecto informa que puede ejecutar Llama 3.x 70B con unos 4 GB, DeepSeek-V3 (671B) con unos 12 GB y versiones más recientes, como Qwen3-235B y Kimi K3, en una sola tarjeta.
- ¿airllm es gratuito? ¿Qué licencia tiene?
- airllm es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿airllm sigue mantenido?
- Mantenimiento activo. El último commit de airllm fue el 19 oct 2026.
- ¿Para qué puedo usar airllm?
- Probar modelos abiertos grandes, como Llama 70B, en una GPU de consumo con VRAM limitada. Ejecutar un modelo MoE muy grande, como DeepSeek-V3, en una sola tarjeta de una estación de trabajo. Ajustar un modelo grande con LoRA en una GPU pequeña. Ejecutar modelos grandes localmente en una Mac con Apple silicon.
- ¿Cómo se instala airllm?
- Instala el paquete airllm: pip install airllm Carga un modelo mediante el ID de repositorio de Hugging Face y ejecuta la inferencia (consulta el código de Quickstart en el README): model = AutoModel.from_pretrained("Qwen/Qwen3-32B")
- ¿Dónde consigo airllm?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/lyogavin/airllm
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Motor de inferencia local que ejecuta el gran modelo Qwen3.8-Flash-Next en GPU NVIDIA o AMD de consumo con Windows o Linux, mediante APIs compatibles con OpenAI y Anthropic.
Convierte tu historial de chat exportado en un LLM ajustado que imita tu estilo y lo despliega como chatbot en Telegram, Discord, Slack o WeChat.
Un motor de serving nativo para el edge que ejecuta grandes modelos de pesos abiertos, como DeepSeek-V4 y Qwen3.6, en GPU y CPU de consumo.
Scripts de entrenamiento, generación y utilidades para Stable Diffusion y otros modelos de generación de imágenes, con soporte para LoRA y fine-tuning.
Una CLI que detecta tu GPU, CPU y RAM, y clasifica los LLM locales de HuggingFace que realmente funcionan en tu hardware según benchmarks, no por cantidad de parámetros.