🌎中文文档
🇯🇵日本語ドキュメント
A modern, simple, fast & flexible micro framework for building HTTP REST/RPC APIs in Go backed by OpenAPI 3 and JSON Schema. Pronounced IPA: /'hjuːmɑ/. The goals of this project are to provide:
- Incremental adoption for teams with existing services
- Bring your own router (including Go 1.22+), middleware, and logging/metrics
- Extensible OpenAPI & JSON Schema layer to document existing routes
- A modern REST or HTTP RPC API backend framework for Go developers
- Guard rails to prevent common mistakes
- Documentation that can't get out of date
- High-quality generated developer tooling
Features include:
- Declarative interface on top of your router of choice:
- Operation & model documentation
- Request params (path, query, header, or cookie)
- Request body
- Responses (including errors)
- Response headers
- JSON Errors using RFC9457 and
application/problem+json by default (but can be changed)
- Per-operation request size limits with sane defaults
- Content negotiation between server and client
- Support for JSON (RFC 8259) and optionally CBOR (RFC 7049) content types via the
Accept header with the default config.
- Conditional requests support, e.g.
If-Match or If-Unmodified-Since header utilities.
- Optional automatic generation of
PATCH operations that support:
- Annotated Go types for input and output models
- Generates JSON Schema from Go types
- Static typing for path/query/header params, bodies, response headers, etc.
- Automatic input model validation & error handling
- Documentation generation using Stoplight Elements
- Optional CLI built-in, configured via arguments or environment variables
- Set via e.g.
-p 8000, --port=8000, or SERVICE_PORT=8000
- Startup actions & graceful shutdown built-in
- Generates OpenAPI for access to a rich ecosystem of tools
This project was inspired by FastAPI. Logo & branding designed by Kari Taylor.
Sponsors
A big thank you to our current & former sponsors!
Testimonials
This is by far my favorite web framework for Go. It is inspired by FastAPI, which is also amazing, and conforms to many RFCs for common web things ... I really like the feature set, the fact that it [can use] Chi, and the fact that it is still somehow relatively simple to use. I've tried other frameworks and they do not spark joy for me. - Jeb_Jenky
After working with #Golang for over a year, I stumbled upon Huma, the #FastAPI-inspired web framework. It’s the Christmas miracle I’ve been hoping for! This framework has everything! - Hana Mohan
I love Huma. Thank you, sincerely, for this awesome package. I’ve been using it for some time now and it’s been great! - plscott
Thank you Daniel for Huma. Superbly useful project and saves us a lot of time and hassle thanks to the OpenAPI gen — similar to FastAPI in Python. - WolvesOfAllStreets
Huma is wonderful, I've started working with it recently, and it's a pleasure, so thank you very much for your efforts 🙏 - callmemicah
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
