# cloudwego/hertz

Go HTTP framework with high-performance and strong-extensibility for building micro-services.

Repository: https://github.com/cloudwego/hertz
Canonical: https://ross.abutalabs.com/products/hertz
Homepage: https://www.cloudwego.io
Language: Go
License: Apache-2.0
License Family: permissive
Topics: go, http, microservices
Last push: 2026-08-26T09:11:29+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 84, longevity 100
- inputs: {"age_days": 1574, "days_push": 7, "days_rel": 27, "gap_med": 49.5, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7347, forks 639 (observed 2026-08-28T04:09:58.374853+00:00)

## What it is
Hertz is a high-performance, extensible Go HTTP framework from CloudWeGo (ByteDance) for building microservices. It uses the Netpoll network library by default, supports HTTP/1.1, HTTP/2, ALPN and WebSocket, and offers a layered design with extensive extension points and an hz code generation tool.

## Use cases
- build high-performance microservices in go
- serve http apis with low latency and high qps
- replace gin or echo with a faster go http framework
- generate go http service scaffolding from idl
- build websocket and http/2 services in go
- customize framework layers like transport or protocol

## When to choose
- you need maximum http throughput and low latency in go
- you are building microservices within the cloudwego ecosystem (kitex, netpoll)
- you need a layered, highly extensible http framework
- you want built-in code generation from thrift or protobuf idl

## When to avoid
- you need a minimal framework with the largest plugin ecosystem (gin, echo)
- you are not writing go
- your service is simple and performance is not a concern
- you rely on net/http middleware compatibility without adapters

## Facets
- artifact type: framework
- maturity: active
- function: web-framework, http-server, routing, middleware, websocket
- domain: web-development, backend, microservices, apis, developer-tools
- platform: go, windows, cross-platform
- tags: http-framework, netpoll, microservices, high-performance, cloudwego, code-generation, linux, macos

## Member repositories
- cloudwego/hertz (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:58.374853+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:38:26.861413+00:00, confidence not recorded.
  - readme: https://github.com/cloudwego/hertz (fetched 2026-08-28T04:09:58.374853+00:00, sha 41bbff69cbb3)
  - homepage: https://www.cloudwego.io (fetched 2026-08-29T08:33:52.059950+00:00, sha 83921f721f0e)
  - site_page: https://www.cloudwego.io/docs/kitex (fetched 2026-08-29T08:33:52.068844+00:00, sha 06162c2c2a44)
  - site_page: https://www.cloudwego.io/docs/hertz (fetched 2026-08-29T08:33:52.070515+00:00, sha 9bf07ea1d5c8)
  - site_page: https://www.cloudwego.io/docs/volo (fetched 2026-08-29T08:33:52.072027+00:00, sha 98a27d767af2)
  - site_page: https://www.cloudwego.io/docs/eino (fetched 2026-08-29T08:33:52.073683+00:00, sha 34d92c501d05)
  - site_page: https://www.cloudwego.io/about (fetched 2026-08-29T08:33:52.075355+00:00, sha 3dd7258a47b2)
  - site_page: https://www.cloudwego.io/docs (fetched 2026-08-29T08:33:52.077192+00:00, sha cd3f3e5f90ed)
- Data as of 2026-08-30T08:39:29.467469+00:00.