The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""NVIDIA platform recognition derived from host facts.
Recognition uses OS-reported CPU, GPU or PCI identity without environment-variable input.
"""
from __future__ import annotations
from typing import Literal
from hermes_platform.host import facts
NvidiaPlatform = Literal["rtx_spark", "dgx_spark", "discrete"]
_RTX_SPARK_CPU_MARKER = "N1X"
_DGX_SPARK_MARKERS = ("GB10", "DGX SPARK")
def is_nvidia_n1x_pci_id(pci_id: int) -> bool:
"""Recognize N1X; NVML packs device above the 16-bit vendor ID."""
return pci_id & 0xFFFF == 0x10DE and 0x2E00 <= pci_id >> 16 <= 0x2E3F
def classify_nvidia_platform(*, os_family: str, native_arch: str, cpu_model: str, gpu_class: str,
nvidia_gpus: tuple[facts.NvidiaGpu, ...]) -> NvidiaPlatform | None:
"""Return the NVIDIA platform the supplied host facts describe, or ``None`` without an NVIDIA GPU.
- ``rtx_spark``: Windows on arm64 whose CPU name carries the N1X marker or whose GPU is in
``is_nvidia_n1x_pci_id``'s range, the same range the local catalog's measured row uses.
- ``dgx_spark``: Linux on arm64 whose NVIDIA driver names a GB10 GPU, or whose CPU or
device-tree model names GB10 or DGX Spark. Other arm64 NVIDIA servers are ``discrete``.
- ``discrete``: any other host with an NVIDIA GPU.
"""
cpu = cpu_model.replace("_", " ").upper()
if native_arch == "arm64" and os_family == "win32":
n1x_gpu = any(gpu.pci_id is not None and is_nvidia_n1x_pci_id(gpu.pci_id) for gpu in nvidia_gpus)
if n1x_gpu or _RTX_SPARK_CPU_MARKER in cpu:
return "rtx_spark"
if native_arch == "arm64" and os_family.startswith("linux"):
names = " ".join(gpu.name for gpu in nvidia_gpus).upper()
if any(marker in names or marker in cpu for marker in _DGX_SPARK_MARKERS):
return "dgx_spark"
return "discrete" if gpu_class == "nvidia" else None
def nvidia_platform() -> NvidiaPlatform | None:
"""The NVIDIA platform of this host; ``classify_nvidia_platform`` holds the rules.
Reads only cached host facts (registry, sysfs, procfs, sysctl): no subprocess, no driver
library, no network. Verified on an N1X laptop (native arm64 and emulated x64 Python): the
registry CPU name carries the N1X marker, both GPUs are NVIDIA display adapters with PCI
devices 0x2E03 and 0x2E06 (inside the catalog's N1X range), and the answer is ``rtx_spark``.
Not verified on hardware: the GB10 model name in ``/proc/driver/nvidia/gpus/*/information``
and the DGX Spark device-tree model.
"""
return classify_nvidia_platform(
os_family=facts.os_family(), native_arch=facts.native_arch(), cpu_model=facts.cpu_model(),
gpu_class=facts.gpu_class(), nvidia_gpus=facts.nvidia_gpus())