Trackio documentation

Autoalojar el servidor de Trackio

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Autoalojar el servidor de Trackio

Puedes ejecutar el panel y la API de Trackio en tu propia máquina (o en cualquier host que controles) y enviar métricas desde los scripts de entrenamiento a ese servidor a través de HTTP. Esta es una alternativa a registrar en un Hugging Face Space mediante space_id.

Ejecutar el servidor localmente

Instala Trackio y luego inicia el panel de control. De forma predeterminada, escucha en 127.0.0.1 y utiliza el puerto de GRADIO_SERVER_PORT si está definido, de lo contrario 7860 (consulta Iniciar el panel de control).

Shell
Python
trackio show

Deja ese proceso en ejecución mientras entrenas. La terminal imprime una URL base para la interfaz de usuario y una URL que incluye un write token; cualquier persona que pueda acceder a esa URL con el token puede realizar operaciones de escritura admitidas por el servidor (por ejemplo, renombrar ejecuciones), así que trátalo como un secreto en redes no confiables.

Escuchar en todas las interfaces

Para acceder al panel de control desde otra máquina de su red (o desde contenedores), vincúlese a todas las interfaces:

Shell
Python
trackio show --host 0.0.0.0

Asegúrate de que tu firewall y tus políticas de seguridad permitan el tráfico que pretendes.

Apunta el código de entrenamiento a tu servidor

En su script de entrenamiento, pase un server_url y proporcione el token de escritura: ya sea incrustando write_token en la cadena de consulta (la misma URL que imprime el panel para el acceso de escritura, o el valor devuelto full_url de trackio.show()), o pasando una URL base como http://127.0.0.1:7860/ y estableciendo la variable de entorno TRACKIO_WRITE_TOKEN en ese token. También puede establecer TRACKIO_WRITE_TOKEN en el servidor de Trackio antes de lanzar trackio.show() para elegir el token de escritura del servidor en lugar de usar el token aleatorio generado al inicio. La ingesta de métricas y las cargas requieren este token cuando el servidor no está en Hugging Face Spaces. También puede establecer TRACKIO_SERVER_URL en lugar de pasar server_url en el código.

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()

Precedencia: space_id / TRACKIO_SPACE_ID siempre tiene prioridad sobre server_url / TRACKIO_SERVER_URL cuando ambos están definidos (en el código o en el entorno). Trackio se comporta entonces como si solo se hubiera configurado el Space.

Las opciones específicas de Hugging Face, como dataset_id (obsoleto; use bucket_id en su lugar) y bucket_id, solo se aplican al registrar en un Space. Cuando solo está en vigor server_url, configure la persistencia en la máquina donde se ejecuta el servidor (por ejemplo, mediante TRACKIO_DIR en ese host). Consulte Variables de entorno.

Relacionado

Update on GitHub