{"id":5730,"library":"tensorboard-data-server","title":"TensorBoard Data Server","description":"The `tensorboard-data-server` library, currently at version 0.7.2, provides fast data loading capabilities specifically designed for TensorBoard. It's a key component within the larger TensorBoard ecosystem, optimizing the ingestion and serving of experiment data for visualization. It is released independently but closely aligned with TensorBoard's development, which has a more frequent release cadence.","status":"active","version":"0.7.2","language":"en","source_language":"en","source_url":"https://github.com/tensorflow/tensorboard/tree/master/tensorboard/data/server","tags":["machine-learning","tensorflow","tensorboard","data-loading","rust","performance"],"install":[{"cmd":"pip install tensorboard-data-server","lang":"bash","label":"Install stable version"},{"cmd":"pip install tensorboard # This will also install tensorboard-data-server as a dependency","lang":"bash","label":"Install via TensorBoard"}],"dependencies":[{"reason":"This package is a core dependency for the `tensorboard` visualization tool, which relies on it for fast data loading.","package":"tensorboard"},{"reason":"The server component itself is written in Rust and requires a compatible binary built with the Rust toolchain.","package":"Rust toolchain","optional":true}],"imports":[{"note":"While the package can be imported, its primary use is as a backend component for TensorBoard, rather than direct user-level programmatic interaction. TensorBoard leverages `tensorboard_data_server.server_binary()` internally to locate the server executable.","symbol":"tensorboard_data_server","correct":"import tensorboard_data_server"}],"quickstart":{"code":"import tensorflow as tf\nimport datetime\n\n# Create a log directory\nlog_dir = \"logs/fit/\" + datetime.datetime.now().strftime(\"%Y%m%d-%H%M%S\")\nwriter = tf.summary.create_file_writer(log_dir)\n\n# Log a scalar value\nwith writer.as_default():\n    for i in range(100):\n        tf.summary.scalar(\"my_metric\", i * 0.1, step=i)\n    writer.flush()\n\nprint(f\"TensorBoard logs saved to: {log_dir}\")\nprint(\"To view, run in your terminal: \")\nprint(f\"tensorboard --logdir {log_dir} --load_fast=true\")","lang":"python","description":"The `tensorboard-data-server` is typically leveraged automatically by `tensorboard`. This example shows how to generate logs and then start TensorBoard, explicitly enabling the fast data server. The `--load_fast=true` flag instructs TensorBoard to use the Rust-based data server for improved performance."},"warnings":[{"fix":"Always refer to the `tensorboard` package version for overall compatibility and feature sets. The data server's version reflects its internal development.","message":"The `tensorboard-data-server` version (e.g., 0.7.2) is significantly lower and has an independent release cycle compared to the main `tensorboard` package (e.g., 2.20.0). Do not assume their versions are directly correlated or that features align strictly by version number.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Avoid direct imports or usage of `tensorboard-data-server` unless specifically instructed by TensorBoard documentation or for development purposes. Rely on `tensorboard` to manage its interaction.","message":"The PyPI classification for `tensorboard-data-server` lists its Development Status as '2 - Pre-Alpha'. While it's a dependency of the stable `tensorboard` package, direct programmatic interaction with `tensorboard-data-server` may expose unstable APIs or behaviors.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure your system's GLIBC version meets the requirements of the `tensorboard-data-server` wheel. If upgrading GLIBC is not an option, be aware that performance might be degraded without the native server, as TensorBoard will use a slower Python fallback.","message":"Users on systems with older GLIBC versions (e.g., CentOS 7 with GLIBC_2.17) might encounter 'GLIBC_2.18' not found errors when trying to use the native data server binary. This can cause TensorBoard to fall back to a slower, Python-based log ingester.","severity":"gotcha","affected_versions":"Versions 0.7.x on systems with GLIBC < 2.18"},{"fix":"Use TensorBoard locally or with self-hosted solutions. The `tensorboard dev upload` command is no longer functional.","message":"The TensorBoard.dev hosted service has been shut down. Commands like `tensorboard dev upload` will fail. This is a breaking change for the broader TensorBoard ecosystem that relies on the data server.","severity":"deprecated","affected_versions":"TensorBoard 2.15.1 and higher (indirectly affects data server usage)"}],"env_vars":null,"last_verified":"2026-03-29T00:00:00.000Z","next_check":"2026-06-27T00:00:00.000Z"}