# bojand/ghz

Simple gRPC benchmarking and load testing tool

Repository: https://github.com/bojand/ghz
Canonical: https://ross.abutalabs.com/products/ghz
Homepage: https://ghz.sh
Language: Go
License: Apache-2.0
License Family: permissive
Topics: grpc, hacktoberfest
Last push: 2026-08-01T03:42:55+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 95, release rhythm 28, longevity 100
- inputs: {"age_days": 3095, "days_push": 32, "days_rel": 270, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3348, forks 284 (observed 2026-08-28T04:07:57.706979+00:00)

## What it is
ghz is a command-line utility and Go package for benchmarking and load testing gRPC services. It supports unary, streaming, and duplex calls via proto files, protosets, or server reflection, and outputs reports in CLI, CSV, JSON, HTML, and InfluxData formats.

## Use cases
- load test a grpc service
- benchmark grpc api performance
- run grpc performance regression tests in ci
- stress test grpc streaming endpoints
- measure grpc call latency and throughput
- track grpc benchmark results over time

## When to choose
- you need to benchmark or load test gRPC services from the command line
- you want performance regression testing of gRPC in CI pipelines
- you need to test unary, client/server streaming, or bidirectional streaming calls
- you want programmatic gRPC load testing via a Go library

## When to avoid
- you need to load test REST or HTTP APIs rather than gRPC
- you need a GUI-driven load testing tool
- your services do not use protocol buffers or gRPC

## Facets
- artifact type: cli-tool
- maturity: active
- function: benchmarking, load-testing, testing, cli
- domain: developer-tools, testing, performance, apis
- platform: windows, go, cli, cross-platform
- tags: grpc, load-testing, performance-regression, reporting, command-line, linux, macos, docker

## Member repositories
- bojand/ghz (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:57.706979+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-29T18:40:59.389681+00:00, confidence not recorded.
  - readme: https://github.com/bojand/ghz (fetched 2026-08-28T04:07:57.706979+00:00, sha 156df93fabd2)
  - homepage: https://ghz.sh (fetched 2026-08-29T09:34:08.763437+00:00, sha 4c306c284d68)
  - site_page: https://ghz.sh/docs/intro (fetched 2026-08-29T09:34:08.765751+00:00, sha b7f6595d2d39)
  - site_page: https://ghz.sh/docs/web/intro (fetched 2026-08-29T09:34:08.767442+00:00, sha 490a788c1cfb)
  - site_page: https://ghz.sh/docs/intro.html (fetched 2026-08-29T09:34:08.769039+00:00, sha b7f6595d2d39)
- Data as of 2026-08-30T08:39:29.467469+00:00.