# pynvml-amd-windows
## Purpose
**pynvml-amd-windows** is a drop-in replacement for NVIDIA's `pynvml` Python library, designed to allow existing pynvml-based applications to monitor and manage AMD GPUs on Windows systems. It provides a compatible API that redirects NVML calls to the AMD ADLX backend, enabling tools that were written for NVIDIA GPUs to work seamlessly with AMD hardware.
It was written for the specific purpose of enabling [Crystools](https://github.com/crystian/ComfyUI-Crystools) GPU performance monitoring for AMD platforms under Windows.
This package is especially useful if you have tools or scripts that expect `pynvml` to be present, and you want them to function without modification on systems with supported AMD GPUs.
## Features
- Implements the `pynvml` interface using AMD's ADLX library for Windows.
- Compatible with most scripts and programs expecting `import pynvml`.
- No need to modify existing code: the package transparently handles imports using a `.pth` file.
## Installation
### Using pip
```
pip install pynvml-amd-windows
```
### From source
Clone or download this repository, then run:
```
pip install .
```
from within the project directory.
## Usage
After installation, any Python program that imports `pynvml` (or uses a package depending on it) will transparently use the AMD implementation on Windows—no code changes required.
Example:
```
python
import pynvml
pynvml.nvmlInit()
count = pynvml.nvmlDeviceGetCount()
print("Number of AMD GPUs detected:", count)
```
## Limitations
- Only supports AMD GPUs on Windows using the ADLX backend.
- Some advanced `pynvml` features may not be supported or may have slightly different behavior due to backend differences.
## License
This project is distributed under the MIT License.
## Authors
- Christopher Anderson (<sfinktah@github.spamtrak.org>)
```
Raw data
{
"_id": null,
"home_page": null,
"name": "pynvml-amd-windows",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "amd, gpu, nvidia, pynvml, adlx, crystools, comfyui, windows",
"author": null,
"author_email": "sfinktah <sfinktah@github.spamtrak.org>",
"download_url": "https://files.pythonhosted.org/packages/41/49/189536f1a6faf85b10c4326a8f64136333626a679d802a312e1fd6810fe5/pynvml_amd_windows-1.0.14.tar.gz",
"platform": null,
"description": "# pynvml-amd-windows\r\n\r\n## Purpose\r\n\r\n**pynvml-amd-windows** is a drop-in replacement for NVIDIA's `pynvml` Python library, designed to allow existing pynvml-based applications to monitor and manage AMD GPUs on Windows systems. It provides a compatible API that redirects NVML calls to the AMD ADLX backend, enabling tools that were written for NVIDIA GPUs to work seamlessly with AMD hardware.\r\n\r\nIt was written for the specific purpose of enabling [Crystools](https://github.com/crystian/ComfyUI-Crystools) GPU performance monitoring for AMD platforms under Windows.\r\n\r\nThis package is especially useful if you have tools or scripts that expect `pynvml` to be present, and you want them to function without modification on systems with supported AMD GPUs.\r\n\r\n## Features\r\n\r\n- Implements the `pynvml` interface using AMD's ADLX library for Windows.\r\n- Compatible with most scripts and programs expecting `import pynvml`.\r\n- No need to modify existing code: the package transparently handles imports using a `.pth` file.\r\n\r\n## Installation\r\n\r\n### Using pip\r\n```\r\npip install pynvml-amd-windows\r\n```\r\n\r\n### From source\r\n\r\nClone or download this repository, then run:\r\n```\r\npip install .\r\n```\r\nfrom within the project directory.\r\n\r\n## Usage\r\n\r\nAfter installation, any Python program that imports `pynvml` (or uses a package depending on it) will transparently use the AMD implementation on Windows\u2014no code changes required.\r\n\r\nExample:\r\n```\r\npython\r\nimport pynvml\r\n\r\npynvml.nvmlInit()\r\ncount = pynvml.nvmlDeviceGetCount()\r\nprint(\"Number of AMD GPUs detected:\", count)\r\n```\r\n## Limitations\r\n\r\n- Only supports AMD GPUs on Windows using the ADLX backend.\r\n- Some advanced `pynvml` features may not be supported or may have slightly different behavior due to backend differences.\r\n\r\n## License\r\n\r\nThis project is distributed under the MIT License.\r\n\r\n## Authors\r\n\r\n- Christopher Anderson (<sfinktah@github.spamtrak.org>)\r\n```\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "pynvml-compatible library for AMD GPUs on Windows",
"version": "1.0.14",
"project_urls": {
"Bug Reports": "https://github.com/sfinktah/pynvml-amd-windows/issues",
"Source": "https://github.com/sfinktah/pynvml-amd-windows"
},
"split_keywords": [
"amd",
" gpu",
" nvidia",
" pynvml",
" adlx",
" crystools",
" comfyui",
" windows"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4149189536f1a6faf85b10c4326a8f64136333626a679d802a312e1fd6810fe5",
"md5": "258fdb68b97053941d038796d4fa85c5",
"sha256": "0b3c739450432a441d9f7285bbf15f2de64b76d65b2892d7ff7daa7b58af7c86"
},
"downloads": -1,
"filename": "pynvml_amd_windows-1.0.14.tar.gz",
"has_sig": false,
"md5_digest": "258fdb68b97053941d038796d4fa85c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 7793,
"upload_time": "2025-07-16T19:18:55",
"upload_time_iso_8601": "2025-07-16T19:18:55.659972Z",
"url": "https://files.pythonhosted.org/packages/41/49/189536f1a6faf85b10c4326a8f64136333626a679d802a312e1fd6810fe5/pynvml_amd_windows-1.0.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 19:18:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sfinktah",
"github_project": "pynvml-amd-windows",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pynvml-amd-windows"
}
JSON
