Skip to content

Installation

Jump to bottom
Herve Hildenbrand edited this page Apr 9, 2026 · 2 revisions

Installation

Prerequisites

  • Python 3.11+ - Required for running BGP Explorer
  • uv - Fast Python package manager
  • Anthropic API Key - Get one from Anthropic Console

Quick Install

From PyPI (recommended)

pip install bgp-explorer
bgp-explorer install-deps  # Auto-installs Go + Rust + monocle + bgp-radar

From source

git clone https://github.com/hervehildenbrand/bgp-explorer.git
cd bgp-explorer
uv sync
uv run bgp-explorer install-deps

The install-deps command automatically installs:

Dependency Purpose Auto-Installed?
Rust Required for monocle Yes (via rustup)
monocle AS relationship data from BGPKIT Yes (cargo install)
Go Required for bgp-radar Yes (to ~/.local/go)
bgp-radar Real-time BGP anomaly detection Yes (go install)

Binaries are auto-detected in ~/go/bin and ~/.cargo/bin.

Manual Installation (Alternative)

If you prefer to install dependencies manually:

# monocle (required - requires Rust)
cargo install monocle

# bgp-radar (optional - requires Go, for real-time monitoring)
go install github.com/hervehildenbrand/bgp-radar/cmd/bgp-radar@latest

Optional Dependencies

BGPStream Support

For historical BGP data from RouteViews and RIPE RIS archives:

# macOS - Install the C library first
brew install bgpstream

# Then install Python binding
uv sync --extra bgpstream

Note: BGPStream requires the libBGPStream C library to be installed on your system.

Verifying Installation

After installation, verify everything is working:

# Check Python dependencies
uv run python -c "import bgp_explorer; print('OK')"

# Check monocle (required)
monocle --version

# Check bgp-radar (optional)
bgp-radar --help

What Works Without bgp-radar

The app works without bgp-radar installed:

Feature Without bgp-radar With bgp-radar
Prefix lookups ✅ ✅
ASN queries ✅ ✅
RPKI validation ✅ ✅
Path analysis ✅ ✅
On-demand hijack detection ✅ ✅
Real-time monitoring ❌ ✅
get_anomalies tool ❌ ✅
/monitor commands ❌ ✅

Next Steps

Clone this wiki locally