hedron
FastAPI-native typed component framework for HTML and HTMX.
Builds on framework-neutral hedron-core
with pages, addressable components, typed actions, CSRF-aware forms, OpenAPI
text/html metadata, interaction built-ins (Lazy, Poll, Pagination, …),
caching (cache_data / cache_component), utility UI, ColorMode persistence,
a thin Hedron() application facade, CLI (new/check/graph/build/…),
plugin loader, and public hedron.testing helpers.
Install
pip install hedron
# or
uv add hedron
Development Explorer:
pip install "hedron[dev]"
Optional browser testing extras:
pip install "hedron[browser]"
Requires Python 3.11, 3.12, 3.13, or 3.14.
Quick start
from hedron import Hedron, Page, Text
app = Hedron(
title="Demo",
security="standard",
session_secret="replace-me",
explorer="off",
)
@app.page("/")
def home() -> Page:
return Page(Text("Hello, Hedron"), title="Demo")
Plain FastAPI without the Hedron subclass:
from fastapi import FastAPI
from hedron import HTML, HedronRouter, Text, hedron_response, mount_hedron_static
from hedron.security.policy import SecurityPolicy
app = FastAPI()
app.state.hedron_security = SecurityPolicy.from_name("standard")
mount_hedron_static(app)
router = HedronRouter()
@router.get("/card", **hedron_response())
def card():
return HTML(Text("plain"))
app.include_router(router)
CLI inspection (optionally load an app module first):
hedron new demoapp
cd demoapp
hedron --app app:app routes
hedron --app app:app components
hedron --app app:app preview home
hedron check --format json --severity error
hedron graph
hedron audit-components
Links
License
MIT. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hedron-0.5.0.tar.gz.
File metadata
- Download URL: hedron-0.5.0.tar.gz
- Upload date:
- Size: 60.6 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
709e1aaac710ae0a993de4c3bcc09c5412e810bc25109405b2de8f4a0df5c36c
|
|
| MD5 |
ec1d77e5a4606c065875a0295e6e5a4a
|
|
| BLAKE2b-256 |
b59b0faebd9856d4111b167df2ee2d065fd917b2a018e06d8251e6acb31af49d
|
File details
Details for the file hedron-0.5.0-py3-none-any.whl.
File metadata
- Download URL: hedron-0.5.0-py3-none-any.whl
- Upload date:
- Size: 71.5 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
95048bccca74acaa995f3f87858230e11e78482aad6dc441a61db55319ccdaf3
|
|
| MD5 |
7d7e76acc40cee420b1fea110c35d194
|
|
| BLAKE2b-256 |
877d3b4b3e8e98070ca542b9b61ee3d09e39bdbe6f385597ac29271f1db98326
|
