# Install hoverfly with Homebrew

API simulations for development and testing. Version 1.12.10 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:hoverfly
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install hoverfly
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:hoverfly
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/hoverfly>
- **Version:** 1.12.10
- **Source summary:** API simulations for development and testing
- **Homepage:** <https://hoverfly.io/>
- **Repository:** <https://github.com/SpectoLabs/hoverfly>
- **Upstream docs:** <https://docs.hoverfly.io/>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/SpectoLabs/hoverfly/archive/refs/tags/v1.12.10.tar.gz>
- **Last updated:** 2026-06-22T00:18:46Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- hoverfly (cli)
- hoverfly (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.12.10
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/SpectoLabs/hoverfly
- Upstream latest detected: v1.12.10 (current)
## Project history and usage

Hoverfly is an open source API simulation and service virtualization tool for development and testing. The project describes itself as a lightweight way to create realistic simulations of APIs that an application depends on.

### Project history

Hoverfly grew out of an effort to build the smallest service virtualization tool possible. Its documentation frames the project around the problem of testing applications that depend on external services, where network outages, latency, unavailable dependencies, and hard-to-manage test data make integration tests brittle.

The repository README and docs describe a Go-based proxy/server application controlled by `hoverctl`. Hoverfly can capture, export, import, edit, and replay simulations, and the project also exposes a REST API and language bindings, most prominently Java bindings.

### Adoption history

Hoverfly became useful in microservice testing because it sits at the architectural boundary rather than inside application code. The docs position it between intrusive mocks and hand-written stub services: a controllable dependency sandbox that can simulate slow, flaky, rate-limited, or unavailable APIs.

The project has been packaged as a Homebrew formula and has adjacent official repositories for Java bindings, a UI, and a GitHub Action. Those companion projects show adoption beyond a single binary: Hoverfly became a small tool family for service virtualization in local development and CI.

### How it is used

The documented getting-started flow installs two binaries, `hoverfly` and `hoverctl`. `hoverctl` starts, stops, and configures a Hoverfly daemon, while `hoverfly` provides the proxy or webserver and API endpoints that do the simulation work.

Typical usage is to replace unreliable or unavailable API dependencies with reusable simulations, then exercise application code over HTTP as if it were talking to the external service.

### Why package nerds care

Hoverfly matters to package nerds because it turns service virtualization into a portable CLI install rather than a heavy test environment. Its value is operational: developers can install one binary pair, put it in CI, and make network-dependent tests repeatable.

It also illustrates how Go CLIs entered the testing-tooling shelf: self-contained binaries, Homebrew packaging, release archives, and wrappers for language ecosystems that do not have to reimplement the proxy.

### Timeline

- Origin: Hoverfly documentation says the project grew from an effort to build the smallest service virtualization tool possible.
- v1.12.10: The hosted documentation identifies the Hoverfly and hoverctl two-binary model.
- v1.12.10: Homebrew builds the formula from the upstream SpectoLabs GitHub tag.

### Related projects

- hoverfly-java provides native Java bindings for using Hoverfly in JVM tests.
- hoverfly-ui is the Angular frontend application bundled with Hoverfly.
- hoverfly-github-action installs Hoverfly and hoverctl for GitHub Actions workflows.
- Traditional mocks and stub servers are the comparison points used in Hoverfly's own motivation documentation.

### Sources

- <https://formulae.brew.sh/formula/hoverfly>
- <https://github.com/SpectoLabs/hoverfly>
- <https://github.com/SpectoLabs/hoverfly-github-action>
- <https://github.com/SpectoLabs/hoverfly-java>
- <https://github.com/SpectoLabs/hoverfly-ui>
- <https://github.com/SpectoLabs/hoverfly/blob/master/docs/pages/introduction/gettingstarted.rst>
- <https://github.com/SpectoLabs/hoverfly/blob/master/docs/pages/introduction/motivation.rst>


## Security Notes

No matching local secret-handling manifest was found for hoverfly. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hoverfly
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [mockery](https://www.automicvault.com/pkg/brew/mockery/) - Shares av.db curated category or tags: cli, developer-tools, mocking, testing.
- [mockolo](https://www.automicvault.com/pkg/brew/mockolo/) - Shares av.db curated category or tags: cli, developer-tools, mocking, testing.
- [mockserver](https://www.automicvault.com/pkg/brew/mockserver/) - Shares av.db curated category or tags: cli, developer-tools, proxy, testing.
- [moto](https://www.automicvault.com/pkg/brew/moto/) - Shares av.db curated category or tags: cli, developer-tools, mocking, testing.
- [allure](https://www.automicvault.com/pkg/brew/allure/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [artillery](https://www.automicvault.com/pkg/brew/artillery/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [busted](https://www.automicvault.com/pkg/brew/busted/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [bzt](https://www.automicvault.com/pkg/brew/bzt/) - Shares av.db curated category or tags: cli, developer-tools, testing.

## Combined YAML source

View the package source record on GitHub. [combined/hoverfly.yml](https://github.com/automic-vault/db/blob/main/combined/hoverfly.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
