gpu-stack-inspector 0.1.0__tar.gz

gpu_stack_inspector-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BhuwanJoshi-01
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gpu_stack_inspector-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: gpu-stack-inspector
+Version: 0.1.0
+Summary: Explain why your AI code uses the GPU in one Python environment but not another.
+Keywords: cuda,pytorch,gpu,nvidia,conda,venv,diagnostics,troubleshooting
+Author: BhuwanJoshi-01
+Author-email: BhuwanJoshi-01 <bhuwanj779@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Dist: rich>=15.0.0
+Requires-Dist: typer>=0.27.3
+Requires-Python: >=3.11
+Project-URL: Homepage, https://bhuwanjoshi-01.github.io/gpu-stack-inspector/
+Project-URL: Documentation, https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md
+Project-URL: Source, https://github.com/BhuwanJoshi-01/gpu-stack-inspector
+Project-URL: Issues, https://github.com/BhuwanJoshi-01/gpu-stack-inspector/issues
+Project-URL: Changelog, https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# GPU Stack Inspector
+
+**Explain why your AI code uses the GPU in one Python environment but not another.**
+
+[![CI](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/actions/workflows/ci.yml/badge.svg)](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/LICENSE)
+[![Website](https://img.shields.io/badge/website-gpu--stack--inspector-17202e.svg)](https://bhuwanjoshi-01.github.io/gpu-stack-inspector/)
+
+`nvidia-smi` shows your GPU, yet `torch.cuda.is_available()` is `True` in one environment and `False` in another.
+GPU Stack Inspector inspects several Python interpreters from one command, shows what differs between them, and
+explains which difference matters, with the evidence:
+
+![compare on a laptop with an RTX 3050: a conda environment with torch 2.11.0+cu128 against a venv with torch 2.15.0+cpu. The table shows the torch build CUDA 12.8 versus CPU only and fifteen nvidia CUDA wheels missing from the venv; the findings fail GSI-TORCH-002 for the CPU-only build and warn GSI-DIFF-001 that the environments have different PyTorch builds.](https://raw.githubusercontent.com/BhuwanJoshi-01/gpu-stack-inspector/main/docs/images/compare.svg)
+
+> **Status:** 0.1.0 is the first release, validated on one laptop with five real environments. Reports from
+> other machines are very welcome.
+
+## Install
+
+The tool needs Python 3.11 or newer; the interpreters it inspects can be Python 3.8 or newer.
+
+```bash
+uv tool install git+https://github.com/BhuwanJoshi-01/gpu-stack-inspector   # until the PyPI release
+pipx install git+https://github.com/BhuwanJoshi-01/gpu-stack-inspector      # or with pipx
+```
+
+## Use
+
+```bash
+gpu-stack-inspector compare --python ~/envs/works/bin/python --python ~/envs/broken/bin/python
+gpu-stack-inspector inspect --python ~/envs/broken/bin/python      # one environment in detail
+gpu-stack-inspector probe --runtime --python ~/envs/broken/bin/python   # opt-in: really runs a tiny CUDA operation
+gpu-stack-inspector report --python ~/envs/broken/bin/python --output gpu-report.md   # redacted, for an issue
+gpu-stack-inspector rules list                                     # every check; `rules explain CODE` for one
+```
+
+Without `--python` it inspects the `python` your shell runs. See the [command reference](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/cli.md).
+
+## What it checks
+
+- **The machine**: driver tools, whether the driver answers and which CUDA versions it supports, the GPUs and their
+  compute capability, `CUDA_VISIBLE_DEVICES`.
+- **Each interpreter**: whether it starts, whether it is the one your shell runs, whether torch is installed where it
+  is needed, and which build it is (CUDA with its version, CPU-only, ROCm), decided from the version tag,
+  `torch/version.py`, the CUDA libraries in `torch/lib`, the `nvidia-*` requirements and conda's records, without
+  importing torch.
+- **Compatibility**: the driver against the CUDA version torch was built for and against nvcc, using dated,
+  source-tagged NVIDIA compatibility data.
+- **The comparison**: every field that differs, and whether the environments have different PyTorch builds.
+- **At runtime** (`probe --runtime` only): importing torch and running an operation on the GPU, step by step.
+
+Every finding has a stable code, the evidence it rests on, what to do next and the command to check it afterwards.
+[Troubleshooting](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md) explains the common ones.
+
+## What it promises
+
+- **Read-only.** It never installs, upgrades or changes anything, and never needs `sudo`. It writes nothing except a
+  report file you name.
+- **Your environments stay untouched.** A fixed probe program reads each interpreter's metadata. torch is only
+  imported with `probe --runtime`, because creating a CUDA context uses GPU memory and can hang on a broken system.
+- **Unknown is not a pass.** A check that could not run is unknown or not tested, never green.
+- **Shareable output.** Home paths, user and host names, secrets and tokens are redacted before anything is printed
+  or written, JSON included, and each report says what was redacted. No network access, no telemetry.
+
+Details in [privacy](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/privacy.md).
+
+## Tested on
+
+An Ubuntu 26.04 laptop with an RTX 3050 (driver 595.99.02) and five real environments: conda and uv, Python 3.8 to
+3.13, CUDA 11.3 to 13.0 builds and a CPU-only build. CI runs the tests on Linux and Windows and the probe in Python
+3.8 to 3.10 and PyPy. Windows and WSL with a GPU, containers and macOS are **not validated**; see the
+[support matrix](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/support-matrix.md).
+
+## Alternatives
+
+If you only need to check a single environment, these may already be enough:
+
+- [cuda-doctor](https://pypi.org/project/cuda-doctor/) checks the GPU, driver, toolkit, compiler and PyTorch of the
+  environment it is installed in.
+- [env-doctor](https://github.com/mitulgarg/env-doctor) checks the driver, CUDA, cuDNN and frameworks, and compares
+  machines in a fleet dashboard.
+- [cudadoc](https://www.cudadoc.com/docs/quickstart) includes a GPU validation suite.
+
+GPU Stack Inspector focuses on comparing **environments on the same machine**.
+
+## Documentation
+
+[Command reference](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/cli.md) · [Troubleshooting](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md) · [Privacy](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/privacy.md) ·
+[Support matrix](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/support-matrix.md) · [JSON output](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/json-output.md) · [Architecture](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/architecture.md) ·
+[Sample reports](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/tree/main/docs/sample-reports) · [Roadmap](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/roadmap.md)
+
+## Contributing
+
+Test reports, fixtures from unusual systems, bug reports and pull requests are welcome; see
+[CONTRIBUTING.md](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/CONTRIBUTING.md). Security problems, including a report that leaks private data, go through
+[SECURITY.md](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/SECURITY.md).
+
+## License
+
+[MIT](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/LICENSE)

gpu_stack_inspector-0.1.0/README.md

@@ -0,0 +1,100 @@
+# GPU Stack Inspector
+
+**Explain why your AI code uses the GPU in one Python environment but not another.**
+
+[![CI](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/actions/workflows/ci.yml/badge.svg)](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/LICENSE)
+[![Website](https://img.shields.io/badge/website-gpu--stack--inspector-17202e.svg)](https://bhuwanjoshi-01.github.io/gpu-stack-inspector/)
+
+`nvidia-smi` shows your GPU, yet `torch.cuda.is_available()` is `True` in one environment and `False` in another.
+GPU Stack Inspector inspects several Python interpreters from one command, shows what differs between them, and
+explains which difference matters, with the evidence:
+
+![compare on a laptop with an RTX 3050: a conda environment with torch 2.11.0+cu128 against a venv with torch 2.15.0+cpu. The table shows the torch build CUDA 12.8 versus CPU only and fifteen nvidia CUDA wheels missing from the venv; the findings fail GSI-TORCH-002 for the CPU-only build and warn GSI-DIFF-001 that the environments have different PyTorch builds.](https://raw.githubusercontent.com/BhuwanJoshi-01/gpu-stack-inspector/main/docs/images/compare.svg)
+
+> **Status:** 0.1.0 is the first release, validated on one laptop with five real environments. Reports from
+> other machines are very welcome.
+
+## Install
+
+The tool needs Python 3.11 or newer; the interpreters it inspects can be Python 3.8 or newer.
+
+```bash
+uv tool install git+https://github.com/BhuwanJoshi-01/gpu-stack-inspector   # until the PyPI release
+pipx install git+https://github.com/BhuwanJoshi-01/gpu-stack-inspector      # or with pipx
+```
+
+## Use
+
+```bash
+gpu-stack-inspector compare --python ~/envs/works/bin/python --python ~/envs/broken/bin/python
+gpu-stack-inspector inspect --python ~/envs/broken/bin/python      # one environment in detail
+gpu-stack-inspector probe --runtime --python ~/envs/broken/bin/python   # opt-in: really runs a tiny CUDA operation
+gpu-stack-inspector report --python ~/envs/broken/bin/python --output gpu-report.md   # redacted, for an issue
+gpu-stack-inspector rules list                                     # every check; `rules explain CODE` for one
+```
+
+Without `--python` it inspects the `python` your shell runs. See the [command reference](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/cli.md).
+
+## What it checks
+
+- **The machine**: driver tools, whether the driver answers and which CUDA versions it supports, the GPUs and their
+  compute capability, `CUDA_VISIBLE_DEVICES`.
+- **Each interpreter**: whether it starts, whether it is the one your shell runs, whether torch is installed where it
+  is needed, and which build it is (CUDA with its version, CPU-only, ROCm), decided from the version tag,
+  `torch/version.py`, the CUDA libraries in `torch/lib`, the `nvidia-*` requirements and conda's records, without
+  importing torch.
+- **Compatibility**: the driver against the CUDA version torch was built for and against nvcc, using dated,
+  source-tagged NVIDIA compatibility data.
+- **The comparison**: every field that differs, and whether the environments have different PyTorch builds.
+- **At runtime** (`probe --runtime` only): importing torch and running an operation on the GPU, step by step.
+
+Every finding has a stable code, the evidence it rests on, what to do next and the command to check it afterwards.
+[Troubleshooting](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md) explains the common ones.
+
+## What it promises
+
+- **Read-only.** It never installs, upgrades or changes anything, and never needs `sudo`. It writes nothing except a
+  report file you name.
+- **Your environments stay untouched.** A fixed probe program reads each interpreter's metadata. torch is only
+  imported with `probe --runtime`, because creating a CUDA context uses GPU memory and can hang on a broken system.
+- **Unknown is not a pass.** A check that could not run is unknown or not tested, never green.
+- **Shareable output.** Home paths, user and host names, secrets and tokens are redacted before anything is printed
+  or written, JSON included, and each report says what was redacted. No network access, no telemetry.
+
+Details in [privacy](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/privacy.md).
+
+## Tested on
+
+An Ubuntu 26.04 laptop with an RTX 3050 (driver 595.99.02) and five real environments: conda and uv, Python 3.8 to
+3.13, CUDA 11.3 to 13.0 builds and a CPU-only build. CI runs the tests on Linux and Windows and the probe in Python
+3.8 to 3.10 and PyPy. Windows and WSL with a GPU, containers and macOS are **not validated**; see the
+[support matrix](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/support-matrix.md).
+
+## Alternatives
+
+If you only need to check a single environment, these may already be enough:
+
+- [cuda-doctor](https://pypi.org/project/cuda-doctor/) checks the GPU, driver, toolkit, compiler and PyTorch of the
+  environment it is installed in.
+- [env-doctor](https://github.com/mitulgarg/env-doctor) checks the driver, CUDA, cuDNN and frameworks, and compares
+  machines in a fleet dashboard.
+- [cudadoc](https://www.cudadoc.com/docs/quickstart) includes a GPU validation suite.
+
+GPU Stack Inspector focuses on comparing **environments on the same machine**.
+
+## Documentation
+
+[Command reference](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/cli.md) · [Troubleshooting](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md) · [Privacy](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/privacy.md) ·
+[Support matrix](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/support-matrix.md) · [JSON output](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/json-output.md) · [Architecture](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/architecture.md) ·
+[Sample reports](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/tree/main/docs/sample-reports) · [Roadmap](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/roadmap.md)
+
+## Contributing
+
+Test reports, fixtures from unusual systems, bug reports and pull requests are welcome; see
+[CONTRIBUTING.md](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/CONTRIBUTING.md). Security problems, including a report that leaks private data, go through
+[SECURITY.md](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/SECURITY.md).
+
+## License
+
+[MIT](https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/LICENSE)

gpu_stack_inspector-0.1.0/pyproject.toml

@@ -0,0 +1,133 @@
+[project]
+name = "gpu-stack-inspector"
+version = "0.1.0"
+description = "Explain why your AI code uses the GPU in one Python environment but not another."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+keywords = [
+    "cuda",
+    "pytorch",
+    "gpu",
+    "nvidia",
+    "conda",
+    "venv",
+    "diagnostics",
+    "troubleshooting",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: System :: Hardware",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+dependencies = [
+    "rich>=15.0.0",
+    "typer>=0.27.3",
+]
+
+[[project.authors]]
+name = "BhuwanJoshi-01"
+email = "bhuwanj779@gmail.com"
+
+[project.urls]
+Homepage = "https://bhuwanjoshi-01.github.io/gpu-stack-inspector/"
+Documentation = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md"
+Source = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector"
+Issues = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector/issues"
+Changelog = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/CHANGELOG.md"
+
+[project.scripts]
+gpu-stack-inspector = "gpu_stack_inspector.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.11.29,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "hypothesis>=6.170.14",
+    "jsonschema>=4.26.0",
+    "mypy>=2.4.1",
+    "pytest>=9.2.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.3",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = [
+    "src",
+    "tests",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "B",
+    "UP",
+    "SIM",
+    "C4",
+    "PTH",
+    "S",
+    "PT",
+    "RUF",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "gpu_stack_inspector",
+    "tests",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"src/gpu_stack_inspector/probes/*_program.py" = [
+    "UP",
+    "PTH",
+]
+"tests/**" = [
+    "S101",
+    "S105",
+    "S106",
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_unreachable = true
+files = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+]
+xfail_strict = true
+markers = ["integration: talks to the real machine; runs only with GSI_INTEGRATION=1"]
+
+[tool.coverage.run]
+source = ["gpu_stack_inspector"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

gpu_stack_inspector-0.1.0/pyproject.toml.orig

@@ -0,0 +1,110 @@
+[project]
+name = "gpu-stack-inspector"
+version = "0.1.0"
+description = "Explain why your AI code uses the GPU in one Python environment but not another."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "BhuwanJoshi-01", email = "bhuwanj779@gmail.com" }
+]
+requires-python = ">=3.11"
+keywords = ["cuda", "pytorch", "gpu", "nvidia", "conda", "venv", "diagnostics", "troubleshooting"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: System :: Hardware",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+dependencies = [
+    "rich>=15.0.0",
+    "typer>=0.27.3",
+]
+
+[project.urls]
+Homepage = "https://bhuwanjoshi-01.github.io/gpu-stack-inspector/"
+Documentation = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/docs/troubleshooting.md"
+Source = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector"
+Issues = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector/issues"
+Changelog = "https://github.com/BhuwanJoshi-01/gpu-stack-inspector/blob/main/CHANGELOG.md"
+
+[project.scripts]
+gpu-stack-inspector = "gpu_stack_inspector.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.11.29,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "hypothesis>=6.170.14",
+    "jsonschema>=4.26.0",
+    "mypy>=2.4.1",
+    "pytest>=9.2.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.3",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E", "W", "F",  # pycodestyle, pyflakes
+    "I",            # import order
+    "B",            # bugbear
+    "UP",           # pyupgrade
+    "SIM",          # simplify
+    "C4",           # comprehensions
+    "PTH",          # pathlib
+    "S",            # bandit: subprocess and secret handling matter in this tool
+    "PT",           # pytest style
+    "RUF",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["gpu_stack_inspector", "tests"]
+
+[tool.ruff.lint.per-file-ignores]
+# Runs inside target interpreters as old as Python 3.8: no modern syntax upgrades.
+"src/gpu_stack_inspector/probes/*_program.py" = ["UP", "PTH"]
+"tests/**" = [
+    "S101",  # assert is how pytest works
+    "S105", "S106",  # fake secrets are the point of the redaction tests
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_unreachable = true
+files = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+addopts = ["-ra", "--strict-markers", "--strict-config"]
+xfail_strict = true
+markers = [
+    "integration: talks to the real machine; runs only with GSI_INTEGRATION=1",
+]
+
+[tool.coverage.run]
+source = ["gpu_stack_inspector"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

gpu_stack_inspector-0.1.0/src/gpu_stack_inspector/__init__.py

@@ -0,0 +1,8 @@
+"""GPU Stack Inspector: explain GPU differences between Python environments."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("gpu-stack-inspector")
+except PackageNotFoundError:  # imported from a source tree that was never installed
+    __version__ = "0+unknown"

gpu_stack_inspector-0.1.0/src/gpu_stack_inspector/__main__.py

@@ -0,0 +1,6 @@
+"""Allow ``python -m gpu_stack_inspector``."""
+
+from gpu_stack_inspector.cli import main
+
+if __name__ == "__main__":
+    main()