#
Configurez votre instance Argilla

Pour commencer à utiliser Argilla, vous devrez d’abord mettre en place votre propre instance. Ensuite, vous devrez installer le SDK Python afin de pouvoir gérer Argilla avec Python.

##
Déployer l’interface utilisateur d’Argilla

La façon la plus simple de créer votre instance Argilla est de passer par Hugging Face Spaces. Pour créer votre Space Argilla, suivez simplement ce formulaire. Si vous avez besoin de plus de conseils, consultez la page « Argilla quickstart ».

⚠️ Vous pouvez activer le stockage persistant pour que les données ne soient pas perdues si l’espace est interrompu ou redémarré. Vous pouvez le faire à partir des paramètres de votre Space.

Une fois qu’Argilla est opérationnel, vous pouvez vous connecter avec vos identifiants.

##
Install and connect the Python SDK

Vous pouvez maintenant aller dans votre environnement Python ou votre notebook et installer la bibliothèque argilla : `!pip install argilla`

Connectons-nous à notre instance Argilla. Pour ce faire, vous aurez besoin des informations suivantes :

- Votre URL API : Il s’agit de l’URL où Argilla s’exécute. Si vous utilisez un Space, vous pouvez ouvrir le Space, cliquer sur les trois points dans le coin supérieur droit, puis « Embed this Space » et copier l’URL directe. Cela devrait ressembler à `https://<votre-nom-d'utilisateur>.<nom-de-l'espace>.hf.space`.
- Votre clé API : Pour obtenir votre clé, connectez-vous à votre instance Argilla et allez dans « My Settings », puis copiez la clé API.
- Votre token HF : Si votre Space est privé, vous aurez besoin d’un Access Token dans votre compte Hugging Face Hub avec des permissions d’écriture.

    import argilla as rg

    HF_TOKEN = "..."  # uniquement pour les spaces privés

    client = rg.Argilla(
        api_url="...",
        api_key="...",
        headers={"Authorization": f"Bearer {HF_TOKEN}"},  # uniquement pour les spaces privés
    )

Pour vérifier que tout fonctionne correctement, nous allons appeler `me`. Cela devrait nous renvoyer notre utilisateur :

    client.me

Si cela fonctionne, votre instance Argilla est opérationnelle et vous y êtes connecté ! Félicitations !

Nous pouvons maintenant commencer à charger notre premier jeu de données dans Argilla.

< > Update on GitHub