Framework unificado para ajustar eficientemente más de 100 LLM y VLM con una CLI y una interfaz web sin código.
huggingface/peft
Biblioteca de Hugging Face para Parameter-Efficient Fine-Tuning (PEFT), que adapta modelos preentrenados grandes entrenando solo un pequeño conjunto de parámetros adicionales.
- Estrellas
- 21,824
- Forks
- 2,610
- Issues abiertos
- 97
- Último commit
- hace 17 horas
¿Qué es?
Ajustar modelos preentrenados grandes requiere mucho cómputo y almacenamiento. PEFT ofrece métodos como LoRA, que entrenan solo un pequeño número de parámetros añadidos y mantienen congelado el modelo base. Los adaptadores resultantes suelen ocupar solo unos pocos megabytes, y la biblioteca indica que, en muchos casos, su rendimiento es comparable al del ajuste completo.
El uso consiste principalmente en envolver un modelo base con un objeto de configuración mediante get_peft_model y, después, guardar o cargar el adaptador con save_pretrained y PeftModel.from_pretrained. La biblioteca se integra con Hugging Face Transformers para entrenamiento e inferencia, con Diffusers para gestionar varios adaptadores y con Accelerate para entrenamiento distribuido.
El proyecto está desarrollado en Python sobre PyTorch, y su documentación abarca los métodos compatibles y guías conceptuales sobre adaptadores, soft prompts e IA3.
Funciones clave
- 01Implementa LoRA y otros métodos eficientes en parámetros, como adaptadores, soft prompts e IA3.
- 02Envuelve cualquier modelo compatible con get_peft_model y un objeto de configuración.
- 03Guarda adaptadores como checkpoints pequeños que se pueden cargar sobre el modelo base.
- 04Se integra con Transformers, Diffusers y Accelerate.
- 05Admite modelos base cuantizados para reducir el uso de memoria durante el entrenamiento.
Casos de uso
- Ajustar un LLM de varios miles de millones de parámetros en una única GPU de consumo.
- Mantener muchos adaptadores específicos para distintas tareas sobre un mismo modelo base compartido.
- Personalizar Stable Diffusion con LoRA para entrenar estilos o sujetos.
- Entrenar modelos grandes en entornos distribuidos con Accelerate.
Inicio rápido
- 1
Instala PEFT con pip
pip install peft - 2
Envuelve un modelo base con una configuración de LoRA mediante get_peft_model, y luego entrénalo y guárdalo
Antes de usarlo
- Para ejecutar los ejemplos del README, se necesita una GPU o un acelerador compatible con PyTorch y descargar modelos preentrenados de gran tamaño.
Temas
Preguntas frecuentes
- ¿Qué es peft?
- Biblioteca de Hugging Face para Parameter-Efficient Fine-Tuning (PEFT), que adapta modelos preentrenados grandes entrenando solo un pequeño conjunto de parámetros adicionales. Ajustar modelos preentrenados grandes requiere mucho cómputo y almacenamiento. PEFT ofrece métodos como LoRA, que entrenan solo un pequeño número de parámetros añadidos y mantienen congelado el modelo base. Los adaptadores resultantes suelen ocupar solo unos pocos megabytes, y la biblioteca indica que, en muchos casos, su rendimiento es comparable al del ajuste completo.
- ¿peft es gratuito? ¿Qué licencia tiene?
- peft es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿peft sigue mantenido?
- Mantenimiento activo. El último commit de peft fue el 21 oct 2026.
- ¿Para qué puedo usar peft?
- Ajustar un LLM de varios miles de millones de parámetros en una única GPU de consumo. Mantener muchos adaptadores específicos para distintas tareas sobre un mismo modelo base compartido. Personalizar Stable Diffusion con LoRA para entrenar estilos o sujetos. Entrenar modelos grandes en entornos distribuidos con Accelerate.
- ¿Cómo se instala peft?
- Instala PEFT con pip: pip install peft Envuelve un modelo base con una configuración de LoRA mediante get_peft_model, y luego entrénalo y guárdalo
- ¿Dónde consigo peft?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/huggingface/peft
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Una biblioteca de Hugging Face para el postentrenamiento de modelos de lenguaje transformer con SFT, GRPO, DPO, KTO y modelado de recompensas.
Framework de ajuste fino, entrenamiento, inferencia y despliegue para más de 600 modelos de lenguaje grandes y más de 400 modelos multimodales, compatible con SFT, DPO y GRPO.
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.
Framework gratuito y de código abierto para ajustar y realizar el posentrenamiento de modelos de lenguaje grandes mediante archivos YAML.
Herramienta CLI para ajustar y seguir entrenando LLM con una sola configuración YAML, con opciones para usar GPU de consumo con poca VRAM.