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 · Train: 0.25.x (last published 0.25.1; workspace 0.25.2 candidate) · pin >=0.25.0,<0.26

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

Install

pip install "hedron-flask>=0.25.0,<0.26"
# or
uv add "hedron-flask>=0.25.0,<0.26"

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

Scaffold a new Flask app:

uvx --from "hedron>=0.25.0,<0.26" 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 / @component / @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)

Links

• Add to an existing Flask app
• Adapters API
• Changelog
• Source
• Issues
• Flask reference example
• hedron-core · hedron · hedron-django

License

MIT. See LICENSE.