Recopilación de estadísticas de uso

TRL recopila estadísticas de uso anónimas para ayudar a los mantenedores a comprender qué entrenadores, arquitecturas de modelos y configuraciones de hardware se utilizan en la práctica. Estos datos informan las decisiones de priorización sobre en qué funciones invertir y cuáles deprecar.

Lo que se recopila

Se envía un ping cada vez que se instancia un trainer. El payload contiene:

• Versión de TRL (p. ej., 1.5.0)
• Nombre de la clase Trainer, reportado solo si es un trainer definido por TRL (p. ej. SFTTrainer, GRPOTrainer). Los subclases personalizadas del usuario se reportan como other.
• Arquitectura del modelo, solo se informa si es un tipo de modelo conocido por transformers (p. ej., llama, qwen3). Las arquitecturas personalizadas o privadas se informan como other.
• Si se está utilizando PEFT
• Cómo se cargó el conjunto de datos de entrenamiento: hub (descargado del Hub), files (leído a través de un constructor basado en archivos, como json o csv — esto también cubre repositorios del Hub que contienen archivos json/csv en bruto), memory (construido en el proceso, p. ej. Dataset.from_dict) o other. El nombre y la ruta del conjunto de datos nunca se recopilan.
• Backend distribuido (deepspeed, fsdp, ddp o none)
• Tamaño del mundo, por intervalos (1, 2-8, 9-64, 65+)
• Tipo de acelerador (cuda, xpu, npu, mlu, mps, cpu)
• Nombre del modelo de GPU (p. ej. NVIDIA H100 80GB HBM3), cuando está disponible

No se recopilan nombres de conjuntos de datos, rutas de archivos, identificadores de modelos, valores de hiperparámetros ni ningún otro dato proporcionado por el usuario. Como con cualquier solicitud HTTP, la IP de origen y las cabeceras HTTP estándar son visibles para el servidor.

La telemetría no se envía en entornos de CI (es decir, cuando la variable de entorno CI está establecida), ni en modo sin conexión.

Cómo desactivar

Establezca cualquiera de las siguientes variables de entorno para deshabilitar la telemetría:

export HF_HUB_DISABLE_TELEMETRY=1   # disables telemetry for all HF libraries
export HF_HUB_OFFLINE=1             # disables all network calls to the Hub

Por qué esto ayuda

Sin datos de uso, los mantenedores no tienen forma de saber qué partes de la biblioteca son importantes para los usuarios. La telemetría nos permite responder preguntas como:

• ¿Qué entrenadores están ampliamente adoptados y cuáles pueden eliminarse de forma segura?
• ¿Qué arquitecturas de modelos se ajustan con mayor frecuencia mediante TRL para que podamos priorizar su soporte?
• ¿Qué configuraciones de hardware están utilizando los usuarios para que podamos probar y optimizar para ellos?

Si encuentras útil TRL, dejar habilitada la telemetría es una forma de bajo costo de ayudarnos a mejorarlo.