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. - Resource-bounded uploads — Fetch-shaped
FormData/Fileparsing has explicit body/part/header limits; native ASGI spills large files to disk while Workers remains bounded and disk-free. - 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
On ASGI, ASGIPathDispatcher can retain Django admin/ORM or existing FastAPI
endpoints under explicit prefixes while new routes use Hayate. Cloudflare
Workers continues to use Hayate's direct Fetch adapter with no ASGI detour.
See the runtime guide.
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.
- A dated, source-backed capability matrix separates Hayate's portable agent/API advantage from Django's full-stack advantage and Hono's JavaScript-edge advantage without inventing a universal score.
- 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
Metadata
1 maintainer
Release files for hayate 0.16.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| hayate-0.16.0.tar.gz | 67.1 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hayate-0.16.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 151.3 kB
Release files / hayate-0.16.0.tar.gz
| Download URL | hayate-0.16.0.tar.gz |
|---|---|
| Size | 67.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ef11cb670537d166beca5e9584074df37a3cc9f51751ae93d15c13df04a0ebfa
|
|
BLAKE2b-256 checksum How to use checksums |
d39e92037311cd3e9becf43d98851f9e9baf92eb8493d1e793066dff907e5810
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 3, 2026.
Transparency logRelease files / hayate-0.16.0-py3-none-any.whl
| Download URL | hayate-0.16.0-py3-none-any.whl |
|---|---|
| Size | 84.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
44061c9cdc2d0e5f0350b617a6413dc9eede1ed8314664bffe93d08823cbd527
|
|
BLAKE2b-256 checksum How to use checksums |
c0fd16c515e568e4ae2e978cf6e69400eb8c81b82933a8b4404a6129361f029c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 3, 2026.
Transparency logSecurity for hayate 0.16.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for hayate-0.16.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 3, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
