{"id":13510789,"url":"https://github.com/netenglabs/suzieq","last_synced_at":"2025-12-14T16:03:05.335Z","repository":{"id":37022012,"uuid":"232338630","full_name":"netenglabs/suzieq","owner":"netenglabs","description":"Using network observability to operate and design healthier networks","archived":false,"fork":false,"pushed_at":"2025-05-30T12:39:05.000Z","size":150959,"stargazers_count":830,"open_issues_count":131,"forks_count":114,"subscribers_count":33,"default_branch":"develop","last_synced_at":"2025-08-23T05:42:02.085Z","etag":null,"topics":["data-center","datacenter","infrastructure","network-analysis","network-monitoring","network-validation","networking","python"],"latest_commit_sha":null,"homepage":"https://www.stardustsystems.net/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netenglabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-01-07T14:11:09.000Z","updated_at":"2025-08-16T14:03:47.000Z","dependencies_parsed_at":"2023-02-17T21:45:23.553Z","dependency_job_id":"891ecf47-1233-4d91-89f4-017776a1f1f5","html_url":"https://github.com/netenglabs/suzieq","commit_stats":null,"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"purl":"pkg:github/netenglabs/suzieq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netenglabs%2Fsuzieq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netenglabs%2Fsuzieq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netenglabs%2Fsuzieq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netenglabs%2Fsuzieq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netenglabs","download_url":"https://codeload.github.com/netenglabs/suzieq/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netenglabs%2Fsuzieq/sbom","scorecard":{"id":680700,"data":{"date":"2025-08-11","repo":{"name":"github.com/netenglabs/suzieq","commit":"584b22abb1d66f8cb50da76f35f0522b1607bff7"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.5,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Warn: no topLevel permission defined: .github/workflows/integration-tests.yml:1","Warn: no topLevel permission defined: .github/workflows/pre-commit.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.22.0 not signed: https://api.github.com/repos/netenglabs/suzieq/releases/136508238","Warn: release artifact v0.22.0 does not have provenance: https://api.github.com/repos/netenglabs/suzieq/releases/136508238"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'develop'","Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":7,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/codeql-analysis.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/codeql-analysis.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/codeql-analysis.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:66: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/codeql-analysis.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:72: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:75: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:48: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/integration-tests.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/integration-tests.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pre-commit.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/pre-commit.yml/develop?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pre-commit.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/netenglabs/suzieq/pre-commit.yml/develop?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:3","Warn: containerImage not pinned by hash: Dockerfile-demo:1: pin your Docker image by updating netenglabs/suzieq:latest to netenglabs/suzieq:latest@sha256:6e4e955ae0ca214af975d0278e16f7d4e193685369fdefb92c563a60fc3d5472","Warn: containerImage not pinned by hash: Dockerfile-sqbase:1","Warn: pipCommand not pinned by hash: Dockerfile:11","Warn: pipCommand not pinned by hash: Dockerfile:21-22","Warn: pipCommand not pinned by hash: Dockerfile-sqbase:8-13","Warn: pipCommand not pinned by hash: Dockerfile-sqbase:8-13","Warn: pipCommand not pinned by hash: .github/workflows/pre-commit.yml:36","Info:   0 out of  13 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned","Info:   0 out of   5 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":0,"reason":"54 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-8495-4g3g-x7pr","Warn: Project is vulnerable to: GHSA-9548-qrrj-x5pj","Warn: Project is vulnerable to: PYSEC-2024-230 / GHSA-248v-346w-9cwc","Warn: Project is vulnerable to: PYSEC-2023-135 / GHSA-xqr8-7jwr-rhp7","Warn: Project is vulnerable to: GHSA-3ww4-gg4f-jr7f","Warn: Project is vulnerable to: PYSEC-2024-225 / GHSA-6vqw-3v5j-54x4","Warn: Project is vulnerable to: GHSA-9v9h-cgj8-h64p","Warn: Project is vulnerable to: GHSA-h4gh-qq45-vh27","Warn: Project is vulnerable to: PYSEC-2023-254 / GHSA-jfhm-5ghh-2f97","Warn: Project is vulnerable to: GHSA-jm77-qphf-c4w8","Warn: Project is vulnerable to: GHSA-v8gr-m533-ghj9","Warn: Project is vulnerable to: GHSA-3rq5-2g8h-59hc","Warn: Project is vulnerable to: PYSEC-2024-38","Warn: Project is vulnerable to: GHSA-6673-4983-2vx5","Warn: Project is vulnerable to: PYSEC-2024-4 / GHSA-2mqj-m65w-jghx","Warn: Project is vulnerable to: PYSEC-2023-165 / GHSA-cwvm-v4w8-q58c","Warn: Project is vulnerable to: PYSEC-2023-161 / GHSA-wfm5-v35h-vwf4","Warn: Project is vulnerable to: GHSA-vqfr-h8mv-ghfj","Warn: Project is vulnerable to: PYSEC-2024-60 / GHSA-jjg7-2v4v-x38h","Warn: Project is vulnerable to: GHSA-cpwx-vrp4-4pq7","Warn: Project is vulnerable to: GHSA-gmj6-6f8f-6699","Warn: Project is vulnerable to: GHSA-h5c8-rqwp-cp95","Warn: Project is vulnerable to: GHSA-h75v-3vvj-5mfj","Warn: Project is vulnerable to: GHSA-q2x7-8rv6-6q7h","Warn: Project is vulnerable to: GHSA-33p9-3p43-82vq","Warn: Project is vulnerable to: GHSA-6p56-wp2h-9hxr","Warn: Project is vulnerable to: GHSA-fpfv-jqm9-f5jm","Warn: Project is vulnerable to: GHSA-3f63-hfp8-52jq","Warn: Project is vulnerable to: GHSA-44wm-f244-xhp3","Warn: Project is vulnerable to: GHSA-j7hp-h8jx-5ppr","Warn: Project is vulnerable to: PYSEC-2023-175","Warn: Project is vulnerable to: GHSA-8qvm-5x2c-j2w7","Warn: Project is vulnerable to: PYSEC-2023-238 / GHSA-5wvp-7f3h-6wmm","Warn: Project is vulnerable to: PYSEC-2024-161","Warn: Project is vulnerable to: GHSA-mr82-8j83-vxmv","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: GHSA-2c2j-9gv5-cj73","Warn: Project is vulnerable to: GHSA-f96h-pmfr-66vw","Warn: Project is vulnerable to: GHSA-8qw9-gf7w-42x5","Warn: Project is vulnerable to: PYSEC-2024-153 / GHSA-rxff-vr5r-8cj5","Warn: Project is vulnerable to: GHSA-753j-mpmx-qq6g","Warn: Project is vulnerable to: GHSA-7cx3-6m66-7c5m","Warn: Project is vulnerable to: GHSA-8w49-h785-mj3c","Warn: Project is vulnerable to: GHSA-qppv-j76h-2rpx","Warn: Project is vulnerable to: GHSA-w235-7p84-xx57","Warn: Project is vulnerable to: GHSA-34jh-p97f-mpxf","Warn: Project is vulnerable to: PYSEC-2023-212 / GHSA-g4mx-q9vg-27p4","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: PYSEC-2023-192 / GHSA-v845-jxx5-vc9f","Warn: Project is vulnerable to: GHSA-jfmj-5v4g-7637","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-cx63-2mw6-8hw5","Warn: Project is vulnerable to: PYSEC-2024-187 / GHSA-rqc4-2hc7-8c8v"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T23:03:16.359Z","repository_id":37022012,"created_at":"2025-08-21T23:03:16.359Z","updated_at":"2025-08-21T23:03:16.359Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27730947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-14T02:00:11.348Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-center","datacenter","infrastructure","network-analysis","network-monitoring","network-validation","networking","python"],"created_at":"2024-08-01T02:01:54.041Z","updated_at":"2025-12-14T16:03:05.326Z","avatar_url":"https://github.com/netenglabs.png","language":"Python","funding_links":[],"categories":["Python","python","SuzieQ"],"sub_categories":["NETCONF"],"readme":"[![integration-tests](https://github.com/netenglabs/suzieq/workflows/integration-tests/badge.svg?branch=master)](https://github.com/netenglabs/suzieq/actions/workflows/integration-tests.yml)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/netenglabs/suzieq?logo=github\u0026color=success)](https://github.com/netenglabs/suzieq/releases/latest)\n[![GitHub](https://img.shields.io/github/license/netenglabs/suzieq?logo=github\u0026color=success)](LICENSE)\n[![Docker Image Version (latest by date)](https://img.shields.io/docker/v/netenglabs/suzieq?logo=docker\u0026color=blue)](https://hub.docker.com/r/netenglabs/suzieq/tags?page=1\u0026ordering=last_updated)\n[![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/netenglabs/suzieq?logo=docker\u0026color=blue)](https://hub.docker.com/r/netenglabs/suzieq/tags?page=1\u0026ordering=last_updated)\n[![Docker Pulls](https://img.shields.io/docker/pulls/netenglabs/suzieq?logo=docker\u0026color=blue)](https://hub.docker.com/r/netenglabs/suzieq/tags?page=1\u0026ordering=last_updated)\n\n# SuzieQ -- Healthier Networks Through Network Observability\n\nWould you like to be able to easily answer trivial questions such as how many unique prefixes are there in your routing table, or how many MAC addresses are there in the MAC tables across the network? How about more difficult questions, such as what changes did your routing table see between 10 pm and midnight last night, or which of your nodes have been up the longest, or which BGP sessions have had the most routing updates? How about being able to answer if your OSPF (or BGP) sessions are working correctly, or is all well with your EVPN? How about a quick way to determine the amount of ECMP at every hop between two endpoints? Do you wish you could easily validate the configuration you deployed across your network?\n\nDo you login to every network node you have to figure out answers to a questions like these? Do you then struggle to piece the information together into a consistent whole across the various formats provided by various vendors? Do you wish you had an **open source, multi-vendor** tool that could help you answer questions like these and more?\n\nIf you answered yes to one or more of these questions, then SuzieQ is a tool that we think will be interesting to you.  **SuzieQ helps you find things in your network.**\n\n**SuzieQ** is both a framework and an application using that framework, that is focused on **improving the observability of your network**.  We define observability as the ability of a system to answer either trivial or complex questions that you pose as you go about operating your network. How easily you can answer your questions is a measure of how good the system's observability is. A good observable system goes well beyond monitoring and alerting. SuzieQ is primarily meant for use by network engineers and designers.\n\nSuzieQ does multiple things. It [collects](https://suzieq.readthedocs.io/en/latest/poller/) data from devices and systems across your network. It normalizes the data and then stores it in a vendor independent way. Then it allows analysis of that data. With the applications that we build on top of the framework we want to demonstrate a different and more systematic approach to thinking about networks. We want to show how useful it is to think of your network holistically.\n\n**An enterprise version of SuzieQ is also available**. It has been deployed in production by multiple customers, and the company behind SuzieQ, [Stardust Systems](https://stardustsystems.net) was named a \"Cool Vendor\" by Gartner for making network automation easy for enterprises. \n\n## Quick Start\n\n### Using Docker Container\n\nWe want to make it as easy as possible for you to start engaging with SuzieQ so\nwe have a demo that has data included in the image. To get started:\n\n* `docker run -it -p 8501:8501 --name suzieq netenglabs/suzieq-demo`\n* `suzieq-cli` for the CLI OR\n* `suzieq-gui` for the GUI. Connect to http://localhost:8501 via the browser to access the GUI\n\nWhen you're within the suzieq-cli, you can run ```device unique columns=namespace``` to see the list of different scenarios, we've gathered data for.\n\nAdditional information about running the analyzer (suzieq-cli) is available via\nthe official [documentation page](https://suzieq.readthedocs.io/en/latest/).\n\nTo start collecting data for your network, create an inventory file to gather the data from following the instructions [here](https://suzieq.readthedocs.io/en/latest/poller/). Decide the directory where the data will be stored (ensure you have sufficient available space if you're going to be running the poller, say 100 MB at least). Lets call this dbdir. Now launch the suzieq docker container as follows:\n\n* ```docker run -it -v \u003cparquet-out-local-dir\u003e:/home/suzieq/parquet -v \u003cinventory-file\u003e:/home/suzieq/inventory.yml --name sq-poller netenglabs/suzieq:latest```\n* Launch the poller with the appropriate options. For example, ```sq-poller -D inventory.yml -n mydatacenter``` where mydatacenter is the name of the namespace where the data associated with the inventory is stored and inventory.yml is the inventory file in SuzieQ poller native format (Use -a instead of -D if you're using Ansible inventory file format).\n\n### Using Python Packaging\n\nIf you don't want to use docker container or cannot use a docker container, an alternative approach is to install SuzieQ as a python package. It is **strongly** recommended to install suzieq inside a virtual environment. If you already use a tool to create and manage virtual environments, you can skip the step of creating a virtual environment below.\n\nSuzieQ requires python version 3.7.1 at least, and has been tested with python versions 3.7 and 3.8. It has not been tested to work on Windows. Use Linux (recommended) or macOS. To create a virtual environment, in case you haven't got a tool to create one, type:\n\n```bash\npython -m venv suzieq\n```\n\nThis creates a directory called suzieq and all suzieq related info is stored there. Switch to that directory and activate the virtual environment with:\n\n```bash\nsource activate\n```\n\nNow the virtual environment is alive and you can install suzieq. To install suzieq, execute:\n\n```bash\npip install suzieq\n```\n\nOnce the command completes, you have the main programs of suzieq available for use:\n\n* sq-poller: For polling the devices and gathering the data\n* suzieq-gui: For launching the GUI\n* suzieq-cli: For running the CLI\n* sq-rest-server: For running the REST API server\n\n[The official documentation is at suzieq.readthedocs.io](https://suzieq.readthedocs.io/en/latest/), and you can watch the screencasts about SuzieQ on [Youtube](https://www.youtube.com/results?search_query=netenglabs).\n\n# Analysis\n\nSuzieQ supports Analysis using CLI, GUI, REST API, and python objects. For the most part they are equivalent, though with the GUI we have combined the output of multiple commands of the CLI into one page.\n\nThe GUI has a status page to let you know what the status of entities in your network.\n![SuzieQ GUI status](images/status.png)\n\nThe Xplore page lets you dive into what is in your network. ![Explore device](images/devices-gui.png)\n\nThe CLI supports the same kind of analysis as the explore page. ![CLI device](images/devices-cli.png)\n\n[More examples of the CLI can be seen in the docs and blog posts we've created.](https://suzieq.readthedocs.io/en/latest/analyzer/)\n\n## Path\n\nSuzieQ has the ability to show the path between two IP addresses, including the ability to show the path through EVPN overlay. You can use this to see each of the paths from a source to a destination and to see if you have anything asymmetrical in your paths. ![GUI PATH](images/path-gui.png)\n\n## Asserts\n\nOne of SuzieQ's powerful capabilities are asserts, which are statements that should be true in the network. We've only just started on asserts; what SuzieQ has now only demonstrates it's power, there's a lot more to be added in this space. ![interfaces assert](images/interfaces-assert.png)\n\n# SuzieQ Data\n\n**SuzieQ supports gathering data from Cumulus, EOS, IOS, IOSXE, IOSXR, JunOS(QFX, EX, MX and SRX platforms and Evolved OS), Palo Alto's Panos (version 8.0 or higher), NXOS and SONIC routers, and Linux servers.** SuzieQ gathers:\n\n* Basic device info including serial number, model, version, platform etc.\n* Interfaces\n* LLDP\n* MAC address table (VPLS MAC table for Junos MX)\n* MLAG\n* Routing table\n* ARP/ND table\n* OSPFv2\n* BGP\n* EVPN VNI info\n\nWe're adding support for more platforms and features with every release. See [the documentation](https://suzieq.readthedocs.io/en/latest/tables/) on details of specific tables and its NOS support.\n\nWe're also looking for collaborators to help us make SuzieQ a truly useful multi-vendor, open source platform for observing all aspects of networking. Please read the [collaboration document](./CONTRIBUTING.md) for ideas on how you can help.\n\n# Release Notes\n\nThe official release notes are [here](https://suzieq.readthedocs.io/en/latest/release-notes/).\n\n# Engage\n\nYou can join the conversation via [slack](https://join.slack.com/t/netenglabs/shared_invite/zt-g64xa6lc-SeP2OAj~3uLbgOWJniLslA). Send email to suzieq AT stardustsystems.net with the email address to send the Slack invitation to.\n\n# Additional Documentation \u0026 Screencasts\n\nWe've done some blogging about SuzieQ:\n\n* [Introducing SuzieQ](https://elegantnetwork.github.io/posts/SuzieQ/)\n* [10ish ways to explore your network with SuzieQ](https://elegantnetwork.github.io/posts/10ish_ways_to_explore_your_network_with_SuzieQ/)\n* [Questions to SuzieQ](https://elegantnetwork.github.io/posts/10qa-suzieq/)\n* [Time in SuzieQ](https://elegantnetwork.github.io/posts/time-suzieq/)\n\nWe've also been adding screencasts on [Youtube](https://www.youtube.com/results?search_query=netenglabs).\n\n# SuzieQ Enterprise\n\nSuzieQ also has a commercial offering, SuzieQ Enterprise. To know more about this and contact us, please visit the Stardust Systems [website](https://stardustsystems.net).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetenglabs%2Fsuzieq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetenglabs%2Fsuzieq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetenglabs%2Fsuzieq/lists"}