# intel-npu-top
A monitoring tool for Intel Meteor Lake NPU usage in real-time via sysfs on Linux, featuring ASCII-based visualization.
**Status:** Pre-alpha prototype — expect incomplete features, rough edges, and limited functionality.
## ⚠️ Important Warning
This is an experimental prototype and is **NOT PRODUCTION READY**. Use at your own risk and expect:
- Incomplete features
- Potential bugs
- Limited error handling
- Possible system-specific issues
## Requirements
- Linux system with Intel Meteor Lake NPU
- Python 3.6 or higher
- Access to NPU sysfs entries (usually requires root privileges)
## Features
* Real-time NPU usage monitoring with ASCII bar chart visualization
* Historical view of the last 40 samples
* Automatic screen refresh
* Docker container support
## Installation
### Standalone Script
Just copy the STANDALONE.py script to your system and run it with Python 3.
### From PyPI (Coming Soon)
### From Source
git clone https://github.com/DMontgomery40/intel-npu-top
cd intel-npu-top
python3 -m pip install .
### Using Docker
docker-compose up -d
## Usage
sudo intel-npu-top
Note: Root privileges are required to access the NPU sysfs entries.
## Acknowledgements
This project was inspired by and based on code from [ZoLArk173/nputop](https://github.com/ZoLArk173/nputop). Thanks for the inspiration and groundwork!
## License
MIT License - See LICENSE file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/DMontgomery40/intel-npu-top",
"name": "intel-npu-top",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "intel, npu, monitoring, top, meteor-lake",
"author": "David Montgomery",
"author_email": "dmontg@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/1b/06/4e3a72406d3193ff42fd25c4316a71e434563819deb834b85d900acf0382/intel_npu_top-0.1.0.tar.gz",
"platform": null,
"description": "# intel-npu-top \n\nA monitoring tool for Intel Meteor Lake NPU usage in real-time via sysfs on Linux, featuring ASCII-based visualization.\n\n**Status:** Pre-alpha prototype \u2014 expect incomplete features, rough edges, and limited functionality.\n\n## \u26a0\ufe0f Important Warning\n\nThis is an experimental prototype and is **NOT PRODUCTION READY**. Use at your own risk and expect:\n- Incomplete features\n- Potential bugs\n- Limited error handling\n- Possible system-specific issues\n\n## Requirements\n\n- Linux system with Intel Meteor Lake NPU\n- Python 3.6 or higher\n- Access to NPU sysfs entries (usually requires root privileges)\n\n## Features\n\n* Real-time NPU usage monitoring with ASCII bar chart visualization\n* Historical view of the last 40 samples\n* Automatic screen refresh\n* Docker container support\n\n## Installation\n\n### Standalone Script\n\nJust copy the STANDALONE.py script to your system and run it with Python 3.\n\n### From PyPI (Coming Soon)\n\n### From Source\n\ngit clone https://github.com/DMontgomery40/intel-npu-top\ncd intel-npu-top\npython3 -m pip install .\n\n### Using Docker\n\ndocker-compose up -d\n\n## Usage\n\nsudo intel-npu-top\n\nNote: Root privileges are required to access the NPU sysfs entries.\n\n## Acknowledgements\n\nThis project was inspired by and based on code from [ZoLArk173/nputop](https://github.com/ZoLArk173/nputop). Thanks for the inspiration and groundwork!\n\n## License\n\nMIT License - See LICENSE file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A monitoring tool for Intel Meteor Lake NPU usage in real-time",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/DMontgomery40/intel-npu-top/issues",
"Homepage": "https://github.com/DMontgomery40/intel-npu-top"
},
"split_keywords": [
"intel",
" npu",
" monitoring",
" top",
" meteor-lake"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "73da814e7023529c7c39f6ff6b8f9d02a5b8840bd8112ddfcd33aa074f44628c",
"md5": "dd4858e90d7ab482e1d627af87740280",
"sha256": "5a8cb46f4f732399ca428c3c33eb0027b3b2cb7ff9419344634db3edf54df468"
},
"downloads": -1,
"filename": "intel_npu_top-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dd4858e90d7ab482e1d627af87740280",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 2333,
"upload_time": "2024-12-17T00:12:32",
"upload_time_iso_8601": "2024-12-17T00:12:32.202155Z",
"url": "https://files.pythonhosted.org/packages/73/da/814e7023529c7c39f6ff6b8f9d02a5b8840bd8112ddfcd33aa074f44628c/intel_npu_top-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1b064e3a72406d3193ff42fd25c4316a71e434563819deb834b85d900acf0382",
"md5": "2ea4fa787eed846571a7497ad53614f7",
"sha256": "59f559cdaf9ae1cdb23907c1886aca1b11d80e44683956894b82e0b0142db1e6"
},
"downloads": -1,
"filename": "intel_npu_top-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "2ea4fa787eed846571a7497ad53614f7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 2560,
"upload_time": "2024-12-17T00:12:35",
"upload_time_iso_8601": "2024-12-17T00:12:35.521024Z",
"url": "https://files.pythonhosted.org/packages/1b/06/4e3a72406d3193ff42fd25c4316a71e434563819deb834b85d900acf0382/intel_npu_top-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-17 00:12:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DMontgomery40",
"github_project": "intel-npu-top",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "intel-npu-top"
}
JSON
