pyhyys
pyhyys is an open-source Python library for building and validating hypermedia-driven REST APIs. The project provides a concise API to model resources, their relationships, and state transitions, while using YAML as a configuration format to describe routes, links, and forms. The design centers on promoting HATEOAS compliance and discoverability in API responses.
The project originated as a small experiment by a group of developers seeking to reduce boilerplate in
- Resource modeling with typed resources and relationships
- Automatic link generation and templating
- Hypermedia controls including forms and actions
- YAML-based configuration for routes, resources, and media types
- Serialization support for HAL, Siren, and custom media formats
- Validation and schema generation for request and response payloads
- Pluggable adapters for frameworks (Flask, FastAPI) and data backends (ORMs, in-memory)
- Extensible plugin system for custom media types and behaviors
pyhyys comprises a core runtime that defines Resource, Link, and Form abstractions, a serialization layer, a
Developers create resource models, write corresponding YAML configurations, register framework adapters, and expose endpoints that return
While not as widely adopted as general-purpose web frameworks, pyhyys has a niche following in educational