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.

Install

pip install "hedron-core>=0.18.0"
# or
uv add "hedron-core>=0.18.0"

Requires Python 3.11, 3.12, 3.13, or 3.14. Current train: 0.18.0.

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

What it does not include

• HTTP routing, FastAPI/Flask/Django adapters, HTMX request handling
• CLI, Component Explorer UI, charts, or data grids

Prefer the FastAPI package hedron for application work. See the project README and the public roadmap guide.

Links

• Documentation
• Changelog
• Source
• hedron

License

MIT. See LICENSE.