Skip to content

Optional packages

Hedron ships independently publishable packages beside the flagship FastAPI distribution. Start with the flagship and adapters if you are new; use this catalog for extras.

Start here (flagship and hosts)

Package Role Docs
hedron FastAPI flagship First app · Hedron API
hedron-core Framework-neutral renderer Architecture
hedron-flask Flask host adapter Flask · Adapters
hedron-django Django host adapter Django · Adapters

Most extras install as flagship extras (hedron[data], hedron[dev], …). A few (hedron-sample-kit, hedron-sim) install directly.

Maturity

Package maturity (Beta / Alpha) ≠ capability readiness (Supported / Experimental). See How to read and What’s ready. Pin versions on 0.x.

Beta extensions (0.20.x)

Package Extra Role
hedron-data hedron[data] DataTable, DataEditor, data sources
hedron-jinja hedron[jinja] .hdj templates over Jinja / HTML / HTMX
hedron-explorer hedron[dev] Development Component Explorer
hedron-extras hedron[extras] Curated toolkit (specialty widgets may be Experimental/stub)
hedron-conformance hedron[conformance] Language-neutral conformance kit 
pip install "hedron[data,dev]>=0.20.0,<0.21"

Alpha lines (0.1.x)

Pin and expect churn. Interactive chart runtimes, notebook preview, MCP, and Gradio interop are Experimental / Alpha — not production defaults.

Package Extra Role
hedron-charts hedron[charts] Chart components and visualization adapters
hedron-native hedron[native] Optional Rust HTML-escape acceleration
hedron-notebook hedron[notebook] Server-side notebook preview helper
hedron-mcp hedron[mcp] Deny-by-default MCP projection
hedron-gradio hedron[gradio] Gradio client interop
hedron-sample-kit — Reference third-party plugin shape
hedron-sim — Offline HTMX sims for static docs 
pip install "hedron[charts]>=0.1.0,<0.2"
pip install "hedron-sim>=0.1.0,<0.2"

Authoring an extension

Core stays framework-neutral; extensions depend toward hedron-core (and optionally hedron). See Plugin authoring and Project layout.

See also