v0.1.2

What's Changed

• chore(deps): bump actions/checkout from 7.0.0 to 7.0.1 by @dependabot[bot] in #7
• chore(deps): bump clap from 4.6.1 to 4.6.4 by @dependabot[bot] in #8
• chore(deps): bump libc from 0.2.186 to 0.2.189 by @dependabot[bot] in #9
• chore(deps): bump jsonschema from 0.47.0 to 0.48.2 by @dependabot[bot] in #10
• chore(deps): bump regex from 1.13.0 to 1.13.1 by @dependabot[bot] in #11
• chore(deps): bump tokio from 1.52.3 to 1.53.1 by @dependabot[bot] in #12
• chore(deps): bump serde_json from 1.0.150 to 1.0.151 by @dependabot[bot] in #13
• chore(deps): bump thiserror from 2.0.18 to 2.0.19 by @dependabot[bot] in #14
• chore(deps): bump serde from 1.0.228 to 1.0.229 by @dependabot[bot] in #15
• chore(deps): bump futures-util from 0.3.32 to 0.3.33 by @dependabot[bot] in #16
• chore(deps): bump jsonschema from 0.48.2 to 0.49.2 by @dependabot[bot] in #17
• chore(deps): bump clap_complete from 4.6.7 to 4.6.8 by @dependabot[bot] in #18
• chore(deps): bump clap from 4.6.4 to 4.6.5 by @dependabot[bot] in #19
• chore(deps): bump clap_complete from 4.6.8 to 4.6.9 by @dependabot[bot] in #20
• chore(deps): bump thiserror from 2.0.19 to 2.0.20 by @dependabot[bot] in #21
• chore(deps): bump clap_mangen from 0.3.0 to 0.3.2 by @dependabot[bot] in #22
• chore(deps): bump jsonschema from 0.49.2 to 0.49.8 by @dependabot[bot] in #23
• chore(deps): bump clap from 4.6.5 to 4.6.6 by @dependabot[bot] in #24
• chore: observe upstream compatibility metadata by @github-actions[bot] in #28
• chore(deps): bump futures-util from 0.3.33 to 0.3.34 by @dependabot[bot] in #25
• chore(deps): bump clap_mangen from 0.3.2 to 0.3.3 by @dependabot[bot] in #26
• chore(deps): bump jsonschema from 0.49.8 to 0.49.9 by @dependabot[bot] in #27

New Contributors

• @github-actions[bot] made their first contribution in #28

Full Changelog: v0.1.1...v0.1.2

v0.1.1

This release strengthens compatibility detection, GPU verification, cache safety, and subprocess handling, and introduces a secure release-binary installer.

Highlights

• Match complete Python, ABI, and platform wheel tags.
• Reject incompatible 32-bit and cross-architecture Python environments.
• Generate install commands for the exact Python environment analyzed by torch-check.
• Respect uv virtual-environment discovery while avoiding ambiguous interpreter selection.
• Verify every detected NVIDIA GPU by default and reject CPU-only PyTorch builds on GPU hosts.
• Prevent older concurrent metadata fetches from overwriting newer cache entries.
• Bound subprocess output collection to avoid hangs caused by inherited pipes.
• Improve Windows process and cache behavior.

Binary installer

Install the latest release into $HOME/.local/bin:

curl -fsSL https://raw.githubusercontent.com/rice8y/torch-check/main/scripts/install.sh | sh

Install this specific version:

curl -fsSL https://raw.githubusercontent.com/rice8y/torch-check/main/scripts/install.sh | sh -s -- --version 0.1.1

The installer verifies release checksums before replacing an existing binary and supports Linux x86_64/aarch64, macOS x86_64/arm64, and Windows x86_64 under Git Bash, MSYS2, or Cygwin.

Full Changelog: v0.1.0...v0.1.1

v0.1.0

Initial production release of torch-check, a CLI tool that inspects a Linux/Python/NVIDIA environment and recommends an installable official PyTorch wheel.

Highlights

• Detects OS, architecture, kernel, glibc, CPython ABI, Python executable, NVIDIA GPUs, compute capability, NVIDIA driver, driver-reported CUDA, and local CUDA Toolkit.
• Resolves against official PyTorch wheel indexes instead of assuming a wheel exists.
• Recommends CUDA wheels from reviewed PyTorch release metadata, with CPU fallback only when no reviewed CUDA candidate passes static checks.
• Correctly treats nvidia-smi's reported CUDA version as informational, not as a hard upper bound for PyTorch wheel selection.
• Supports NVIDIA CUDA minor-version compatibility rules and warns when PTX JIT or newer-driver features may still require a driver upgrade.
• Includes reviewed GPU architecture evidence for PyTorch 2.6 through 2.13, including Blackwell sm120 coverage where supported.
• Generates install commands for pip, uv pip, and uv add.
• Defaults install commands to the active Python environment; --python pins detection, verification, and install command generation to a specific interpreter.
• Provides compact human output, structured JSON output, candidate inspection, explanation mode, and runtime verification mode.
• Uses atomic metadata cache writes and offline/refresh controls.
• Ships without telemetry and never executes installation commands.

Supported production target

The production recommendation target is Linux x86_64 with glibc, CPython, NVIDIA GPUs, and official PyTorch pip wheels.

Other platforms can run the binary and inspect the host, but PyTorch wheel recommendation is intentionally limited where the compatibility model is not yet supported.

Prebuilt binaries

This release includes archives for:

• x86_64-unknown-linux-musl
• aarch64-unknown-linux-musl
• x86_64-apple-darwin
• aarch64-apple-darwin
• x86_64-pc-windows-msvc

Each archive contains the binary, shell completions, a man page, project licenses, security policy, and third-party license notices. SHA256SUMS is included for archive verification.

Install

From crates.io:

cargo install torch-check --locked

Or download a prebuilt archive from this release.

Example

torch-check
torch-check --installer uv
torch-check candidates --unverified
torch-check explain torch==2.13.0 --cuda cu126
torch-check verify

Notes

This is the first public release. Compatibility rules are intentionally conservative: uncertain CUDA candidates are shown for review, but the default install command is reserved for candidates backed by reviewed metadata and static checks.