A looking glass is implemented by network operators as a way of providing customers, peers, or the general public with a way to easily view elements of, or run tests from the provider's network.
hyperglass-ng is a maintained fork of thatmattlove/hyperglass. The upstream project has been quiet for an extended period, so this fork carries production-oriented fixes and dependency modernization that hadn't landed upstream as of v2.0.4.
The rename is branding and distribution only: the
hyperglassimport package, thehyperglassCLI command, theHYPERGLASS_environment prefix, and the/etc/hyperglassconfig layout are unchanged, so existing deployments upgrade in place. The distribution is published ashyperglass-ngon PyPI andghcr.io/jsenecal/hyperglass-ngon GHCR.Container images are published to GHCR on every push to
mainand on tag pushes:
Tag Updated by Use case ghcr.io/jsenecal/hyperglass-ng:2.1.1tag push immutable, recommended for production ghcr.io/jsenecal/hyperglass-ng:sha-<short>every build per-commit immutable ghcr.io/jsenecal/hyperglass-ng:mainevery push to mainrolling HEAD ghcr.io/jsenecal/hyperglass-ng:latestevery build rolling whatever's freshest Issues belong in the fork's tracker, not upstream's.
- #356 — Worker count is now cgroup- and affinity-aware (
os.process_cpu_count/sched_getaffinity), capped at 8 by default, and overridable via the newHYPERGLASS_WORKERSenv var. Stops containerized deployments on high-core hosts from OOM-killing themselves at startup. - #354 / #318 — Pass
request_timeoutto netmiko'ssend_command()so long-running commands like traceroute don't fail at the 10s default. - #341 / #348 — Pin
click<8.2so fresh Docker /pip install -e .installs don't pick up a click release that's incompatible withtyper 0.9.0and crash on startup. - #330 — Make the
Device.httpfield optional so the existing "platform: http but no http params" validator branch is actually reachable. - #334 — Targeted CVE patches: bump Next.js to 13.5.11, Pillow ≥10.4, httpx ≥0.27, h11 ≥0.16, base image to rolling
python:3.12-alpinewithapk upgrade, setuptools ≥78.1.1. - CI — Tag- and push-triggered multi-tag GHCR publish workflow (lifted from upstream's never-merged
docker-buildbranch).
hyperglass is intended to make implementing a looking glass too easy not to do, with the lofty goal of improving the internet community at large by making looking glasses more common across autonomous systems of any size.
- BGP Route, BGP Community, BGP AS Path, Ping, & Traceroute, or add your own commands.
- Full IPv6 support
- Customizable everything: features, theme, UI/API text, error messages, commands
- Built-in support for:
- Arista EOS
- BIRD
- Cisco IOS
- Cisco NX-OS
- Cisco IOS-XR
- FRRouting
- Huawei VRP
- Juniper Junos
- Mikrotik
- Nokia SR OS
- OpenBGPD
- TNSR
- VyOS
- Configurable support for any other supported platform
- Optionally access devices via an SSH proxy/jump server
- Access-list/prefix-list style query control to whitelist or blacklist query targets
- REST API with automatic, configurable OpenAPI documentation
- Modern, responsive UI built on ReactJS, with NextJS & Chakra UI, written in TypeScript
- Query multiple devices simultaneously
- Browser-based DNS-over-HTTPS resolution of FQDN queries
To request support for a specific platform, please submit a Github Issue with the feature label.
Any users, potential users, or contributors of hyperglass are welcome to join and discuss usage, feature requests, bugs, and other things.
hyperglass is developed with the express intention of being free to the networking community.
However, if you're feeling particularly helpful or generous, small donations are welcome.
hyperglass is built entirely on open-source software. Here are some of the awesome libraries used, check them out too!