Déploiement et intégration des tableaux de bord

Déploiement sur Hugging Face Spaces

Lors de l'appel de init(), le service s'exécute par défaut localement et stocke les données du projet sur la machine locale.

Mais si vous passez un space_id à init(), comme ceci :

trackio.init(project="my-project", space_id="orgname/space_id")

ou

trackio.init(project="my-project", space_id="username/space_id")

il utilisera un espace Hugging Face existant ou en déploiera automatiquement un nouveau au besoin. Vous devez être connecté localement avec huggingface-cli et votre jeton doit disposer des autorisations d’écriture pour créer l’espace.

Synchronisation des projets locaux avec Spaces

Si vous avez enregistré des données localement et souhaitez les téléverser sur un Space a posteriori, utilisez sync :

trackio.sync(project="my-project", space_id="username/space_id")

Ou depuis l'interface en ligne de commande :

trackio sync --project "my-project" --space-id "username/space_id"

Par défaut, sync déploie un Gradio Space avec un serveur en direct. Vous pouvez également déployer un static Space qui lit depuis un HF Bucket (aucun serveur n’est nécessaire) :

trackio.sync(project="my-project", space_id="username/space_id", sdk="static")

trackio sync --project "my-project" --space-id "username/space_id" --sdk static

Les Spaces statiques sont légers et gratuits — ils servent un tableau de bord en lecture seule adossé à des fichiers Parquet dans un HF Bucket. Comme le tableau de bord s’exécute entièrement dans le navigateur, les Spaces Trackio statiques nécessitent des données de snapshot publiques et ne prennent pas en charge private=True. Utilisez l’espace Gradio par défaut (sdk="gradio") pour les tableaux de bord privés.

Geler un instantané d'espace

Si vous disposez d’un Space Gradio en direct et souhaitez créer un instantané statique en lecture seule des données d’un projet, utilisez freeze :

trackio.freeze(space_id="username/my-space", project="my-project")

Ou depuis l'interface en ligne de commande :

trackio freeze --space-id "username/my-space" --project "my-project"

Cela crée un nouvel espace statique (nommé par défaut {space_id}_static) contenant un instantané des données du projet depuis le bucket de l’espace source. L’espace d’origine n’est pas modifié.

Notez quefreeze() est un instantané unique. Si de nouvelles métriques sont ultérieurement téléversées sur l’espace Gradio d’origine, l’espace statique figé ne se mettra pas à jour automatiquement. L’espace Gradio source peut utiliser un seau privé, mais l’instantané statique figé est des données publiques. freeze(private=True) n’est pas pris en charge ; utilisez un espace Gradio si le tableau de bord figé doit rester privé.

Vous pouvez personnaliser la destination :

trackio.freeze(
    space_id="username/my-space",
    project="my-project",
    new_space_id="username/my-snapshot",
)

Remarque : freeze() exige que la source soit un Gradio Space avec un bucket monté sur /data. Si le Space de destination existe déjà et n'est pas un Space statique Trackio, freeze() refusera de l'écraser.

Intégrer un tableau de bord Trackio

L’une des raisons pour lesquelles nous avons créé trackio est de faciliter l’intégration de tableaux de bord en direct sur des sites web, des articles de blog ou n’importe quel endroit où vous pouvez intégrer un site web.

Si votre tableau de bord Trackio est hébergé sur Spaces, vous pouvez l’intégrer n’importe où à l’aide d’un <iframe> :

<iframe src="https://username-space_id.hf.space"></iframe>

Vous pouvez également filtrer le tableau de bord pour n’afficher que des projets ou des métriques spécifiques à l’aide de paramètres de requête. Les paramètres pris en charge incluent :

• project (string) : Afficher uniquement un projet spécifique.

• metrics (liste séparée par des virgules) : Afficher uniquement des métriques spécifiques, par exemple train_loss,train_accuracy.

• sidebar (string, "auto", "visible", "collapsed" ou "hidden") :

  • "auto" ouvre ou replie la barre latérale en fonction de la largeur de la fenêtre et est la valeur par défaut.
  • "visible" démarre avec la barre latérale entièrement ouverte.
  • "collapsed" commence avec uniquement le rail étroit.
  • "hidden" masque complètement la barre latérale.

  Les modes explicites ne sont pas modifiés lors du redimensionnement de la zone de visualisation.

• footer (string, "false") : lorsqu’il est défini sur "false", masque le pied de page de Gradio. Par défaut, le pied de page est visible.

• xmin (number) : définit la valeur minimale initiale des limites de l'axe des x pour tous les graphiques de métriques.

• xmax (number) : définit la valeur maximale initiale des limites de l'axe des x pour tous les graphiques de métriques.

• smoothing (nombre) : définit la valeur initiale du curseur de lissage (0-20, où 0 = aucun lissage).

• plots_per_row (auto ou entier de 1 à 6) : définit la valeur initiale du contrôle Plots per row. La valeur par défaut est auto, qui adapte les graphiques à la largeur disponible.

• accordion (string, "hidden") : lorsqu’il est défini sur "hidden", masque les en-têtes de section en accordéon entourant les groupes de métriques. Par défaut, les en-têtes de section sont visibles.

Vous pouvez personnaliser votre <iframe> à l'aide d'attributs standard tels que width, height et style. Pour plus de détails, consultez MDN Web Docs : <iframe>. Par exemple :

<iframe 
    src="https://huggingface.co/proxy/trackio-documentation.hf.space/?project=my-project&metrics=train_loss,train_accuracy&sidebar=hidden" 
    width="600" 
    height="630" 
    style="border:0;">
</iframe>