Skip to content

About

hyperglass is the network looking glass that tries to make the internet better.

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation



The network looking glass that tries to make the internet better.


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.

About this fork — hyperglass-ng

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 hyperglass import package, the hyperglass CLI command, the HYPERGLASS_ environment prefix, and the /etc/hyperglass config layout are unchanged, so existing deployments upgrade in place. The distribution is published as hyperglass-ng on PyPI and ghcr.io/jsenecal/hyperglass-ng on GHCR.

Container images are published to GHCR on every push to main and on tag pushes:

Tag Updated by Use case
ghcr.io/jsenecal/hyperglass-ng:2.1.1 tag push immutable, recommended for production
ghcr.io/jsenecal/hyperglass-ng:sha-<short> every build per-commit immutable
ghcr.io/jsenecal/hyperglass-ng:main every push to main rolling HEAD
ghcr.io/jsenecal/hyperglass-ng:latest every build rolling whatever's freshest

Issues belong in the fork's tracker, not upstream's.

Changes from upstream v2.0.4

  • #356 — Worker count is now cgroup- and affinity-aware (os.process_cpu_count / sched_getaffinity), capped at 8 by default, and overridable via the new HYPERGLASS_WORKERS env var. Stops containerized deployments on high-core hosts from OOM-killing themselves at startup.
  • #354 / #318 — Pass request_timeout to netmiko's send_command() so long-running commands like traceroute don't fail at the 10s default.
  • #341 / #348 — Pin click<8.2 so fresh Docker / pip install -e . installs don't pick up a click release that's incompatible with typer 0.9.0 and crash on startup.
  • #330 — Make the Device.http field 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-alpine with apk upgrade, setuptools ≥78.1.1.
  • CI — Tag- and push-triggered multi-tag GHCR publish workflow (lifted from upstream's never-merged docker-build branch).

Documentation   |   Live Demo

Frontend Tests Backend Tests


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.

Features

  • 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.

Community

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.

Donate

Acknowledgements

hyperglass is built entirely on open-source software. Here are some of the awesome libraries used, check them out too!

GitHub

About

hyperglass is the network looking glass that tries to make the internet better.

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages