What’s ready today¶

Ship today (pinned CRUD / admin on FastAPI, Flask, or Django): pages, HTMX fragments, CSRF, polling job status, DataTable, first-party charts, and maps. Do not treat as production defaults: SSE, WebSocket, Plotly/Altair, human screen-reader claims. hedron-core, hedron, edron, hedron-data, hedron-charts, and hedron-maps are Stable packages in the 1.0 inventory; host, tooling, and vendor-adapter satellites remain Beta. There is no SLA.

This page is the adopter maturity summary for the published 1.3.0 release (Current release and support). Full capability matrices and maintainer gate notes: What’s ready — evidence.

Can I ship an internal admin app?

Yes, with pins. Walkthrough: Build your first app → Minimal form → What is HTMX?. Ship checklist: Ship a Hedron app.

Labels in one screen¶

Label	Meaning
Supported	Works on the current train when pinned — ≠ API `stable` and ≠ package Beta
Experimental	Public; may change; prefer documented fallbacks (usually polling)
Deferred	Documented, not ready — do not treat as Supported

Hedron, Edron, data, charts, and maps on the 1.3.x line are the coordinated Stable train. Older 0.x packages remain migration fallbacks only. Package maturity, capability readiness, and API compatibility are separate axes — Maturity labels.

The two foundational runtime distributions, hedron-core and hedron, are checked in BasedPyright all mode with all diagnostics and Any use blocked in CI. Commit and release CI use the workspace package gate, so new type diagnostics cannot accumulate behind an otherwise green build.

Human accessibility testing protocol engineering is on the train; compensated screen-reader sessions are not Supported yet.

Live transports

SSE, focused streaming, WebSocket channels, and navigation preload are experimental (hedron.experimental). Prefer polling in production.

Ship today vs not defaults¶

Job	Status	Start here
CRUD / admin / forms	Supported	First app
Pages (`@app.page`)	Supported	Quickstart
HTMX views / actions (`@app.view` / `@app.action`)	Supported	Which interaction API?
Multi-worker durable jobs (polling)	Supported with shared Redis	Jobs
DataTable / DataEditor	Supported (`hedron-data`)	Data apps
Charts (first-party / Matplotlib)	Supported; Plotly/Altair Experimental	Chart API
Maps (bounded first-party inventory)	Supported; unsupported providers/features remain excluded	Maps API
Flask / Django hosts	Supported (host CSRF/pages; not FastAPI facade parity)	Flask · Django
Live SSE / WebSocket	Experimental	Prefer polling
Human screen-reader AT	Not Supported yet	Protocol engineering only — evidence

Host capability cheat sheet¶

Capability	FastAPI (`hedron`)	Flask (`hedron-flask`)	Django (`hedron-django`)
Pages + HTMX fragments + CSRF	Supported	Supported	Supported
`@app.page` / `@app.action` facades	Supported	Not on this host	Not on this host
Polling job status	Supported	Supported	Supported
Live SSE / WebSocket helpers	Experimental	Prefer polling	Prefer polling
DataTable / charts extras	Supported with pins	Supported with pins	Supported with pins

Need the long inventory (MCP, Gradio, Workbench, Application DX, Deferred rows)? Use What’s ready — evidence.

Recommended install¶

uv (recommended)pip

uvx --from "hedron>=1.0.0" hedron new my-app
cd my-app && uv sync
uv run uvicorn app:app --reload

pip install "hedron>=1.0.0" "uvicorn[standard]"
python -m hedron new my-app
cd my-app && pip install -e .
uvicorn app:app --reload

Require the current stable baseline: hedron>=1.0.0. Extras and compatibility notes: Installation. Sample kit: hedron-sample-kit>=0.2.3,<0.3.

Next¶

Audience	Page
Quick fit check	Evaluate Hedron
Ops ship checklist	Ship a Hedron app · Deployment
Security / procurement	Enterprise diligence · Threat model
Full matrices	What’s ready — evidence
Upgrade / roadmap	Upgrade · What’s next