hedron-charts

Visualization adapters and chart components for Hedron.

Beginner LineChart / BarChart / AreaChart / ScatterChart, Matplotlib static SVG/PNG, Plotly interactive JSON, and Altair/Vega-Lite specifications.

Package maturity: Beta · Package version: 0.2.0

Interactive Plotly/Vega full browser runtimes remain experimental: Hedron ships host shims that fail closed when window.Plotly / window.vegaEmbed are missing. Applications may supply pinned local runtimes; first-party offline runtime pins exist for Experimental interactive hosts and are not Supported production Auto defaults.

Phase 0.38 first-party charts

Phase 0.38 ships hedron-charts 0.2.0 with typed ChartSpec / ChartPlan and an ABI-conforming hedron-chart Web Component (SVG default, Canvas for dense marks), publication-quality layout, accessible keyboard interactions, deterministic export, visual regression review, and hard performance/security budgets. Matplotlib remains Supported; Plotly/Altair stay Experimental. See RFC-0069 and the phase 0.38 acceptance packet.

Install

pip install "hedron[charts]>=0.38.0,<0.39"
# independent satellite:
pip install "hedron-charts>=0.2.0,<0.3"
# Add a backend when needed:
pip install "hedron-charts[matplotlib]>=0.2.0,<0.3"

Pin the living charts line at >=0.2.0,<0.3 for the Published 0.38 train.

Optional backends

Backend extras are optional and should be installed only for the adapter in use.

Quick start

from hedron_charts import LineChart

chart = LineChart(
    [{"month": "Jan", "revenue": 10}, {"month": "Feb", "revenue": 14}],
    x="month",
    y="revenue",
    title="Monthly revenue",
    description="Revenue increased during the period.",
)

LineChart falls back to SVG without Matplotlib. For an explicit Matplotlib figure:

import matplotlib.pyplot as plt
from hedron_charts import MatplotlibChart

fig, ax = plt.subplots()
ax.plot([1, 2, 3], [1, 4, 9])
chart = MatplotlibChart(fig, alt="y = x squared", description="Quadratic growth")

Links

• Package docs
• Charts and HTMX
• What’s ready
• Changelog
• Source
• Issues
• hedron-core · hedron

License

MIT. See the repository license.