# 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/96/61/8a253d8c06ee4cb933064f382f336b0c8f974264472d03de96cfb0a18b8b/intel_npu_top-0.2.1.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.2.1",
"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": "afa1a2b0a20db748f6d4a96830c6e26a661aa288d48dfdc122dd356f8130493b",
"md5": "fa66837f615d5e7012dc371dbd3ac87f",
"sha256": "1622fc6f7bc0a77ec2c42ce6075f427b8640ab3c745187d85732e4418cc4f3b3"
},
"downloads": -1,
"filename": "intel_npu_top-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fa66837f615d5e7012dc371dbd3ac87f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 2333,
"upload_time": "2024-12-26T23:45:36",
"upload_time_iso_8601": "2024-12-26T23:45:36.786089Z",
"url": "https://files.pythonhosted.org/packages/af/a1/a2b0a20db748f6d4a96830c6e26a661aa288d48dfdc122dd356f8130493b/intel_npu_top-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "96618a253d8c06ee4cb933064f382f336b0c8f974264472d03de96cfb0a18b8b",
"md5": "041491ea231fde39e374a8c8dba46ae5",
"sha256": "3cc1b95ed1a192e0d66d53b6d69f15f72d7228073a0a05ea1015ec27d5010813"
},
"downloads": -1,
"filename": "intel_npu_top-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "041491ea231fde39e374a8c8dba46ae5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 2537,
"upload_time": "2024-12-26T23:45:38",
"upload_time_iso_8601": "2024-12-26T23:45:38.987231Z",
"url": "https://files.pythonhosted.org/packages/96/61/8a253d8c06ee4cb933064f382f336b0c8f974264472d03de96cfb0a18b8b/intel_npu_top-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-26 23:45:38",
"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
