Trackioサーバーをセルフホストする

TrackioのダッシュボードとAPIを自分のマシン（または管理している任意のホスト）で実行し、トレーニングスクリプトからHTTP経由でそのサーバーにメトリクスを送信できます。これは、space_idを介してHugging Face Spaceにログを記録する代替手段です。

サーバーをローカルで実行する

Trackio をインストールし、ダッシュボードを起動します。デフォルトでは 127.0.0.1 でリッスンし、GRADIO_SERVER_PORT が設定されている場合はそのポートを使用し、設定されていない場合は 7860 を使用します（ダッシュボードの起動 を参照）。

trackio show

import trackio

trackio.show()

学習中は、そのプロセスを起動したままにしてください。ターミナルには、UIのベースURLと、write tokenを含むURLが表示されます。このトークンを使ってそのURLにアクセスできる人は、サーバーがサポートする書き込み操作（実行の名称変更など）を実行できるため、信頼できないネットワークでは秘密情報として扱ってください。

すべてのインターフェースでリッスンする

ネットワーク上の別のマシン（またはコンテナ）からダッシュボードにアクセスするには、すべてのインターフェースにバインドします:

trackio show --host 0.0.0.0

import trackio

trackio.show(host="0.0.0.0")

ファイアウォールおよびセキュリティポリシーが、意図したトラフィックを許可していることを確認してください。

トレーニングコードをサーバーに向ける

トレーニングスクリプトでは、server_url を渡し、書き込みトークン を指定します。クエリ文字列に write_token を埋め込む方法（ダッシュボードが表示する書き込みアクセス用の URL、または trackio.show() の戻り値である full_url）と、http://127.0.0.1:7860/ のようなベース URL を渡して TRACKIO_WRITE_TOKEN 環境変数にそのトークンを設定する方法のいずれかを使用できます。また、trackio.show() を起動する前に Trackio サーバー上で TRACKIO_WRITE_TOKEN を設定することで、起動時に生成されるランダムなトークンの代わりにサーバーの書き込みトークンを選択することもできます。サーバーが 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のみが設定されているかのように動作します。

dataset_id（非推奨。bucket_idを使用してください）やbucket_idなどの Hugging Face 固有のオプションは、Space へのログ出力時のみ適用されます。server_urlのみが有効な場合、サーバーが実行されているマシン上で永続化を設定してください（例：そのホスト上でTRACKIO_DIRを使用する）。環境変数を参照してください。

関連項目

• ダッシュボードの起動 — CLIオプション、ポート、リモートアクセス
• 環境変数 — TRACKIO_SERVER_URL、TRACKIO_DIR など