<p align="center" <img src=".github/assets/logoicon.webp" alt="bino" width="100" / </p
<h1 align="center"bino</h1
<p align="center" <strongPixel-perfect PDF reports from YAML manifests and SQL queries.</strong </p
<p align="center" <a href="https://github.com/bino-bi/bino-cli/blob/main/LICENCE"<img src="https://img.shields.io/badge/License-AGPL--3.0-blue" alt="License" /</a <a href="https://github.com/bino-bi/bino-cli-releases/releases/latest"<img src="https://img.shields.io/github/v/release/bino-bi/bino-cli-releases?label=Release" alt="Latest Release" /</a <a href="https://github.com/bino-bi/bino-cli/actions"<img src="https://img.shields.io/github/actions/workflow/status/bino-bi/bino-cli/release.yml?label=Build" alt="Build Status" /</a <a href="https://github.com/bino-bi/bino-cli"<img src="https://img.shields.io/github/stars/bino-bi/bino-cli?style=flat&label=Stars" alt="GitHub Stars" /</a </p
<p align="center" <a href="https://cli.bino.bi"Documentation</a · <a href="https://github.com/bino-bi/bino-cli-releases/releases/latest"Download</a · <a href="https://github.com/bino-bi/bino-cli/discussions"Discussions</a </p
<br /
<p align="center" <img src=".github/assets/hero.png" alt="bino — YAML manifest to PDF report" width="720" / </p
<br /
[!WARNING] bino is under active development. Configuration and CLI APIs are not yet stable — expect breaking changes between releases.
[!NOTE] bino is currently tightly coupled to bn-template-engine as its visualization engine. This coupling will be removed in a future release, making the Viz Engine pluggable.
What is bino?
bino is a command-line tool that turns declarative YAML manifests and SQL queries into production-ready PDF reports. It uses DuckDB as an embedded SQL engine and Chrome headless shell for pixel-perfect PDF rendering.
For full documentation, visit cli.bino.bi.
Highlights
- Declarative reports — Define data sources, queries, layouts, and artefacts in YAML. No imperative code required.
- SQL-native — Query CSV, Excel, Parquet, and databases using DuckDB's full SQL dialect.
- Pixel-perfect PDFs — Chrome headless shell renders HTML templates to PDF with precise control over layout, pagination, and styling.
- Live preview — bino preview watches for changes and hot-reloads in the browser via SSE.
- Validation & linting — bino lint catches manifest errors before build. JSON Schemas power IDE auto-completion.
- VS Code extension — YAML validation and auto-completion for bino manifests, available in vscode-bino/.
Quick Start
Install
macOS (Homebrew):