Framework unificado para ajustar eficientemente más de 100 LLM y VLM con una CLI y una interfaz web sin código.
huggingface/trl
Una biblioteca de Hugging Face para el postentrenamiento de modelos de lenguaje transformer con SFT, GRPO, DPO, KTO y modelado de recompensas.
- Estrellas
- 19,561
- Forks
- 3,086
- Issues abiertos
- 289
- Último commit
- hace 3 horas
¿Qué es?
TRL es una biblioteca para el postentrenamiento de modelos fundacionales que incluye métodos como Supervised Fine-Tuning (SFT), Group Relative Policy Optimization (GRPO), Direct Preference Optimization (DPO), Kahneman-Tversky Optimization (KTO) y el entrenamiento de modelos de recompensa. Cada método está disponible en una clase de trainer, como SFTTrainer, GRPOTrainer, DPOTrainer, KTOTrainer y RewardTrainer, que envuelve el trainer de Hugging Face Transformers.
TRL se basa en el ecosistema de Transformers y usa Accelerate para escalar desde una sola GPU hasta clústeres de varios nodos con DDP, DeepSpeed ZeRO y FSDP. Se integra con PEFT para entrenar con cuantización y LoRA/QLoRA en hardware modesto, y con Unsloth para usar kernels optimizados. Su interfaz de línea de comandos permite ejecutar SFT, DPO y KTO sin escribir código.
El proyecto también incluye un área experimental en trl.experimental con funciones que pueden cambiar sin previo aviso. Entre las actualizaciones recientes se añade compatibilidad para entrenar en GPU AMD Instinct mediante ROCm y en AWS Trainium mediante TorchNeuron.
Funciones clave
- 01Clases de trainer para SFT, GRPO, DPO, KTO y modelado de recompensas.
- 02Entrenamiento con varias GPU y varios nodos mediante Accelerate, DeepSpeed y FSDP.
- 03Compatibilidad con LoRA y QLoRA a través de PEFT para entrenar con memoria limitada.
- 04Interfaz de línea de comandos para ejecutar SFT, DPO y KTO sin escribir código.
- 05Integración con Hugging Face Transformers y los conjuntos de datos de Hub.
Casos de uso
- Ajustar un LLM de pesos abiertos con conjuntos de datos de instrucciones o chat mediante SFT.
- Alinear un modelo con pares de preferencias humanas mediante DPO.
- Entrenar un modelo con recompensas de aprendizaje por refuerzo mediante GRPO.
- Entrenar un modelo de recompensa para puntuar respuestas en pipelines posteriores de RL.
Inicio rápido
- 1
Instala la biblioteca desde PyPI
pip install trl - 2
Ejecuta un ejemplo básico de entrenamiento SFT desde la API de Python
- 3
O ajusta el modelo desde la línea de comandos con la CLI de trl
trl sft --model_name_or_path Qwen/Qwen2.5-0.5B --dataset_name trl-lib/Capybara --output_dir Qwen2.5-0.5B-SFT
Antes de usarlo
- Entrenar modelos grandes requiere una GPU de gran capacidad. El README recomienda PEFT/LoRA y la cuantización para reducir el consumo de memoria.
- El área experimental de trl.experimental puede cambiar o desaparecer sin previo aviso.
Temas
Preguntas frecuentes
- ¿Qué es trl?
- Una biblioteca de Hugging Face para el postentrenamiento de modelos de lenguaje transformer con SFT, GRPO, DPO, KTO y modelado de recompensas. TRL es una biblioteca para el postentrenamiento de modelos fundacionales que incluye métodos como Supervised Fine-Tuning (SFT), Group Relative Policy Optimization (GRPO), Direct Preference Optimization (DPO), Kahneman-Tversky Optimization (KTO) y el entrenamiento de modelos de recompensa. Cada método está disponible en una clase de trainer, como SFTTrainer, GRPOTrainer, DPOTrainer, KTOTrainer y RewardTrainer, que envuelve el trainer de Hugging Face Transformers.
- ¿trl es gratuito? ¿Qué licencia tiene?
- trl es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿trl sigue mantenido?
- Mantenimiento activo. El último commit de trl fue el 21 oct 2026.
- ¿Para qué puedo usar trl?
- Ajustar un LLM de pesos abiertos con conjuntos de datos de instrucciones o chat mediante SFT. Alinear un modelo con pares de preferencias humanas mediante DPO. Entrenar un modelo con recompensas de aprendizaje por refuerzo mediante GRPO. Entrenar un modelo de recompensa para puntuar respuestas en pipelines posteriores de RL.
- ¿Cómo se instala trl?
- Instala la biblioteca desde PyPI: pip install trl Ejecuta un ejemplo básico de entrenamiento SFT desde la API de Python O ajusta el modelo desde la línea de comandos con la CLI de trl: trl sft --model_name_or_path Qwen/Qwen2.5-0.5B --dataset_name trl-lib/Capybara --output_dir Qwen2.5-0.5B-SFT
- ¿Dónde consigo trl?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/huggingface/trl
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Guía y código en PyTorch para entrenar desde cero un LLM transformer, desde el preentrenamiento hasta SFT, modelado de recompensas, DPO/PPO/GRPO y generación.
Colección bilingüe de más de 100 diagramas originales que explican LLM, RL, RLHF, DPO, GRPO y algoritmos relacionados con modelos grandes.
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.
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.