# Install hz with Homebrew Golang HTTP framework for microservices. Version 0.9.7 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:hz ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hz ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:hz - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.9.7 - **Source summary:** Golang HTTP framework for microservices - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-15T10:20:18-04:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - hz (cli) - protoc-gen-hertz (cli) - thrift-gen-hertz (cli) - hz (alias) - protoc-gen-hertz (alias) - thrift-gen-hertz (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.9.7 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://github.com/cloudwego/hertz - Upstream latest detected: cmd/hz/v0.9.7 (current) ## Project history and usage hz is the command-line generator distributed with CloudWeGo Hertz, ByteDance's Go HTTP framework for microservices. In package-manager form it installs the hz executable and its protocol compiler plugins, making Hertz scaffolding available as a standalone developer tool. ### Project history Hertz began inside ByteDance as a high-performance HTTP framework shaped by internal microservice requirements. CloudWeGo's README says Hertz was originally forked from fasthttp, inspired by Gin and Echo, and paired with ByteDance's Netpoll network library. CloudWeGo announced Hertz as an open source project on June 21, 2022, after more than a year of internal use. The same announcement describes hz as the one-click command-line tool that generates project scaffolding from interface definition files. The Homebrew formula packages the command-line side of the project from the cloudwego/hertz repository, installing hz along with protoc-gen-hertz and thrift-gen-hertz. ### Adoption history Before public release, Hertz had already become a large internal ByteDance HTTP framework, with CloudWeGo reporting more than 10,000 online services and peak traffic above 40 million QPS. Public adoption grew around the CloudWeGo ecosystem, where Hertz, Kitex, Netpoll, examples, and hertz-contrib extensions form a Go microservice toolkit. For package managers, hz is the convenient entry point: developers can install the generator without manually building the Hertz repository, then generate or update service scaffolding from Thrift or Protobuf IDL. ### How it is used hz is used to create and maintain Hertz projects from service definitions. The CloudWeGo announcement says it supports Thrift and Protobuf, depends on the official Protobuf compiler and Thriftgo, and can update generated scaffolding after IDL changes. The surrounding Hertz framework targets high-usability, high-performance, extensible HTTP services with middleware, streaming, protocol support, observability hooks, and optional Netpoll or Go net transport behavior. ### Why package nerds care hz is package-nerd significant because it packages a generator rather than only a runtime library. It gives Homebrew users the same style of one-command workflow familiar from protoc plugins, thrift generators, and framework CLIs, while leaving application code in normal Go modules. It also represents a common packaging pattern for large Go frameworks: the repository contains libraries, examples, generated-code support, and release tags, but package managers expose the small set of executables developers actually need on PATH. ### Timeline - 2021: Hertz launched internally at ByteDance according to CloudWeGo's open source announcement. - 2022-05: The cloudwego/hertz GitHub repository was created. - 2022-06: CloudWeGo announced Hertz as an open source project and described hz as the Hertz code-generation command. - 2025: Homebrew tracked the cmd/hz v0.9.x tag series for the standalone hz formula. - 2026: Hertz releases continued on the v0.10.x line. ### Related projects - Related CloudWeGo projects include Netpoll, Kitex, Hertz examples, hertz-benchmark, and hertz-contrib. The README also names fasthttp, Gin, and Echo as important influences. ### Sources - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hz - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [protoc-gen-go-grpc](https://www.automicvault.com/pkg/brew/protoc-gen-go-grpc/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go, protobuf. - [counterfeiter](https://www.automicvault.com/pkg/brew/counterfeiter/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go. - [gf](https://www.automicvault.com/pkg/brew/gf/) - Shares av.db curated category or tags: cli, developer-tools, go, microservices, web-framework. - [go-bindata](https://www.automicvault.com/pkg/brew/go-bindata/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go. - [goctl](https://www.automicvault.com/pkg/brew/goctl/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go. - [gomodifytags](https://www.automicvault.com/pkg/brew/gomodifytags/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go. - [gowsdl](https://www.automicvault.com/pkg/brew/gowsdl/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go. - [ifacemaker](https://www.automicvault.com/pkg/brew/ifacemaker/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, go. - [kitex](https://www.automicvault.com/pkg/brew/kitex/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, code, code-generation, developer, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/hz.yml](https://github.com/automic-vault/db/blob/main/combined/hz.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph