Hardware Report

Automated infrastructure discovery tool built with hexagonal architecture.

Generates structured hardware inventory reports in TOML/JSON format. Designed to power observability, cluster acceptance testing, CMDB population, infrastructure auditing, and bare-metal server management at AI NeoClouds scale.

Platforms: Linux, macOS | Architectures: x86_64, ARM64 | GPUs: NVIDIA (including Blackwell)

Table of Contents

• What Does This Do?
• Quick Start
• Documentation
• Contributing
• License

What Does This Do?

• CPU Discovery - Model, sockets, cores, threads, NUMA topology, cache hierarchy
• Memory Detection - Total capacity, module details, DDR type, speed, slot mapping
• Storage Enumeration - NVMe/SSD/HDD detection, capacity, serial numbers, SMART status
• GPU Detection - NVIDIA via nvidia-smi, memory, PCI topology, UUIDs
• Network Interfaces - MAC/IP, speed (1G-400G+), InfiniBand, driver info
• System Information - BIOS, BMC/IPMI, chassis serial, motherboard specs

Quick Start

Recommended: Nix build (automatically handles all dependencies)

# Install Nix (if not already installed)
curl -L https://install.determinate.systems/nix | sh -s -- install
. /nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh

# Clone, build, and run
git clone https://codeberg.org/kennysheridan/hardware_report.git
cd hardware_report
nix build
sudo ./result/bin/hardware_report

Output: <chassis_serial>_hardware_report.toml

Cargo install: cargo install hardware_report

Other installation methods: See docs/INSTALLATION.md

Documentation

Contributing

nix develop
cargo test && cargo clippy && cargo fmt

License

Apache-2.0

Built for infrastructure management at AI NeoClouds scale | Source | Issues