course/pr_1213/es/chapter10/2.md

Configura tu instancia de Argilla[[set-up-your-argilla-instance]]

Para empezar a usar Argilla, primero tendrás que configurar tu propia instancia. Después deberás instalar el SDK de Python para poder gestionar Argilla mediante código Python.

Despliega la interfaz de Argilla

La forma más sencilla de configurar tu instancia de Argilla es mediante Hugging Face Spaces. Para crear tu Space de Argilla, solo tienes que seguir este formulario. Si necesitas más orientación, consulta la guía rápida de Argilla.

⚠️ Puede que te convenga habilitar Persistent storage para que los datos no se pierdan si el Space se pausa o se reinicia. Puedes hacerlo desde Settings en tu Space.

Una vez que Argilla esté en marcha, podrás iniciar sesión con tus credenciales.

Instala y conecta el SDK de Python

Ahora puedes ir a tu entorno de Python o notebook e instalar la librería argilla:

!pip install argilla

Conectémonos con nuestra instancia de Argilla. Para ello necesitarás la siguiente información:

• La URL de tu API: es la URL donde se está ejecutando Argilla. Si usas un Space, puedes abrirlo, hacer clic en los tres puntos de la esquina superior derecha, luego en "Embed this Space" y copiar la Direct URL. Debería verse como https://..hf.space.
• Tu API key: para obtenerla, inicia sesión en tu instancia de Argilla, ve a "My Settings" y copia la API key.
• Tu token de HF: si tu Space es privado, necesitarás un Access Token en tu cuenta de Hugging Face Hub con permisos de escritura.

import argilla as rg

HF_TOKEN = "..."  # solo para Spaces privados

client = rg.Argilla(
    api_url="...",
    api_key="...",
    headers={"Authorization": f"Bearer {HF_TOKEN}"},  # solo para Spaces privados
)

Para comprobar que todo funciona correctamente, llamaremos a me. Esto debería devolver nuestro usuario:

client.me

Si esto funcionó, tu instancia de Argilla está en marcha y ya estás conectado a ella. Bien.

Ahora podemos empezar cargando nuestro primer dataset en Argilla.