hub / github.com/NVIDIA/topograph

github.com/NVIDIA/topograph @v0.5.0

repository ↗ · DeepWiki ↗ · release v0.5.0 ↗ · + Follow

962 symbols 3,437 edges 151 files 138 documented · 14% ● updated 2d agov0.5.0 · 2026-06-30★ 1384 open issues

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Topograph

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

Learn more

Extension points exported contracts — how you extend this code

Provider (Interface)

(no doc) [22 implementers]

pkg/providers/providers.go

Engine (Interface)

(no doc) [4 implementers]

pkg/engines/engines.go

Hashable (Interface)

(no doc) [2 implementers]

pkg/server/trailing_delay_queue.go

NamedLoader (FuncType)

NamedLoader returns a name/loader pair for a component that is used to add to an instance of `Registry`.

internal/component/component.go

StringDecoder (Interface)

StringDecoder is used as a way for custom types (or alias types) to override the basic decoding function in the `decodeS

internal/config/decode.go

RequestFunc (FuncType)

(no doc)

internal/httpreq/httpreq.go

IBNetDiscover (Interface)

(no doc) [3 implementers]

pkg/providers/infiniband/common.go

Labeler (Interface)

(no doc) [2 implementers]

pkg/engines/k8s/labeler.go

Core symbols most depended-on inside this repo

NewError

called by 145

internal/httperr/http_error.go

Error

called by 107

internal/httperr/http_error.go

Run

called by 84

pkg/providers/infiniband/common.go

String

called by 73

pkg/topology/topology.go

Len

called by 38

pkg/topology/graph.go

NewNetworkTopology

called by 29

pkg/translate/topology.go

NewDomainMap

called by 25

pkg/topology/domain.go

AddHost

called by 24

pkg/topology/domain.go

Shape

Function 527

Method 240

Struct 155

Interface 19

FuncType 12

TypeAlias 9

Languages

Go100%

Modules by API surface

pkg/translate/block_tree.go28 symbols

pkg/providers/lambdai/provider.go24 symbols

pkg/engines/slurm/slurm.go24 symbols

pkg/providers/nebius/provider.go23 symbols

pkg/providers/gcp/provider.go22 symbols

pkg/engines/slinky/engine.go22 symbols

pkg/providers/nscale/provider.go21 symbols

pkg/providers/oci/provider_api.go20 symbols

pkg/providers/aws/provider.go19 symbols

pkg/node_observer/status_informer.go19 symbols

pkg/server/http_server.go18 symbols

pkg/models/model.go18 symbols

For agents

$ claude mcp add topograph \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact