Vizb

Quick Install

Linux / macOS

curl -fsSL https://vizb.goptics.org/install.sh | bash

Windows

irm https://vizb.goptics.org/install.ps1 | iex

Quick Example

Run one command to turn your GitHub contribution history into a 3D skyline of your activity over time. Each year stacks as a new layer; within it, every day is a column whose height is your contribution count. Replace <your-github-username> with your GitHub username and open the generated index.html.

Linux / macOS

curl -s "https://github-contributions-api.jogruber.de/v4/<your-github-username>" \
  | vizb bar \
      --group date \
      --group-pattern '[z{Year}-y{Month}-x{Date}]' \
      --json-path '.contributions' \
      --select 'count{Contributions}' \
      --stat \
      --output index.html

Windows

(iwr "https://github-contributions-api.jogruber.de/v4/<your-github-username>").Content `
  | vizb bar `
      --group date `
      --group-pattern '[z{Year}-y{Month}-x{Date}]' `
      --json-path '.contributions' `
      --select 'count{Contributions}' `
      --stat `
      --output index.html

Flags used below:

• --group date — group rows by date
• --group-pattern '[z{Year}-y{Month}-x{Date}]' — split each date into Year / Month / Day axes (z / y / x)
• --json-path '.contributions' — pull the nested contributions array out of the API envelope
• --select 'count{Contributions}' — keep only the count column and rename it to Contributions
• --stat — add the statistics panel
• --output index.html — write a self-contained HTML file

Features

Any CSV or JSON

Hand vizb a table and it charts it. Numeric columns each become their own chart. Vizb detects the format from the content. No flags required.

Interactive UI

Vue.js-powered interface in a single HTML file. Sort, swap axes, toggle scale, open statistics, and export JPEG. No server needed.

Multi-Chart

Bar, line, scatter, pie, heatmap, and radar charts in one view. Choose which renderers to embed with --charts.

Smart Grouping

Extract dimensions from labels and column values using pattern matching or regex. Handle 1D, 2D, 3D, or 4D data.

Flexible Input

Read CSV and JSON tables. Also read benchmark output from Go, Rust (Criterion, Divan), and JavaScript (Vitest, Tinybench). Vizb auto-detects the format.

Merge & Compare

Merge datasets from multiple runs, machines, or releases. Tag with version labels for cross-release comparison.

Statistics Panel

Per-series descriptive stats and correlation matrix. Computed off-thread so the UI stays responsive.

CI Ready

First-class GitHub Action. Run benchmarks, tag releases, merge history, and deploy from your workflow.

Explore

CommandsAll CLI flags and options for root, merge, and ui commands.

CI/CD IntegrationGitHub Action reference and step-by-step CI tutorials.

Group guidePattern and regex grouping for multi-dimensional data.

Merging GuideCombine benchmarks with tag-based inner and outer merging.