hedron-django

Django adapter for Hedron component rendering and HTMX interactions.

Render components as HttpResponse, map portable InteractionResult values, reverse URLs via Django’s resolver, and integrate CSRF/session through native middleware. Shares the hedron-core renderer with FastAPI and Flask. Does not install FastAPI.

Also ships a first-party bounded QuerySet DataSource and Django forms bridge — supply an already-authorized base QuerySet; omitted sort/filter allowlists deny client refinements.

Package maturity: Beta · Train: 0.53.x (in-tree tip v0.53.0) · pin >=0.53.0,<0.54 (PyPI still >=0.52.0,<0.53 while deferred)

Adapter capability readiness is Supported when pinned — see What’s ready.

Install

pip install "hedron-django>=0.52.0,<0.53"
# or
uv add "hedron-django>=0.52.0,<0.53"

Requires Python 3.11–3.14, hedron-core, and Django >=5.2,<6.

Install the AppConfig for system checks:

INSTALLED_APPS = [
    # ...
    "hedron_django.apps.HedronDjangoConfig",
]

Scaffold a new Django project:

uvx --from "hedron>=0.52.0,<0.53" hedron new --django my-django-app

Quick start

from django.http import HttpRequest
from hedron_core import Heading, Page, Text
from hedron_django import HedronDjango, hedron_view

hedron = HedronDjango()


@hedron_view
def home(request: HttpRequest):
    return hedron.respond(
        Page(
            Heading("Hello Django", level=1),
            Text("Native Django URLconf with Hedron components."),
            title="Home",
        ),
        request,
    )

Wire the view into your URLconf as usual. For HTMX fragments, declare fragment_regions on @hedron_view and return an InteractionResult.

What this package includes

HedronDjango / respond rendering facade
@hedron_view decorator with fragment-region policy
HedronDjangoConfig system checks
HedronSecurityHeadersMiddleware for portable SecurityPolicy headers
Forms bridge and bounded QuerySet DataSource
Job status polling helpers

License

MIT. See the repository license.

Release files for hedron-django 0.53.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hedron-django 0.53.0
File	Size	Uploaded
hedron_django-0.53.0.tar.gz	22.6 kB	Aug 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for hedron-django 0.53.0
File	Interpreter	ABI	Platform	Reset
hedron_django-0.53.0-py3-none-any.whl 24.9 kB Aug 20, 2026	Python 3	none	any	Details

Total release size: 47.5 kB

Release files / hedron_django-0.53.0.tar.gz

Download URL	hedron_django-0.53.0.tar.gz
Size	22.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`61ebb58acad1ad1c37114dff52c975245657ab43c24116dd9e3238401e6460bc`
BLAKE2b-256 checksum How to use checksums	`63131736330d18defe8a9e43db52b3ce5ba51623b5190b58d25a92d0c8390a73`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / hedron_django-0.53.0-py3-none-any.whl

Download URL	hedron_django-0.53.0-py3-none-any.whl
Size	24.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ba7da2a05b7523128e36cbb60b4462d4a73a0c8c85397a0bf5079dcf1003b165`
BLAKE2b-256 checksum How to use checksums	`1cefd94e3b5948dcdcb2526772049c2ea40edd3207c0fb0af945df425b7d2d5d`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`