Skip to content
bino docs
GitHub

Installation

bino is a command-line tool for building pixel-perfect PDF reports from YAML and SQL. This page shows how to install the binary on common platforms and confirm that everything works.

Supported platforms

Section titled “Supported platforms”

bino provides pre-built binaries for:

  • macOS (Intel, Apple Silicon)
  • Linux x86_64
  • Windows x86_64
Section titled “Install from GitHub Releases (recommended)”

  1. Open the bino GitHub repository in your browser and go to the Releases page.

  2. Download the archive that matches your platform, for example:

    • bino-rainbow_Darwin_x86_64.tar.gz
    • bino-rainbow_Darwin_arm64.tar.gz
    • bino-rainbow_Linux_x86_64.tar.gz
    • bino-rainbow_Windows_x86_64.zip

  3. Unpack the archive:

    # macOS / Linux
tar -xzvf bino-rainbow_Darwin_x86_64.tar.gz
# or
tar -xzvf bino-rainbow_Linux_x86_64.tar.gz

    On Windows, extract the .zip using File Explorer or a tool like 7-Zip.

  4. Move the bino (or bino.exe) binary onto your PATH:

    # macOS / Linux (example)
mv bino /usr/local/bin/

    On Windows, either place bino.exe in a folder that is already on %PATH% or add its folder to the system/user PATH.

  5. Verify the installation:

    bino version

    This should print the installed version and exit with status code 0.

Install from source using Go tooling

Section titled “Install from source using Go tooling”

If you have Go installed and prefer to build from source, you can use:

go install bino.bi/rainbow/cmd/bino@latest

This is mainly useful for contributors or environments without access to GitHub Releases.

Next steps

Section titled “Next steps”