hayate
Hayate ecosystem: Start here · Production golden app · Tested compatibility
A web-standards-first Python web framework, inspired by Hono.
hayate (疾風, "swift wind") brings the Fetch API model to Python. Everything you touch maps 1:1 to WHATWG / IETF web standards; Python-local protocols such as WSGI and ASGI are demoted to adapter-level implementation details.
- Standards-first —
Request/Response/Headers/URLfollow WHATWG Fetch and URL semantics. Routing syntax is the WHATWG URLPattern standard (/books/:id), not a custom DSL. - Minimal, portable core — one pure-Python Unicode standards dependency; runs anywhere CPython or Pyodide runs.
- Runtime-agnostic — the app core is a pure
fetch(Request) -> Responsefunction. ASGI servers, Cloudflare Python Workers, and AWS Lambda are thin adapters. - Async-first, typed — Python 3.12+.
Install
uv add hayate # or: pip install hayate
Quickstart
from hayate import Hayate, HTTPException
app = Hayate()
@app.get("/books/:id")
async def show_book(c):
book = BOOKS.get(c.req.param("id"))
if book is None:
raise HTTPException(404, title="Book not found")
return c.json(book)
Run with any ASGI server:
uvicorn main:app
Testing without a server
The app core performs no I/O, so tests call it directly — no test client, no sockets:
async def test_show_book():
res = await app.request("/books/1")
assert res.status == 200
assert (await res.json())["id"] == "1"
Runtime-bound CORS allowlists can inspect the request context:
from hayate.middleware import cors
app = Hayate(env={"CORS_ORIGINS": {"https://app.example.com"}})
def allowed_origin(c, request_origin):
return request_origin if request_origin in c.env["CORS_ORIGINS"] else None
app.use(cors(origin_resolver=allowed_origin, credentials=True))
Conformance and performance, measured
- Standards conformance runs against vendored web-platform-tests
vectors on every
pytestrun, with ratcheted pass counts — see docs/conformance.md. - A locked, end-to-end benchmark measures the same workload against FastAPI, Django, and Hono across startup, dependencies, deployment payload, cold start, throughput, and an HTTP contract. Framework-only ASGI overhead is also benchmarked against Starlette — see docs/benchmarks.md.
- Every core change is tested against the public auth, fetch, MCP, OpenAPI, and generated Workers heads using the exact unpublished wheel — see docs/ecosystem-compatibility.md.
Status
Alpha (0.12.x): the surface tracks DESIGN.md (Japanese) and may still move before 1.0. Changes are recorded in CHANGELOG.md; platform research lives in docs/research/.
The wider ecosystem adds authentication, MCP, OpenAPI, and a portable client-side fetch. See the hayatepy organization profile for the current compatibility matrix.
License
MIT
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 hayate-0.12.1.tar.gz.
File metadata
- Download URL: hayate-0.12.1.tar.gz
- Upload date:
- Size: 56.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1af3b317e86cf6093d519f3a80014a25a45d4dd87eeffc4901ac7fa4350ddebd
|
|
| MD5 |
8110e3d8dd08023260b1ceb70f467e8a
|
|
| BLAKE2b-256 |
6be2fa2d08573aab6944e8ea451ed01fc3d1d13f107aa9dd911c72b7b4a02040
|
Provenance
The following attestation bundles were made for hayate-0.12.1.tar.gz:
Publisher:
release.yml on hayatepy/hayate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hayate-0.12.1.tar.gz -
Subject digest:
1af3b317e86cf6093d519f3a80014a25a45d4dd87eeffc4901ac7fa4350ddebd - Sigstore transparency entry: 2256702449
- Sigstore integration time:
-
Permalink:
hayatepy/hayate@233496ff4b0544c0bf51639bab1f4f2a499cd0bc -
Branch / Tag:
refs/tags/v0.12.1 - Owner: https://github.com/hayatepy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@233496ff4b0544c0bf51639bab1f4f2a499cd0bc -
Trigger Event:
push
-
Statement type:
File details
Details for the file hayate-0.12.1-py3-none-any.whl.
File metadata
- Download URL: hayate-0.12.1-py3-none-any.whl
- Upload date:
- Size: 72.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de1bc9e8c75d64795f92d9483bbe35339dc3f1cec599a3787d48b4840461f063
|
|
| MD5 |
28bb446f27cedfd6511af0acce31739d
|
|
| BLAKE2b-256 |
4a390016de1092925aea035a3be4cc62a69e9d857d178b8c529c782b723a4420
|
Provenance
The following attestation bundles were made for hayate-0.12.1-py3-none-any.whl:
Publisher:
release.yml on hayatepy/hayate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
hayate-0.12.1-py3-none-any.whl -
Subject digest:
de1bc9e8c75d64795f92d9483bbe35339dc3f1cec599a3787d48b4840461f063 - Sigstore transparency entry: 2256702457
- Sigstore integration time:
-
Permalink:
hayatepy/hayate@233496ff4b0544c0bf51639bab1f4f2a499cd0bc -
Branch / Tag:
refs/tags/v0.12.1 - Owner: https://github.com/hayatepy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@233496ff4b0544c0bf51639bab1f4f2a499cd0bc -
Trigger Event:
push
-
Statement type:
