# Install bgpstream with Homebrew

For live and historical BGP data analysis. Version 2.3.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:bgpstream
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bgpstream
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:bgpstream
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bgpstream>
- **Version:** 2.3.0
- **Source summary:** For live and historical BGP data analysis
- **Homepage:** <https://bgpstream.caida.org/>
- **Repository:** <https://github.com/CAIDA/libbgpstream>
- **Upstream docs:** <https://bgpstream.caida.org/docs>
- **License:** BSD-2-Clause
- **Source archive:** <https://github.com/CAIDA/libbgpstream/releases/download/v2.3.0/libbgpstream-2.3.0.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- bgpreader (cli)
- parsebgp (cli)
- bgpreader (alias)
- parsebgp (alias)

## Dependencies

- librdkafka
- wandio

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.3.0
- Local data: ok
- Upstream repository: https://github.com/CAIDA/libbgpstream
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

BGPStream is CAIDA's open-source framework for live and historical BGP measurement-data analysis. The Homebrew package exposes the libBGPStream/BGPReader toolchain used to inspect BGP data streams from research and operational datasets.

### Project history

CAIDA describes BGPStream as an open-source software framework for live and historical BGP data analysis, supporting scientific research, operational monitoring, and post-event analysis. Its architecture is split into data-access, record extraction and packaging, and record-processing layers, with libBGPStream as the core library.

The upstream changelog records version 1.0.0 as the initial public release on 2015-10-26, followed by version 1.1.0 on 2016-01-28 with native community support, proof-of-concept filters for peers/prefixes/communities, broker resilience, utility structures including a patricia tree, and BGPCorsaro AS-monitor work. GitHub tags show the 2.x line reaching v2.0.0 in 2020 and v2.3.0 in 2024.

### Adoption history

BGPStream's adoption is research-infrastructure flavored: CAIDA hosts the documentation, data-provider information, publications, APIs, tutorials, and download surface, while the GitHub repository provides the source and accepts pull requests. The package-manager footprint in this input is Homebrew-only, but upstream documents Ubuntu/Debian, FreeBSD, macOS, CentOS, Arch Linux, and generic Unix installation paths.

### How it is used

Users can consume BGP data through the bgpreader CLI, libBGPStream C/C++ API, PyBGPStream bindings, and metadata/data-access components. Typical uses include replaying historical routing data over a time window, monitoring real-time data, developing Python analyses, or building high-performance C/C++ routing-data pipelines.

### Why package nerds care

BGPStream is important to package nerds because it turns Internet-scale routing telemetry into a locally installable library and CLI instead of a pile of collector-specific dump-fetch scripts. Packaging it makes serious BGP forensics possible from a laptop or lab machine: install the formula, run bgpreader or link libBGPStream, and query RouteViews/RIS-style measurement data through a consistent API.

For network operators and researchers, the package is also a reproducibility tool. Historical BGP incidents, hijack investigations, outage postmortems, and measurement papers need exact time-window replay and consistent parsing; BGPStream provides the common substrate for that work.

### Timeline

- 2014: The libBGPStream repository history begins.
- 2015: Version 1.0.0 is recorded as the initial public release.
- 2016: Version 1.1.0 adds native community support and early peer/prefix/community filters.
- 2020: The v2.0.0 tag lands in the GitHub repository.
- 2024: The v2.3.0 tag is recorded in the GitHub repository.

### Related projects

- The framework includes libBGPStream, BGPReader, PyBGPStream, the broker/metadata API, and integrations around libparsebgp and BGPCorsaro. Its data-access role connects it to public BGP measurement infrastructures such as RouteViews and RIPE RIS through CAIDA's supported data-provider interfaces.

### Sources

- <https://api.github.com/repos/CAIDA/libbgpstream>
- <https://bgpstream.caida.org/>
- <https://bgpstream.caida.org/docs>
- <https://bgpstream.caida.org/docs/api/libbgpstream>
- <https://bgpstream.caida.org/docs/install/bgpstream>
- <https://raw.githubusercontent.com/CAIDA/libbgpstream/master/ChangeLog>


## 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:** bgpstream
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** 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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [wandio](https://www.automicvault.com/pkg/brew/wandio/) - Runtime dependency declared by Homebrew.
- [bgpdump](https://www.automicvault.com/pkg/brew/bgpdump/) - Shares av.db curated category or tags: bgp, cli, networking.
- [bgpq3](https://www.automicvault.com/pkg/brew/bgpq3/) - Shares av.db curated category or tags: bgp, cli, networking.
- [bgpq4](https://www.automicvault.com/pkg/brew/bgpq4/) - Shares av.db curated category or tags: bgp, cli, networking.
- [dnsviz](https://www.automicvault.com/pkg/brew/dnsviz/) - Shares av.db curated category or tags: analysis, cli, networking.
- [monocle](https://www.automicvault.com/pkg/brew/monocle/) - Shares av.db curated category or tags: bgp, cli, networking.
- [rpki-client](https://www.automicvault.com/pkg/brew/rpki-client/) - Shares av.db curated category or tags: bgp, cli, networking.
- [zebra](https://www.automicvault.com/pkg/brew/zebra/) - Shares av.db curated category or tags: bgp, cli, networking.
- [activemq](https://www.automicvault.com/pkg/brew/activemq/) - Shares av.db curated category or tags: cli, networking.
- [libtrace](https://www.automicvault.com/pkg/brew/libtrace/) - Local package facts share a topical domain. Shared terms: analysis, cli, networking, wandio.

## Combined YAML source

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