📊 HolySheet¶

Python-first report compiler that turns raw data into stunning,
interactive React dashboards — zero frontend knowledge required.

A complete dashboard generated from Python — one HTML file, zero frontend knowledge required.

[![PyPI](https://img.shields.io/pypi/v/holysheet?color=3B82F6&style=flat-square)](https://pypi.org/project/holysheet) [![Python](https://img.shields.io/pypi/pyversions/holysheet?color=8B5CF6&style=flat-square)](https://pypi.org/project/holysheet) [![License](https://img.shields.io/github/license/UnicoLab/HolySheet?color=10B981&style=flat-square)](https://github.com/UnicoLab/HolySheet/blob/main/LICENSE)

Get Started in 30 Seconds¶

pip install holysheet

my_dashboard.py

from holysheet import Report, KPI, LineChart, DataTable

report = Report(title="Q4 Business Review", theme="dark")

report.add(KPI(label="Revenue", value="$2.26M", delta="+34%", status="positive"))
report.add(KPI(label="Users", value="42,000", delta="+72%", status="positive"))
report.add(LineChart(title="Revenue Trend", data=monthly_data, x="month", y="revenue"))
report.add(DataTable(title="Top Clients", data=clients))

report.export_html("report.html")  # ← Open in any browser. Done.

That's it!

The generated HTML is fully self-contained — no server, no internet, no Node.js required. Just open it in a browser, email it, or upload it anywhere.

Why HolySheet?¶

Python-First

Write dashboards in pure Python. No HTML, CSS, or JavaScript knowledge needed. Full type hints and Pydantic validation.
Single-File Export

Generate a standalone .html file (~1.5 MB) with everything embedded. Share via email, Slack, S3, or Confluence.
57 Block Types

KPIs, 18 chart types, 9 interactive controls, data tables, AI insights, timelines, user cards, and more.
3 Premium Themes

Dark, Light, and Executive themes with complete design systems — colors, typography, spacing, and chart palettes.
Any Data Source

Native support for Pandas DataFrames, Polars DataFrames, Python dicts, and lists. Auto-detection, zero config.
Powered by React

Interactive dashboards rendered with React + ECharts under the hood. Searchable tables, responsive layouts, smooth animations.

Feature Highlights¶

Feature	Description
57 block types	KPI, Metric, 18 chart types, AI insights, data tables, Google Sheets, SQL blocks, layout containers, interactive controls
3 themes	`dark`, `light`, `executive` — each with a full design system
3 export modes	Standalone HTML, folder (for hosting), or raw JSON
CLI included	`holysheet validate`, `holysheet serve`, `holysheet version`
Layout system	Columns, Sections, Tabs, Accordion, Stepper, Dividers
Interactive controls	Sliders, toggles, dropdowns, text inputs, checkboxes, radio buttons
Smart data handling	Auto-converts pandas, polars, dicts — handles NaN, datetime, Decimal
Validated	Every block is a Pydantic v2 model with full type safety

Explore the Docs¶

Getting Started

Install, build your first report, and understand the architecture.
Block Types

Reference for all 57 block types with examples.
Themes

Dark, Light, and Executive theme details.
Data Sources

Working with pandas, polars, dicts, and lists.
Export & Deploy

HTML, folder, JSON export modes and CLI.
API Reference

Complete API docs for Report, blocks, and utilities.
Examples Gallery

Real-world dashboard examples you can copy-paste.
Changelog

Version history and release notes.

Built with :heart: by UnicoLab · MIT License · Holy Sheet, that's a beautiful dashboard! :raised_hands: