danielgtaylor/huma

Health v2 · maintenance only

Adoption not part of the score

4347 stars · 281 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Huma is a modern micro-framework for building HTTP REST/RPC APIs in Go, backed by OpenAPI 3.1 and JSON Schema. It is router-agnostic (bring your own router), generates always-up-to-date OpenAPI specs and interactive docs from code, and includes declarative validation, RFC 9457 errors, and a built-in service CLI.

Use cases

• build a REST API in Go with automatic OpenAPI 3.1 documentation
• add OpenAPI docs to an existing Go service without rewriting routes
• generate always up-to-date API specs from Go code
• use chi, gin, echo, fiber, or gorilla/mux with a declarative API layer
• serve interactive API docs like Stoplight Elements or Swagger UI
• add request validation and RFC 9457 JSON errors to a Go HTTP API
• wrap a Go service with a CLI for flags, env vars, and graceful shutdown

When to choose

• you want code-first OpenAPI 3.1 generation that can't drift from your implementation
• you need incremental adoption on top of an existing Go router and middleware
• you want static typing, automatic input validation, and guard rails for your API handlers
• you need generated developer tooling and interactive docs out of the box

When to avoid

• you need a design-first workflow where the spec is authored before code
• you want a batteries-included framework with its own router, ORM, and auth
• you're building non-HTTP services or non-REST protocols
• your project must run on Go versions older than the required minimum

Facets

framework · maturity active

api-framework web-framework http-server api-documentation middleware routing cli backend web-development apis developer-tools documentation go windows cross-platform openapi-3-1 json-schema rest-api bring-your-own-router code-first swagger-ui rfc9457 content-negotiation linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="danielgtaylor/huma")