🟧 Label Studio sur Spaces

Label Studio est une plateforme de labellisation de données open source permettant d’étiqueter, d’annoter et d’explorer de nombreux types de données. De plus, Label Studio intègre une puissante interface de machine learning qui peut être utilisée pour l’entraînement de nouveaux modèles, l’apprentissage actif, l’apprentissage supervisé et de nombreuses autres techniques d’entraînement.

Ce guide vous apprend à déployer Label Studio pour l’étiquetage et l’annotation de données au sein du Hugging Face Hub. Vous pouvez utiliser la configuration par défaut de Label Studio en tant qu’application autonome hébergée entièrement sur le Hub à l’aide de Docker, à des fins de démonstration et d’évaluation, ou vous pouvez connecter votre propre base de données et votre stockage cloud pour héberger une application de production complète sur Spaces.

⚡️ Déployer Label Studio sur Spaces

Vous pouvez déployer Label Studio sur Spaces en quelques clics :

Spaces vous demande de définir :

• Un Owner : soit votre compte personnel, soit une organisation dont vous êtes membre.

• Un nom d’espace : le nom de l’espace au sein du compte où vous créez l’espace.

• Le Visibility : private si vous souhaitez que le Space ne soit visible que par vous ou votre organisation, ou public si vous souhaitez qu’il soit visible par d’autres utilisateurs ou applications utilisant l’API Label Studio (recommandé).

🚀 Utilisation de la configuration par défaut

Par défaut, Label Studio est installé dans Spaces avec une configuration qui utilise le stockage local pour la base de données de l'application afin de stocker la configuration, les identifiants de compte et les informations de projet. Les tâches d'étiquetage et les éléments de données sont également conservés dans le stockage local.

Le stockage dans les Hugging Face Spaces est éphémère par défaut. Pour conserver vos données entre les redémarrages, attachez un Storage Bucket — consultez la section sur la persistance ci-dessous.

Après avoir lancé Label Studio, l’écran de connexion standard s’affiche. Vous pouvez commencer par créer un nouveau compte à l’aide de votre adresse e-mail, puis vous connecter avec vos nouvelles identifiants. Périodiquement après la connexion, Label Studio vous avertit que le stockage est éphémère et que les données pourraient être perdues si votre Space est redémarré. Un message de Heidi, la mascotte utile de Label Studio, vous invite également à créer un nouveau projet afin de commencer à annoter vos données. Pour démarrer, consultez le tutoriel « Zero to One » de Label Studio, qui propose un guide pour construire une interface d’annotation destinée à l’analyse de sentiments.

🛠️ Configuration d'une instance de Label Studio prête pour la production

Pour rendre votre Space prêt pour la production, vous devrez effectuer trois modifications de configuration :

• Désactiver la création illimitée de nouveaux comptes.

• Activez la persistance en attachant un Storage Bucket ou une base de données externe.

• Facultativement, attachez un stockage cloud pour les tâches d’étiquetage.

Désactiver la création illimitée de nouveaux comptes

La configuration par défaut de Label Studio permet la création illimitée de nouveaux comptes pour toute personne disposant de l'URL de votre application. Vous pouvez restreindre les inscriptions en ajoutant les secrets de configuration suivants à vos Paramètres de Space.

• LABEL_STUDIO_DISABLE_SIGNUP_WITHOUT_LINK : Définir cette valeur sur true désactive la création de compte sans restriction.

• LABEL_STUDIO_USERNAME : il s’agit du nom d’utilisateur du compte que vous utiliserez en tant que premier utilisateur de votre espace Label Studio. Il doit s’agir d’une adresse e-mail valide.

• LABEL_STUDIO_PASSWORD : le mot de passe qui sera associé au premier compte utilisateur.

Redémarrez le Space pour appliquer ces paramètres. La possibilité de créer de nouveaux comptes depuis l'écran de connexion sera désactivée. Pour créer de nouveaux comptes, vous devrez inviter de nouveaux utilisateurs dans les paramètres Organization de l'application Label Studio.

Activer la persistance avec les buckets de stockage HF

Par défaut, cet espace stocke toutes les configurations de projet et les annotations de données dans le stockage local avec SQLite. Si l’espace est réinitialisé, toutes les données de configuration et d’annotation de l’espace seront perdues.

La méthode la plus simple pour activer la persistance est d’attacher un Storage Bucket, qui monte le stockage d’objets persistant directement dans le Space. Label Studio écrit sa base de données SQLite et les médias téléversés dans le bucket monté, de sorte que les projets et les annotations survivent aux redémarrages.

1. Créer un bucket :

   Copié

   hf buckets create <your-namespace>/label-studio-data

2. Attachez-le dans Space Settings → Storage Buckets, chemin de montage /data.

3. Définissez deux variables d’espace :

   Copié

   LABEL_STUDIO_BASE_DATA_DIR=/data
   STORAGE_PERSISTENCE=1

4. Reconstruction d'usine de l'Espace.

Définissez un secret Space SECRET_KEY pour maintenir les sessions utilisateurs actives entre les redémarrages. Sans cela, Label Studio génère une clé aléatoire à chaque démarrage et tous les utilisateurs se déconnectent lors du redémarrage.

