Trackio documentation

Разверните сервер Trackio самостоятельно

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Разверните сервер Trackio самостоятельно

Вы можете запустить дашборд и API Trackio на собственном компьютере (или на любом хосте, которым вы управляете) и отправлять метрики из скриптов обучения на этот сервер по HTTP. Это альтернатива записи в Hugging Face Space через space_id.

Запустите сервер локально

Установите Trackio, затем запустите дашборд. По умолчанию он слушает адрес 127.0.0.1 и использует порт из переменной GRADIO_SERVER_PORT, если она задана, иначе 7860 (см. Запуск дашборда).

Shell
Python
trackio show

Оставьте этот процесс запущенным во время обучения. В терминале выводится базовый URL для UI и URL, содержащий write token; любой, кто имеет доступ к этому URL с токеном, может выполнять операции записи, поддерживаемые сервером (например, переименование запусков), поэтому на недоверенных сетях обращайтесь с ним как с секретом.

Слушать на всех интерфейсах

Чтобы получить доступ к панели управления с другого устройства в вашей сети (или из контейнеров), привяжите сервер ко всем интерфейсам:

Shell
Python
trackio show --host 0.0.0.0

Убедитесь, что ваша межсетевая экранирующая система и политики безопасности разрешают нужный вам трафик.

Направьте код обучения на ваш сервер

В вашем скрипте обучения передайте server_url и укажите токен записи: либо включите write_token в строку запроса (тот же URL, который печатает дашборд для доступа на запись, либо значение full_url, возвращаемое trackio.show()), либо передайте базовый URL, например http://127.0.0.1:7860/, и установите переменную окружения TRACKIO_WRITE_TOKEN в значение этого токена. Вы также можете установить TRACKIO_WRITE_TOKEN на сервере Trackio перед запуском trackio.show(), чтобы выбрать токен записи сервера, а не использовать случайный токен, генерируемый при запуске. Приём метрик и загрузка данных требуют этот токен, если сервер не размещён на Hugging Face Spaces. Кроме того, вместо передачи server_url в коде можно установить TRACKIO_SERVER_URL.

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

Приоритет: space_id / TRACKIO_SPACE_ID всегда имеет преимущество перед server_url / TRACKIO_SERVER_URL, если заданы оба (в коде или в окружении). В этом случае Trackio работает так, как если бы была настроена только Space.

Специфичные для Hugging Face параметры, такие как dataset_id (устаревший; используйте вместо него bucket_id) и bucket_id, применяются только при записи логов в Space. Если действует только server_url, настройте сохранение данных на машине, где запущен сервер (например, с помощью переменной TRACKIO_DIR на этом хосте). См. Переменные окружения.

См. также

Update on GitHub