hedron-flask

Flask adapter for Hedron component rendering and HTMX interactions.

Render Page / fragment components with the same hedron-core renderer used by FastAPI, map portable InteractionResult values to native Flask responses, and integrate CSRF double-submit cookies with Flask sessions. Does not install FastAPI.

Package maturity: Beta · Package line: 1.0.x · pin >=1.0.0,<2.0

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

Install

pip install "hedron-flask>=1.0.0,<2.0"
# or
uv add "hedron-flask>=1.0.0,<2.0"

Requires Python 3.10–3.14, hedron-core, and Flask 3.x.

Scaffold a new Flask app:

uvx --from "hedron>=1.0.0" hedron new --flask my-flask-app

Quick start

from flask import Flask
from hedron_core import Heading, Page, Text
from hedron_core.interaction import FragmentRegion, InteractionResult
from hedron_flask import HedronBlueprint, HedronFlask

hedron = HedronFlask()
ui = HedronBlueprint("ui", __name__)
PANEL = FragmentRegion(id="panel", selector="#panel")


@ui.page("/")
def home():
    return Page(
        Heading("Hello Flask", level=1),
        Text("Native Flask routing with Hedron components."),
        title="Home",
    )


@ui.component("/fragment", fragment_regions=(PANEL,))
def fragment():
    return InteractionResult(content=Text("Fragment ok"), explanation="demo")


def create_app() -> Flask:
    app = Flask(__name__)
    app.secret_key = "replace-in-production"
    hedron.init_app(app)
    app.register_blueprint(ui)
    return app

flask --app app:create_app run --reload

What this package includes

HedronFlask / init_app application integration
HedronBlueprint with @page / @view / @action style routing
component_response / interaction_response helpers
Fragment region authorization and approved HTMX header merging
Portable SecurityPolicy headers and Flask-Login AuthSignal bridge
Job status polling helpers (poll_status_response)

License

MIT. See the repository license.

Release files for hedron-flask 1.0.9

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-flask 1.0.9
File	Size	Uploaded
hedron_flask-1.0.9.tar.gz	27.1 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for hedron-flask 1.0.9
File	Interpreter	ABI	Platform	Reset
hedron_flask-1.0.9-py3-none-any.whl 28.4 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 55.5 kB

Release files / hedron_flask-1.0.9.tar.gz

Download URL	hedron_flask-1.0.9.tar.gz
Size	27.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`f35af9c7e2d4d713096b7866424342c92f79ef8f7c38a40fa0653af3efa40c14`
BLAKE2b-256 checksum How to use checksums	`33571b91cc7138644b8043c8d035b7bfec845615750b395a32cff1c2ae2258bd`
Upload date	Sep 4, 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_flask-1.0.9-py3-none-any.whl

Download URL	hedron_flask-1.0.9-py3-none-any.whl
Size	28.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`087c2cdbf48c2d5d31fd1d7719ff51d5399354196453e15a7128d5322c03e93d`
BLAKE2b-256 checksum How to use checksums	`8d1e08fe83f2b65d74560aa9f2843fe1ce6a297a2e12394d8c4ae6b05fa73f9e`
Upload date	Sep 4, 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}`