Install

Quick Install

Linux / macOS

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

Windows

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

Note

The installer downloads the latest binary from GitHub Releases to ~/.local/bin on Linux/macOS or %LOCALAPPDATA%\vizb on Windows. No admin required.

Docker

Pull the image and start the API on port 8080:

docker pull goptics/vizb
docker run -d --rm -p 8080:8080 goptics/vizb

The image starts vizb serve bound to 0.0.0.0 inside the container.

For CLI use, mount the current directory so Vizb can read inputs and persist outputs:

docker run --rm -v "$PWD:/data" -w /data goptics/vizb bar sales.csv -o out.html

Pipe input with -i; the mounted directory still keeps the generated file:

cat sales.csv | docker run --rm -i -v "$PWD:/data" -w /data goptics/vizb bar -o out.html

Caution

The API has no built-in authentication. Do not expose it publicly without your own authentication, TLS, and access controls. See vizb serve for details and port remapping.

Go Install

go install github.com/goptics/vizb@latest

Note

Building from source requires Go 1.26+. Install Go from the official site or via webi. Pre-built binaries and the install script need no Go runtime.

Updating

vizb update

Standalone Linux and macOS installs from the script or release archives update in place after verifying the release checksum. Windows standalone installs print the PowerShell reinstall command and are not modified automatically. Vizb delegates package-managed installs instead of overwriting them: Go installs receive the corresponding go install command, and WinGet installs receive the corresponding winget upgrade command.

See vizb update for the complete detection and safety behavior.

Download Binary

Pre-built binaries for Linux, macOS, and Windows (amd64 and arm64) are on the releases page. Prefer the latest release assets from that page. The commands below use v0.18.2 as an illustrative version pin — replace it with the version you want.

Linux

# Example pin — swap v0.18.2 for the release you need
curl -sfL https://github.com/goptics/vizb/releases/download/v0.18.2/[email protected] | tar xz
chmod +x vizb
sudo mv vizb /usr/local/bin/

macOS

# Apple Silicon (M1/M2/M3) — example pin
curl -sfL https://github.com/goptics/vizb/releases/download/v0.18.2/[email protected] | tar xz
chmod +x vizb
sudo mv vizb /usr/local/bin/

# Intel
curl -sfL https://github.com/goptics/vizb/releases/download/v0.18.2/[email protected] | tar xz
chmod +x vizb
sudo mv vizb /usr/local/bin/

Windows

1. Download the latest vizb@*-windows-amd64.zip (or a specific version such as [email protected]) from releases
2. Extract vizb.exe
3. Add to a directory in your PATH

Verify

vizb --version
vizb --help

A successful install prints a version line (for example v0.18.2) and the root help text.

Next

After install, return to the Introduction for your first chart, or read Dimensions.