Collecte des statistiques d'utilisation

TRL collecte des statistiques d'utilisation anonymes afin d'aider les mainteneurs à comprendre quels formateurs, quelles architectures de modèles et quelles configurations matérielles sont utilisés dans la pratique. Ces données guident les décisions de priorisation concernant les fonctionnalités à développer et celles à déprécier.

Ce qui est collecté

Un seul ping est envoyé à chaque fois qu'un formateur est instancié. La charge utile contient :

• Version de TRL (par exemple 1.5.0)
• Nom de la classe Trainer, signalé uniquement s'il s'agit d'un trainer défini par TRL (par exemple SFTTrainer, GRPOTrainer). Les sous-classes personnalisées de l'utilisateur sont signalées comme other.
• Architecture du modèle, signalée uniquement s'il s'agit d'un type de modèle connu de transformers (par exemple llama, qwen3). Les architectures personnalisées ou privées sont signalées comme other.
• Si PEFT est utilisé
• Comment le jeu de données d’entraînement a été chargé : hub (téléchargé depuis le Hub), files (lu via un constructeur basé sur des fichiers tel que json ou csv — cela couvre également les dépôts du Hub contenant des fichiers json/csv bruts), memory (construit dans le processus, par exemple Dataset.from_dict) ou other. Le nom et le chemin du jeu de données ne sont jamais collectés.
• Backend distribué (deepspeed, fsdp, ddp ou none)
• Taille du monde, par paliers (1, 2-8, 9-64, 65+)
• Type d'accélérateur (cuda, xpu, npu, mlu, mps, cpu)
• Nom du modèle de GPU (par exemple NVIDIA H100 80GB HBM3), si disponible

Aucun nom de jeu de données, chemin de fichier, identifiant de modèle, valeur d'hyperparamètre ou autre donnée fournie par l'utilisateur n'est collecté. Comme pour toute requête HTTP, l'adresse IP source et les en-têtes HTTP standard sont visibles par le serveur.

La télémétrie n'est pas envoyée dans les environnements CI (c'est-à-dire lorsque la variable d'environnement CI est définie), ni en mode hors ligne.

Comment se désinscrire

Définissez l'une des variables d'environnement suivantes pour désactiver la télémétrie :

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

Pourquoi cela est utile

Sans données d’utilisation, les mainteneurs n’ont aucun moyen de savoir quelles parties de la bibliothèque sont importantes pour les utilisateurs. La télémétrie nous permet de répondre à des questions telles que :

• Quels formateurs sont largement adoptés et lesquels peuvent être dépréciés en toute sécurité ?
• Quelles architectures de modèles sont le plus souvent affinées avec TRL, afin que nous puissions prioriser leur prise en charge ?
• Quelles configurations matérielles les utilisateurs utilisent-ils, afin que nous puissions les tester et les optimiser ?

Si vous trouvez TRL utile, laisser la télémétrie activée est un moyen peu coûteux de nous aider à l'améliorer.