Héberger le serveur Trackio

Vous pouvez exécuter le tableau de bord et l’API Trackio sur votre propre machine (ou sur n’importe quel hôte que vous contrôlez) et envoyer les métriques des scripts d’entraînement à ce serveur via HTTP. Il s’agit d’une alternative à l’enregistrement des métriques dans un Hugging Face Space via space_id.

Exécuter le serveur localement

Installez Trackio, puis démarrez le tableau de bord. Par défaut, il écoute sur 127.0.0.1 et utilise le port défini dans GRADIO_SERVER_PORT s'il est configuré, sinon 7860 (voir Démarrer le tableau de bord).

Shell

Python

Laissez ce processus en cours pendant l’entraînement. Le terminal affiche une URL de base pour l’interface utilisateur ainsi qu’une URL incluant un jeton d’écriture ; toute personne pouvant accéder à cette URL avec le jeton peut effectuer des opérations d’écriture prises en charge par le serveur (par exemple, renommer des exécutions), il convient donc de le traiter comme un secret sur les réseaux non fiables.

Écouter sur toutes les interfaces

Pour accéder au tableau de bord depuis une autre machine de votre réseau (ou depuis des conteneurs), liez-vous à toutes les interfaces :

Shell

Python

Assurez-vous que votre pare-feu et vos politiques de sécurité autorisent le trafic que vous souhaitez.

Pointer le code d’entraînement vers votre serveur

Dans votre script d’entraînement, passez un server_url et fournissez le jeton d’écriture : soit vous intégrez write_token dans la chaîne de requête (la même URL que le tableau de bord affiche pour l’accès en écriture, ou la valeur de retour full_url de trackio.show()), soit vous passez une URL de base comme http://127.0.0.1:7860/ et définissez la variable d’environnement TRACKIO_WRITE_TOKEN sur ce jeton. Vous pouvez également définir TRACKIO_WRITE_TOKEN sur le serveur Trackio avant de lancer trackio.show() pour choisir le jeton d’écriture du serveur plutôt que d’utiliser le jeton aléatoire généré au démarrage. L’ingestion des métriques et les téléversements nécessitent ce jeton lorsque le serveur n’est pas sur Hugging Face Spaces. Vous pouvez aussi définir TRACKIO_SERVER_URL au lieu de passer server_url dans le code.

import trackio

trackio.init(
    project="my-project",
    server_url="http://127.0.0.1:7860?write_token=YOUR_TOKEN",
)
trackio.log({"loss": 0.25})
trackio.finish()

Priorité : space_id / TRACKIO_SPACE_ID l’emporte toujours sur server_url / TRACKIO_SERVER_URL lorsque les deux sont définis (dans le code ou dans l’environnement). Trackio se comporte alors comme si seul le Space était configuré.

Les options spécifiques à Hugging Face, telles que dataset_id (obsolète ; utilisez bucket_id à la place) et bucket_id, ne s’appliquent que lors de l’enregistrement dans un Space. Lorsque seul server_url est actif, configurez la persistance sur la machine où le serveur est exécuté (par exemple via TRACKIO_DIR sur cet hôte). Consultez Variables d’environnement.

Lié

Démarrer le tableau de bord — options CLI, port et accès à distance
Variables d'environnement — TRACKIO_SERVER_URL, TRACKIO_DIR et autres

Update on GitHub