# pyamdgpuinfo
AMD GPU information
## Install
`pip install pyamdgpuinfo`
Only Linux is supported, using the AMDGPU driver.
The library is written using Cython, meaning that Cython and and a C compiler are needed to build and install from source. Additionally, libdrm development headers are required.
Precompiled wheels for Python 3.8-3.12 are the default method of install. This means that you don't need Cython or any other dependencies to install it normally.
## Usage
Example:
```python
>>> import pyamdgpuinfo
>>> n_devices = pyamdgpuinfo.detect_gpus()
1 # we have 1 device present, so it'll be at index 0
>>> first_gpu = pyamdgpuinfo.get_gpu(0) # returns a GPUInfo object
>>> vram_usage = first_gpu.query_vram_usage()
>>> print(vram_usage)
3954978816 # number of bytes in use
```
All documentation is in the docstrings of each function/class.
Available functions are (see docstrings for more info):
* detect_gpus - Returns the number of GPUs available
* get_gpu - Returns a GPUInfo object for the device index specified
GPUInfo methods (see docstring for class overview)
* start_utilisation_polling - Starts polling GPU registers for utilisation statistics
* stop_utilisation_polling - Stops the utilisation polling thread
* query_utilisation - Queries utilisation of different GPU parts
* query_max_clocks - Queries max GPU clocks
* query_sclk - Queries shader (core) clock
* query_mclk - Queries memory clock
* query_vram_usage - Queries VRAM usage
* query_gtt_usage - Queries GTT usage
* query_temperature - Queries temperature
* query_load - Queries GPU load
* query_power - Queries power consumption
* query_northbridge_voltage - Queries northbridge voltage
* query_graphics_voltage - Queries graphics voltage
VRAM and GTT sizes are available as an attribute of GPUInfo.
## Mentions
Parts of this package were inspired by [radeontop](https://github.com/clbr/radeontop).
## License
GPLV3
Raw data
{
"_id": null,
"home_page": "https://github.com/mark9064/pyamdgpuinfo",
"name": "pyamdgpuinfo",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "mark9064",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/c4/d7/8b3d90db99726b17037e3df680f11cd8e1d85721f40799907ecef41cfe46/pyamdgpuinfo-2.1.6.tar.gz",
"platform": null,
"description": "# pyamdgpuinfo\n\nAMD GPU information\n\n## Install\n\n`pip install pyamdgpuinfo`\n\nOnly Linux is supported, using the AMDGPU driver.\n\nThe library is written using Cython, meaning that Cython and and a C compiler are needed to build and install from source. Additionally, libdrm development headers are required. \n\nPrecompiled wheels for Python 3.8-3.12 are the default method of install. This means that you don't need Cython or any other dependencies to install it normally.\n\n## Usage\n\nExample:\n```python\n>>> import pyamdgpuinfo\n>>> n_devices = pyamdgpuinfo.detect_gpus()\n1 # we have 1 device present, so it'll be at index 0\n>>> first_gpu = pyamdgpuinfo.get_gpu(0) # returns a GPUInfo object\n>>> vram_usage = first_gpu.query_vram_usage()\n>>> print(vram_usage)\n3954978816 # number of bytes in use\n```\n\nAll documentation is in the docstrings of each function/class.\n\nAvailable functions are (see docstrings for more info):\n* detect_gpus - Returns the number of GPUs available\n* get_gpu - Returns a GPUInfo object for the device index specified\n\n\nGPUInfo methods (see docstring for class overview)\n* start_utilisation_polling - Starts polling GPU registers for utilisation statistics\n* stop_utilisation_polling - Stops the utilisation polling thread\n* query_utilisation - Queries utilisation of different GPU parts\n* query_max_clocks - Queries max GPU clocks\n* query_sclk - Queries shader (core) clock\n* query_mclk - Queries memory clock\n* query_vram_usage - Queries VRAM usage\n* query_gtt_usage - Queries GTT usage\n* query_temperature - Queries temperature\n* query_load - Queries GPU load\n* query_power - Queries power consumption\n* query_northbridge_voltage - Queries northbridge voltage\n* query_graphics_voltage - Queries graphics voltage\n\n\nVRAM and GTT sizes are available as an attribute of GPUInfo.\n\n## Mentions\n\nParts of this package were inspired by [radeontop](https://github.com/clbr/radeontop).\n\n## License\n\nGPLV3\n",
"bugtrack_url": null,
"license": "",
"summary": "AMD GPU stats",
"version": "2.1.6",
"project_urls": {
"Homepage": "https://github.com/mark9064/pyamdgpuinfo"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "690e1f4fc1ef00a9a82f74745db3835eee965bb80681623f8a2eada17f198ee6",
"md5": "25b2515380962576838f4ae90127263f",
"sha256": "1f3d1f995b7d8e5e9ccd93d1a5db7994b720b8a86e34d4dafe3ab8debaef7ec9"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "25b2515380962576838f4ae90127263f",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.8",
"size": 352681,
"upload_time": "2023-10-11T23:04:36",
"upload_time_iso_8601": "2023-10-11T23:04:36.123805Z",
"url": "https://files.pythonhosted.org/packages/69/0e/1f4fc1ef00a9a82f74745db3835eee965bb80681623f8a2eada17f198ee6/pyamdgpuinfo-2.1.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "db45418669dc8b9255aadde2719d1ebcf5d2c0e0f876a51406eb520b198cdb19",
"md5": "bb78a908e64fad330b112a7f45279f3e",
"sha256": "6b6a02881d8569cafb55c1b767e8536462c909431ecc75b17ff995e469e87dac"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp310-cp310-musllinux_1_1_x86_64.whl",
"has_sig": false,
"md5_digest": "bb78a908e64fad330b112a7f45279f3e",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.8",
"size": 344824,
"upload_time": "2023-10-11T23:04:37",
"upload_time_iso_8601": "2023-10-11T23:04:37.805082Z",
"url": "https://files.pythonhosted.org/packages/db/45/418669dc8b9255aadde2719d1ebcf5d2c0e0f876a51406eb520b198cdb19/pyamdgpuinfo-2.1.6-cp310-cp310-musllinux_1_1_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ff034553b326fde39e2bdb54a46e1b6319994089a640f9c7d2dd82bf03ddb307",
"md5": "9efdca78b183958c658a84dfc80b587c",
"sha256": "5237cb0feaa8d15eaebe1ff03888c731a2890449e44c1187f0b4b7c868e19f1b"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "9efdca78b183958c658a84dfc80b587c",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.8",
"size": 365728,
"upload_time": "2023-10-11T23:04:39",
"upload_time_iso_8601": "2023-10-11T23:04:39.277520Z",
"url": "https://files.pythonhosted.org/packages/ff/03/4553b326fde39e2bdb54a46e1b6319994089a640f9c7d2dd82bf03ddb307/pyamdgpuinfo-2.1.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "47a55d09dbda0af3d797c0e354de8cfe266b4f250d8f6aa36e1561975baf455c",
"md5": "cdf8056aa41aa9f2a7d0ab6b2ca87106",
"sha256": "aff2d5dea9d4ade7bc387ccc77651992bae050c9f1e755ca72c1e36305f53d6f"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp311-cp311-musllinux_1_1_x86_64.whl",
"has_sig": false,
"md5_digest": "cdf8056aa41aa9f2a7d0ab6b2ca87106",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.8",
"size": 359525,
"upload_time": "2023-10-11T23:04:40",
"upload_time_iso_8601": "2023-10-11T23:04:40.879732Z",
"url": "https://files.pythonhosted.org/packages/47/a5/5d09dbda0af3d797c0e354de8cfe266b4f250d8f6aa36e1561975baf455c/pyamdgpuinfo-2.1.6-cp311-cp311-musllinux_1_1_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "83f4ee1c94c11fd42d96b2594d5cbe0f3bdf5ec07abc95828fd8298d48ad9a3e",
"md5": "21aa39dd68fd460f7a062bbc20e8296c",
"sha256": "7af5498986b1090f7ddbfb4cf960f223ead88761f24dbacb5079656daefbe99e"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "21aa39dd68fd460f7a062bbc20e8296c",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.8",
"size": 361656,
"upload_time": "2023-10-11T23:04:42",
"upload_time_iso_8601": "2023-10-11T23:04:42.492537Z",
"url": "https://files.pythonhosted.org/packages/83/f4/ee1c94c11fd42d96b2594d5cbe0f3bdf5ec07abc95828fd8298d48ad9a3e/pyamdgpuinfo-2.1.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c6fe577a8c79226f37ec145293d08cf004dae3f14b69d874d261813e8eafa610",
"md5": "64e4f52da832421f7e041ad67cc147d8",
"sha256": "c0653d359b26ec029df077189b7d91c126836abc0bd8713fef84ee46187131cb"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp312-cp312-musllinux_1_1_x86_64.whl",
"has_sig": false,
"md5_digest": "64e4f52da832421f7e041ad67cc147d8",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.8",
"size": 354337,
"upload_time": "2023-10-11T23:04:44",
"upload_time_iso_8601": "2023-10-11T23:04:44.182866Z",
"url": "https://files.pythonhosted.org/packages/c6/fe/577a8c79226f37ec145293d08cf004dae3f14b69d874d261813e8eafa610/pyamdgpuinfo-2.1.6-cp312-cp312-musllinux_1_1_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bc7ab1ddff945037f8970b5cb0ffe718618007a64d185f51aaf7d4686adf70e5",
"md5": "46529fe92198dd8d46a2a0048c0a6633",
"sha256": "cb18ffe03844c7e81f81b015d2522297bf846f286b582db9e5cf65ea8998156d"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "46529fe92198dd8d46a2a0048c0a6633",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 359950,
"upload_time": "2023-10-11T23:04:45",
"upload_time_iso_8601": "2023-10-11T23:04:45.793048Z",
"url": "https://files.pythonhosted.org/packages/bc/7a/b1ddff945037f8970b5cb0ffe718618007a64d185f51aaf7d4686adf70e5/pyamdgpuinfo-2.1.6-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0d26c19d70084e30fe19cf249190d0846e6c6152cdd2fb4db00008c695edaf05",
"md5": "676e132b04c7d0bb863076fff2ff0e54",
"sha256": "a9be390647e4673ec9b8f186b47865f230cd282f1f78afc9ecc8b8a82dc292a8"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp38-cp38-musllinux_1_1_x86_64.whl",
"has_sig": false,
"md5_digest": "676e132b04c7d0bb863076fff2ff0e54",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 367193,
"upload_time": "2023-10-11T23:04:47",
"upload_time_iso_8601": "2023-10-11T23:04:47.210502Z",
"url": "https://files.pythonhosted.org/packages/0d/26/c19d70084e30fe19cf249190d0846e6c6152cdd2fb4db00008c695edaf05/pyamdgpuinfo-2.1.6-cp38-cp38-musllinux_1_1_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ca7542d1494601b1052252b35b747ec35c06cc4762e6addcc39536b5382e5956",
"md5": "95ae347fa47f98ea433f393d6d69e373",
"sha256": "0ff4407893c8740b81ec91c11f69391ae2a0fc91b6a2a6c5897e6b127c546d86"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "95ae347fa47f98ea433f393d6d69e373",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.8",
"size": 355356,
"upload_time": "2023-10-11T23:04:48",
"upload_time_iso_8601": "2023-10-11T23:04:48.381648Z",
"url": "https://files.pythonhosted.org/packages/ca/75/42d1494601b1052252b35b747ec35c06cc4762e6addcc39536b5382e5956/pyamdgpuinfo-2.1.6-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "28c6fa39eedf83389320b89254c1d802df2f468ec6877c655985f723f3b9fb63",
"md5": "c355ee6f2b2c13d9485692e493b12759",
"sha256": "40b6057689c177f29c9556db1af3ed0e5b446c2214cefa26475e41be0b79b6a9"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-cp39-cp39-musllinux_1_1_x86_64.whl",
"has_sig": false,
"md5_digest": "c355ee6f2b2c13d9485692e493b12759",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.8",
"size": 347795,
"upload_time": "2023-10-11T23:04:49",
"upload_time_iso_8601": "2023-10-11T23:04:49.552041Z",
"url": "https://files.pythonhosted.org/packages/28/c6/fa39eedf83389320b89254c1d802df2f468ec6877c655985f723f3b9fb63/pyamdgpuinfo-2.1.6-cp39-cp39-musllinux_1_1_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6b382b447bd1920c02e9eb6d79e4af32d288536ca6f90f53b6c627e8657e4864",
"md5": "0b2ae527828fe906cad9f07e8c9d3708",
"sha256": "d3f5497c31a3a96b1a35c7277951c9d955807d84a5151abd76849b995b6a96b8"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "0b2ae527828fe906cad9f07e8c9d3708",
"packagetype": "bdist_wheel",
"python_version": "pp310",
"requires_python": ">=3.8",
"size": 115969,
"upload_time": "2023-10-11T23:04:51",
"upload_time_iso_8601": "2023-10-11T23:04:51.123082Z",
"url": "https://files.pythonhosted.org/packages/6b/38/2b447bd1920c02e9eb6d79e4af32d288536ca6f90f53b6c627e8657e4864/pyamdgpuinfo-2.1.6-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "549ce279f4388931eb024bf2c8311dde72f2c7f5d8792e54b65ec6e05963c023",
"md5": "c249c3247df5aba4b93a490f67ac9072",
"sha256": "5690bc2a6d779b0ba7654e643acb30bf310c6823d4c3bff31ae1399388f3a291"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "c249c3247df5aba4b93a490f67ac9072",
"packagetype": "bdist_wheel",
"python_version": "pp38",
"requires_python": ">=3.8",
"size": 115887,
"upload_time": "2023-10-11T23:04:52",
"upload_time_iso_8601": "2023-10-11T23:04:52.119720Z",
"url": "https://files.pythonhosted.org/packages/54/9c/e279f4388931eb024bf2c8311dde72f2c7f5d8792e54b65ec6e05963c023/pyamdgpuinfo-2.1.6-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9f8082e2461b06a2c5af7c9a12e97d2af8a3c6e77b03fb3e5928dca71a42dbf1",
"md5": "cda5e3f16cfff6752f34d78170882a7b",
"sha256": "df93adf2c990bd5aa6c197a0c0ddd81666ad865e70f8b13a7eec2f9f21699627"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "cda5e3f16cfff6752f34d78170882a7b",
"packagetype": "bdist_wheel",
"python_version": "pp39",
"requires_python": ">=3.8",
"size": 115982,
"upload_time": "2023-10-11T23:04:53",
"upload_time_iso_8601": "2023-10-11T23:04:53.581321Z",
"url": "https://files.pythonhosted.org/packages/9f/80/82e2461b06a2c5af7c9a12e97d2af8a3c6e77b03fb3e5928dca71a42dbf1/pyamdgpuinfo-2.1.6-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c4d78b3d90db99726b17037e3df680f11cd8e1d85721f40799907ecef41cfe46",
"md5": "a0f18001fb4ac12d35a4ae5bcad32dd6",
"sha256": "ca7146a0f82a570d7ee6f755c2922af9cf7e4adada1231ff50a8183bc86be468"
},
"downloads": -1,
"filename": "pyamdgpuinfo-2.1.6.tar.gz",
"has_sig": false,
"md5_digest": "a0f18001fb4ac12d35a4ae5bcad32dd6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 21868,
"upload_time": "2023-10-11T23:00:57",
"upload_time_iso_8601": "2023-10-11T23:00:57.423147Z",
"url": "https://files.pythonhosted.org/packages/c4/d7/8b3d90db99726b17037e3df680f11cd8e1d85721f40799907ecef41cfe46/pyamdgpuinfo-2.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-11 23:00:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mark9064",
"github_project": "pyamdgpuinfo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pyamdgpuinfo"
}