NVIDIA/topograph

NVIDIA/topograph

Description: A toolkit for discovering cluster network topology.

Language: Go

License: Apache-2.0

Stars: 131

Forks: 21

Open issues: 12

Created: 2024-09-25T16:53:37Z

Pushed: 2026-06-10T23:44:53Z

Default branch: main

Fork: no

Archived: no

README:

Topograph

!Build Status !Codecov

Topograph is a component that discovers the physical network topology of a cluster and exposes it to schedulers, enabling topology-aware scheduling decisions. It abstracts multiple topology sources and translates them into the format required by each scheduler.

Quick Start

Pick the install path that matches your scheduler:

• Kubernetes — the same Helm chart covers native Kubernetes scheduling (k8s engine) and Slinky (Slurm-on-Kubernetes, slinky engine). See [Install on Kubernetes](docs/get-started/quickstart-k8s.md).
• Slurm (bare metal) — install a .deb or .rpm package on the Slurm head node and run Topograph as a systemd service. See [Install on Slurm](docs/get-started/quickstart-slurm.md).

Learn more

• [Overview](docs/overview.md)
• [Architecture](docs/architecture.md)
• [Configuration and API](docs/api.md)