Getting Started

Vizb turns tables and benchmark output into interactive HTML charts. Feed it a CSV file, a JSON file, or benchmark results from Go, Rust, or JavaScript. Vizb detects the input format from the content. You only need --parser/-P when you want to override the guess.

Tip

Just run vizb <input> -o output.html. Vizb inspects the content, picks the parser, and prints its choice (✨ Auto-detected parser: …).

Visualize Tabular Data

Turn any CSV or JSON table into charts. Numeric columns/fields each become their own chart.

CSV

vizb data.csv -o output.html

Use --group/-g to turn non-numeric columns into the name / X / Y / Z dimensions:

vizb data.csv -g name -o output.html

JSON

A JSON array of objects. Each object is a row. Each numeric key becomes its own chart. Nested objects flatten to dotted keys.

vizb data.json -o output.html

Group by one or more fields with --group/-g:

vizb data.json -g name -o output.html

Note

A go test -bench -json event stream is not treated as tabular JSON. It stays a Go benchmark. Full rules are in the Tabular Data guide.

Detection is automatic. You can force the parser with -P csv or -P json.

Visualize Benchmarks

Pipe benchmark output straight in. The framework is detected from the content. No --parser is needed in most cases.

Go

Pipe

go test -bench . | vizb -o output.html

From a saved file

go test -bench . > bench.txt
vizb bench.txt -o output.html

JSON event stream (go test -bench -json is detected and converted automatically)

go test -bench . -json | vizb -o output.html

Note

To build from source, Go 1.26+ is required. Pre-built binaries from the installation page need no Go runtime.

Rust

Criterion and Divan output are both read from cargo bench.

Pipe

cargo bench | vizb -o output.html

From a saved file

cargo bench > bench.txt
vizb bench.txt -o output.html

JavaScript

Works with Vitest (npx vitest bench) and Tinybench (node bench.js).

Pipe

npx vitest bench | vizb -o output.html

From a saved file

npx vitest bench > bench.txt
vizb bench.txt -o output.html

Experimental

Vitest benchmarking is experimental and does not follow SemVer. Output-format changes may break the parser. See the Parser Guide.

Detection is automatic. You can force the parser with -P go, -P rs:criterion, -P rs:divan, -P js:vitest, or -P js:tinybench.

Tip

Save any run as JSON to merge it later — vizb bench.txt -o output.json, then vizb output.json -o output.html. Every supported format and the metrics each one extracts are covered in the Parser Guide.

Next Steps

InstallationGo install, binary download, and PATH setup.

Tabular DataChart any CSV or JSON table.

Parser GuideSupported inputs — CSV, JSON, Go, Rust, JavaScript.

CommandsAll CLI flags and options.

Group guideMulti-dimensional data with patterns and regex.

ChartsPick the right chart type for your data.

TroubleshootingCommon errors and how to fix them.