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, …),
and a thin Hedron() application facade.
Install
pip install hedron
# or
uv add hedron
Development Explorer preview:
pip install "hedron[dev]"
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 --app myapp:app routes
hedron --app myapp:app components
hedron --app myapp:app preview home
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.3.0.tar.gz.
File metadata
- Download URL: hedron-0.3.0.tar.gz
- Upload date:
- Size: 47.8 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 |
a7003033a8174fe09c68ed95a31be5e536254c7ac756642f91bb68999f9ea8b2
|
|
| MD5 |
7051a00962e4bd732813003e1a2f3af0
|
|
| BLAKE2b-256 |
d1d80d8f239319cbede25e7e52544f367c565011bd6c9ed55efb88b9a398c739
|
File details
Details for the file hedron-0.3.0-py3-none-any.whl.
File metadata
- Download URL: hedron-0.3.0-py3-none-any.whl
- Upload date:
- Size: 56.4 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 |
98b718f198cb7ffbca176a986178daeebb8f165ec0de49039545cd45e058b719
|
|
| MD5 |
5feda67fa7a41033c0286c6091645c4d
|
|
| BLAKE2b-256 |
179026c5fb266317fc7097d85f7b37f06a8f8c8e51affda8bda8472f844679b6
|
