tensorflow / tensorflow/tensorboard

Issue: TensorBoard wheels on PyPI fail with setuptools >81 due to deprecated pkg_resources removal

Open
#7,107 2 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
7.2k
Forks
1.7k
Avg merge
4d 22h
Merged PRs (30d)
1

Description

Summary

The latest released TensorBoard packages on PyPI currently fail to run with newer versions of setuptools (>81), because they still depend on pkg_resources, which has been removed/deprecated in recent setuptools releases.

This issue appears to already be fixed in PR #7057, but no new wheel/package containing the fix has been released to PyPI yet.

As a result, fresh environments using modern setuptools versions cannot run TensorBoard from the latest published release.


Affected Packages
  • tensorboard==2.20.0

    • Released: Jul 18, 2025
  • tb-nightly==2.21.0a20251023

    • Released: Oct 23, 2025

Problem

Running TensorBoard in an environment with newer setuptools versions results in import/runtime failures because pkg_resources is no longer available.

Example environment:

pip install -U setuptools
pip install tensorboard
tensorboard

Observed failure:

ModuleNotFoundError: No module named 'pkg_resources'

Root Cause

TensorBoard still imports/depends on pkg_resources, which has been deprecated for a long time and removed in newer setuptools releases (>81).

The fix already exists in:

  • PR #7057

However, no released wheel currently includes this fix.


Request

Please publish a new release (or at minimum a new wheel) containing the changes from PR #7057 so TensorBoard works correctly with modern setuptools versions.

This currently breaks clean installs in up-to-date Python environments and affects downstream tooling relying on TensorBoard.


Additional Notes

A temporary workaround is pinning setuptools to an older version:

pip install "setuptools<81"

But this is only a workaround and not ideal for reproducible modern environments.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing PR #7057 and compare its changes with the published tensorboard 2.20.0 and tb-nightly 2.21.0a20251023 packages. Verify the setuptools compatibility issue using the provided pip installation steps; done means a new wheel or release containing the fix is available on PyPI.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
release
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.