clicurve 0.1.0

Terminal TensorBoard viewer — visualize training curves without a browser
clicurve-0.1.0 is not a library.

clicurve

A fast, interactive TensorBoard viewer that runs entirely in your terminal. No browser, no port forwarding, no fuss — just point it at your experiment logs.

Built in Rust. Reads TFEvent files directly (protobuf parsing, no Python dependency).

Install

cargo install clicurve

Or build from source:

git clone https://github.com/rfbr/clicurve
cd clicurve
cargo build --release
# binary is at target/release/clicurve

Usage

# Single experiment
clicurve /path/to/experiment/tensorboard/

# Multiple experiments — auto-detects subdirectories with tensorboard/ folders
clicurve /path/to/xps/

# Quick look at available metrics
clicurve /path/to/xps/ --list

# Pre-filter metrics and start with log scale
clicurve /path/to/xps/ -f "train/ce" -l

Keybindings

Key Action
j / k or arrows Navigate metric list
Space Toggle metric or experiment selection
Tab Switch between Experiments and Metrics panels
/ Filter metrics by name
c Clear filter
s / S Decrease / increase EMA smoothing
l Toggle log scale
t Toggle X-axis between step and wall-clock time
a Select / deselect all
r Reload data from disk
q Quit

Mouse hover over the chart shows the nearest data point value.

Features

  • Multi-experiment comparison — select multiple experiments, same metric plotted with distinct colors per experiment
  • EMA smoothing — adjustable exponential moving average with bias correction (same algorithm as TensorBoard), raw data shown faded behind the smoothed line
  • Mouse hover — tooltip with exact metric name, step, and value
  • Live reload — auto-refreshes every 30s, or press r to reload manually
  • Fast — reads TFRecord protobuf directly in Rust, handles hundreds of event files in seconds
  • Zero dependencies outside Rust — no Python, no TensorFlow, no browser

How it works

clicurve reads TensorBoard's binary event files (events.out.tfevents.*) directly using a minimal protobuf decoder. It extracts scalar metrics and renders them as interactive braille-character line charts using ratatui.

License

MIT