Skip to main content

Terminal dashboard for comparing Weights & Biases runs from project or run URLs

Project description

wandb-tui

A lightweight terminal dashboard for comparing Weights & Biases runs directly from W&B project or run URLs.

It was built for remote/cloud W&B runs when you want a LEET-like terminal view without needing the original local wandb/ run directories.

Features

  • Single-run metric dashboard
  • Multi-run project comparison from a W&B project URL
  • W&B-style per-run colored columns
  • plotext line charts for multi-run metric overlays
  • Metric search, group filtering, sorting, and refresh
  • JSON export for downstream analysis
  • Works against public runs without wandb installed; uses WANDB_API_KEY automatically for private runs

Install / run with uv

uv sync

Run the CLI entrypoint:

uv run wandb-tui --help

Or run it as a Python module:

uv run python -m wandb_tui --help

Usage

Compare recent runs in a project

uv run wandb-tui \
  'https://wandb.ai/aurora_gpt/ezpz.examples.fsdp_tp?nw=nwuserforemans' \
  --runs 8

Press m to toggle from table mode to plot mode.

View a single run

uv run wandb-tui \
  https://wandb.ai/aurora_gpt/ezpz.examples.fsdp_tp/runs/vrxuo55p

Non-interactive table snapshot

uv run wandb-tui \
  'https://wandb.ai/aurora_gpt/ezpz.examples.fsdp_tp?nw=nwuserforemans' \
  --runs 8 \
  --once \
  --search train/loss \
  --group train

Export JSON

uv run wandb-tui \
  'https://wandb.ai/aurora_gpt/ezpz.examples.fsdp_tp?nw=nwuserforemans' \
  --runs 8 \
  --json /tmp/wandb_project_metrics.json

Controls

Key Action
q Quit
/ , j / k Scroll
PgUp / PgDn Page scroll
Home / End Jump
/ Search metric names
Esc Clear search
g Cycle metric group filter
m Toggle table/chart mode in project view
s Cycle sort mode
r Refresh from W&B
? Help

W&B LEET comparison

W&B's official LEET TUI is excellent for local wandb/ directories and .wandb files, and newer versions support remote single-run URLs. This tool focuses on remote multi-run project comparisons over W&B's GraphQL API.

Notes

  • Public W&B projects/runs can be queried without authentication.
  • For private projects, set WANDB_API_KEY in your environment.
  • plotext is included as a dependency for chart mode.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wandb_tui-0.1.0.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wandb_tui-0.1.0-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

File details

Details for the file wandb_tui-0.1.0.tar.gz.

File metadata

  • Download URL: wandb_tui-0.1.0.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wandb_tui-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ad3a9e2f50c3aa32bc6158d522117db002a0555f048222a3a7798e8a126a1405
MD5 4fb92d2a40ce66faa741ab25e6d31a22
BLAKE2b-256 edc55b08eeb81cc0c1d4fb6abc39357cec193126eee86b2c4c10f14cfe42803c

See more details on using hashes here.

File details

Details for the file wandb_tui-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: wandb_tui-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 13.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wandb_tui-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5522448d44f0e1a1c85223764104e3a9c7ff4cd161acc1fd60f7e4e646320cbb
MD5 e95ecb78cb939d54c0be0e5d051270d0
BLAKE2b-256 7031e02cc8f0b3a13ed6a2c3321b89e3eaaba96a0cadd10d0fd982c6ea256ce8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page