BinoBI CLI documentation

Every month, teams export data, paste into spreadsheets, tweak formatting, and email PDFs. bino replaces that loop with a code-driven pipeline: YAML manifests define your report, SQL queries shape the data, and bino build produces the PDF. Version-controlled, reproducible, automated.

Quick Install

/bin/bash -c "$(curl -fsSL https://github.com/bino-bi/bino-cli-releases/releases/latest/download/install.sh)"

From YAML to PDF in seconds

Write a few lines of YAML, point bino at your data, and get a pixel-perfect PDF. The same workflow runs on your laptop and in CI.

# data.yaml
apiVersion: bino.bi/v1alpha1
kind: DataSource
metadata:
  name: revenue_data
spec:
  type: inline
  content:
    - category: "DACH"
      ac1: 4250
      pp1: 3800
    - category: "Nordics"
      ac1: 2870
      pp1: 2650

bino build   # produces dist/report.pdf

Built with bino

Real report pages generated from YAML + SQL. Every pixel defined in code.

Sales Dashboard A 2x2 grid layout combining structure charts, time series, tables, and text.

Structure Chart IBCS-compliant bar chart with absolute and relative variance columns.

Time Series Chart Monthly revenue trend with actual, prior year, and forecast scenarios.

Text & Markdown Rich text component with Markdown support for executive summaries.

Layout Cards Reusable card components for modular dashboard composition.

‹ ›

Why Bino?

The developer-first reporting engine.

📄

Declarative & Git-Ready

Reports as code. YAML & SQL. Commit, diff, and review your reporting pipeline just like your application code.

🔌

Data Agnostic

Powered by DuckDB. Query Postgres, MySQL, Parquet, CSV, and JSON directly. No ETL required.

✨

Pixel-Perfect PDFs

Typesetting-quality output. Control every margin, header, and page break with absolute precision.

⚡

Dev Experience

Instant hot-reloading, TypeScript-like schema validation, and a CLI that gets out of your way.

Who uses bino

Teams that ship reports on a schedule.

💰

Finance & Controlling

Monthly management reports, P&L summaries, board decks — versioned and reproducible.

📊

SaaS Companies

Branded client usage reports generated automatically from your analytics database.

🏢

Agencies

White-label analytics for multiple clients. One template, per-client branding.

🚚

Operations

Multi-region dashboards and operational KPIs distributed on a weekly schedule.

🔧

Data Engineers

Add PDF output to existing pipelines. No BI platform needed — just YAML and SQL.

Start Building

Getting Started

Install CLI, scaffold your first report, and see it live in seconds.

Core Concepts

Master workdirs & manifests. Learn how datasources and layouts compose together.

Guides

Deep dives into data connection, advanced styling, i18n, and digital signing.

Reference

Complete schema reference. Every field, every type, every option documented.

Go Further with Enterprise

Scale your reporting infrastructure with expert support and custom solutions.

🌟 Enterprise Support

Dedicated SLAs, architectural reviews, and priority troubleshooting for mission-critical pipelines.

🧩 Custom Development

Bespoke data connectors, specialized layout components, and custom rendering logic built for you.

🎓 Training

Accelerate team adoption with workshops on declarative reporting patterns and data engineering.

🔒 Commercial Licensing

Building a SaaS? Embed BinoBI into your product. Contact us for OEM & commercial licenses.

Talk to Sales