hedron-core

Framework-neutral typed rendering core for Hedron.

Defines models, security boundary types, components, the HTML serializer, Auto() intelligent rendering, cache protocols, ColorMode, utility built-ins, and the public render(...) -> RenderResult and request-scoped RenderSession APIs — with no FastAPI, Flask, Django, ASGI, or WSGI dependency.

Host adapters share this renderer:

• FastAPI — hedron
• Flask — hedron-flask
• Django — hedron-django

Package maturity: Beta · Train: 0.20.0 (Published) · pin >=0.20.0,<0.21

Install

pip install "hedron-core>=0.20.0,<0.21"
# or
uv add "hedron-core>=0.20.0,<0.21"

Requires Python 3.11–3.14.

Quick start

from hedron_core import Page, RenderContext, RenderMode, Text, render

result = render(
    Page(Text("Hello, Hedron"), title="Demo"),
    context=RenderContext.standalone(locale="en"),
    mode=RenderMode.PAGE,
)
print(result.html)

What this package includes

• Model, Props, FormModel, EventPayload, and Field
• Trust boundary types: Secret, TrustedHtml, SafeUrl, UrlPurpose
• Component protocol, registry, diagnostics (JSON/SARIF), and deterministic identity
• Context-aware HTML serializer, render(...) -> RenderResult, and RenderSession
• Scoped CSS, themes, assets, and component discovery helpers
• Built-ins for pages, forms, layout, landmarks, and content
• Framework-neutral plugin metadata and Explorer panel registration helpers
• Portable adapter contracts (AuthSignal, capability matrix, URL reverse request)

What it does not include

• HTTP routing or FastAPI / Flask / Django adapters
• HTMX request handling and CSRF middleware (host packages)
• CLI, Component Explorer UI, charts, or data grids

Prefer hedron for application work on FastAPI.

Links

• Documentation
• Architecture
• Changelog
• Source
• Issues
• hedron

License

MIT. See LICENSE.