**hyperglass** is a modern network looking glass application. A looking glass is typically implemented by network service providers as a way of providing customers, peers, and partners with a way to easily view elements of, or run tests from the provider's network.
[**Documentation**](https://hyperglass.readthedocs.io)   |   [**Screenshots**](https://hyperglass.readthedocs.io/en/latest/screenshots/)   |   [**Live Demo**](https://hyperglass.allroads.io/) [![Build Status](https://travis-ci.org/checktheroads/hyperglass.svg?branch=master)](https://travis-ci.org/checktheroads/hyperglass) ![GitHub issues](https://img.shields.io/github/issues/checktheroads/hyperglass.svg) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)

**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 - Full frontend and backend IPv6 support - [Netmiko](https://github.com/ktbyers/netmiko)-based connection handling for traditional network devices - [FRRouting](https://frrouting.org/) support via [hyperglass-frr](https://github.com/checktheroads/hyperglass-frr) REST API - [BIRD](https://bird.network.cz/) support via [hyperglass-bird](https://github.com/checktheroads/hyperglass-bird) REST API - Customizable commands for each query type by vendor - Clean, modern, google-esq GUI based on the [Bumla](https://bulma.io) framework - Customizable colors, logo, web fonts, error messages, UI text - Simple TOML config file for all customizable parameters (no databases!) - Optional SSH Proxy to further direct secure router access - Configurable IP/Prefix "blacklist" to prevent lookup of sensitive prefixes - Configurable rate limiting, powered by [Flask-Limiter](https://github.com/alisaifee/flask-limiter) - Query response caching with configurable cache timeout - [Prometheus](https://prometheus.io/) metrics for query statistics tracking ## Platform Support hyperglass is preconfigured to support the following platforms: - **Cisco IOS-XR**: Netmiko `cisco_xr` vendor class - **Cisco Classic IOS/IOS-XE**: Netmiko `cisco_ios` vendor class - **Juniper JunOS**: Netmiko `junos` vendor class - **FRRouting**: [`hyperglass-frr`](https://github.com/checktheroads/hyperglass-frr) API - **BIRD**: [`hyperglass-bird`](https://github.com/checktheroads/hyperglass-bird) API Theoretically, any vendor supported by Netmiko can be supported by hyperglass. To request support for a specifc platform, please [submit a Github Issue](https://github.com/checktheroads/hyperglass/issues/new) with the **enhancement** label. ## Coming Soon - [GoBGP](https://github.com/osrg/gobgp) Support ## Community For now, hyperglass news will be made available via Twitter: - [@checktheroads](https://twitter.com/checktheroads) **hyperglass is developed with the express intention of being free to the networking community**. *However, the hyperglass demo does cost [/checktheroads](https://github.com/checktheroads) about $15/month for 3 Digital Ocean droplets. If you're feeling particularly helpful and want to help offset that cost, small donations are welcome.* [![Donate](https://img.shields.io/badge/Donate-blue.svg?logo=paypal)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=ZQFH3BB2B5M3E&source=url) ## Acknowledgements - This project originally started as a fork of [vraulsan](https://github.com/vraulsan)'s [looking-glass](https://github.com/vraulsan/looking-glass) project. The guts of the Flask components still remain from that project, but almost everything else has been rewritten. Nevertheless, the inspiration for building hyperglass came from here. ## License [Clear BSD License](https://github.com/checktheroads/hyperglass/master/LICENSE)