Laissez un agent de codage le faire pour vous

Si vous préférez ne pas naviguer dans les paramètres de l’Espace, vous pouvez demander à un agent de codage ayant accès à huggingface_hub de provisionner l’Espace pour vous. Indiquez-lui votre identifiant d’Espace et le nom du bucket, et il pourra exécuter l’équivalent de :

from huggingface_hub import HfApi, Volume

api = HfApi()
space_id = "<your-namespace>/<your-space>"

# Attach the bucket at /data
api.set_space_volumes(
    space_id,
    volumes=[
        Volume(type="bucket", source="<your-namespace>/label-studio-data", mount_path="/data"),
    ],
)

# Tell Label Studio to write its SQLite DB and media into the mounted bucket
api.add_space_variable(space_id, "LABEL_STUDIO_BASE_DATA_DIR", "/data")
api.add_space_variable(space_id, "STORAGE_PERSISTENCE", "1")

# Optional: set a stable SECRET_KEY so sessions survive restarts
api.add_space_secret(space_id, "SECRET_KEY", "<random-string>")

# Factory rebuild so the new mount and variables take effect
api.restart_space(space_id, factory_reboot=True)

Consultez le guide manage-spaces pour en savoir plus sur la gestion des espaces et des montages de volumes via huggingface_hub.

Activer la persistance avec Postgres

Pour des déploiements multi-utilisateurs plus lourds, vous pouvez à la place activer la persistance en connectant une base de données Postgres externe à votre space, ce qui garantit que tous les paramètres de projet et d’annotation sont conservés.

Définissez les variables secrètes suivantes pour correspondre à votre propre instance hébergée de Postgres. Nous recommandons vivement de les définir en tant que secrets afin d’éviter de divulguer des informations sur votre service de base de données au public dans la définition de vos spaces.

• DJANGO_DB : définissez cette valeur sur default.

• POSTGRE_NAME : Définissez cette variable avec le nom de la base de données Postgres.

• POSTGRE_USER : Définissez cette variable avec le nom d'utilisateur Postgres.

• POSTGRE_PASSWORD : Définissez cette variable avec le mot de passe de votre utilisateur Postgres.

• POSTGRE_HOST : Définissez cette variable sur l'hôte où votre base de données Postgres est exécutée.

• POSTGRE_PORT : Définissez cette variable sur le port sur lequel votre base de données Postgres est exécutée.

• STORAGE_PERSISTENCE : définissez cette variable sur 1 pour supprimer l'avertissement relatif au stockage éphémère.

Redémarrez le Space pour appliquer ces paramètres. Les informations sur les utilisateurs, les projets et les annotations seront stockées dans la base de données et rechargées par Label Studio si le space est redémarré ou réinitialisé.

Activer le stockage cloud

Par défaut, le seul stockage de données activé pour cet espace est le stockage local. En cas de réinitialisation de l'espace, toutes les données seront perdues. Pour activer un stockage permanent, vous devez activer un connecteur de stockage cloud. Choisissez le connecteur cloud approprié et configurez les secrets associés.

Amazon S3

• STORAGE_TYPE : définissez cette valeur sur s3.

• STORAGE_AWS_ACCESS_KEY_ID: <YOUR_ACCESS_KEY_ID>

• STORAGE_AWS_SECRET_ACCESS_KEY: <YOUR_SECRET_ACCESS_KEY>

• STORAGE_AWS_BUCKET_NAME: <YOUR_BUCKET_NAME>

• STORAGE_AWS_REGION_NAME: <YOUR_BUCKET_REGION>

• STORAGE_AWS_FOLDER : définissez cette variable sur une chaîne vide.

Google Cloud Storage

• STORAGE_TYPE : définissez cette valeur sur gcs.

• STORAGE_GCS_BUCKET_NAME: <YOUR_BUCKET_NAME>

• STORAGE_GCS_PROJECT_ID: <YOUR_PROJECT_ID>

• STORAGE_GCS_FOLDER : définissez cette valeur sur une chaîne vide.

• GOOGLE_APPLICATION_CREDENTIALS : définissez cette variable sur /opt/heartex/secrets/key.json.

Azure Blob Storage

• STORAGE_TYPE : définissez cette valeur sur azure.

• STORAGE_AZURE_ACCOUNT_NAME: <YOUR_STORAGE_ACCOUNT>

• STORAGE_AZURE_ACCOUNT_KEY: <YOUR_STORAGE_KEY>

• STORAGE_AZURE_CONTAINER_NAME: <YOUR_CONTAINER_NAME>

• STORAGE_AZURE_FOLDER : définissez cette variable sur une chaîne vide.

🤗 Étapes suivantes, retours et assistance

Pour commencer avec Label Studio, consultez le tutoriel « De zéro à un » de Label Studio, qui vous guide à travers un projet d’annotation d’analyse de sentiments. Vous trouverez un ensemble complet de ressources sur Label Studio et la communauté Label Studio sur la page d’accueil de Label Studio. Cela inclut la documentation complète, un terrain de jeu interactif pour tester différentes interfaces d’annotation, ainsi que des liens pour rejoindre la communauté Slack de Label Studio.