<h1 align="center">
<b>jetson-stats</b>
[](https://rnext.it/jetson_stats/)
</h1>
<p align="center">
<a href="https://pypistats.org/packages/jetson-stats"><img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dw/jetson-stats.svg" /></a>
<a href="https://badge.fury.io/py/jetson-stats"><img alt="PyPI version" src="https://badge.fury.io/py/jetson-stats.svg" /></a>
<a href="https://www.python.org/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/jetson-stats.svg" /></a>
<a href="https://pypi.org/project/jetson-stats/"><img alt="PyPI - Format" src="https://img.shields.io/pypi/format/jetson-stats.svg" /></a>
<a href="/LICENSE"><img alt="GitHub" src="https://img.shields.io/github/license/rbonghi/jetson_stats" /></a>
<a href="https://snyk.io/advisor/python/jetson-stats"><img alt="jetson-stats" src="https://snyk.io/advisor/python/jetson-stats/badge.svg" /></a>
<a href="https://hub.docker.com/r/rbonghi/jetson_stats"><img alt="Docker Image Size (tag)" src="https://img.shields.io/docker/image-size/rbonghi/jetson_stats/latest"></a>
<a href="https://hub.docker.com/r/rbonghi/jetson_stats"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/rbonghi/jetson_stats" /></a>
<a href="https://github.com/rbonghi/jetson_stats/actions?query=workflow%3A%22CI+%26+CD%22"><img alt="CI & CD" src="https://github.com/rbonghi/jetson_stats/workflows/CI%20&%20CD/badge.svg" /></a>
<a href="https://github.com/rbonghi/jetson_stats/actions/workflows/github-code-scanning/codeql"><img alt="CodeQL" src="https://github.com/rbonghi/jetson_stats/actions/workflows/github-code-scanning/codeql/badge.svg?branch=master" /></a>
</p>
<p align="center">
<a href="https://twitter.com/raffaello86"><img alt="Twitter Follow" src="https://img.shields.io/badge/Follow-%40raffaello86-1DA1F2?logo=twitter&style=social" /></a>
<a href="https://www.instagram.com/robo.panther/"><img alt="robo.panther" src="https://img.shields.io/badge/Follow-robo.panther-E4405F?style=social&logo=instagram" /></a>
<a href="https://discord.gg/BFbuJNhYzS"><img alt="Join our Discord" src="https://img.shields.io/discord/1060563771048861817?color=%237289da&label=discord" /></a>
</p>
**jetson-stats** is a package for **monitoring** and **control** your [NVIDIA Jetson](https://developer.nvidia.com/buy-jetson) [Orin, Xavier, Nano, TX] series.
jetson-stats is a powerful tool to analyze your board, you can use with a stand alone application with `jtop` or import in your python script, the main features are:
- Decode hardware, architecture, L4T and NVIDIA Jetpack
- Monitoring, CPU, GPU, Memory, Engines, fan
- Control NVP model, fan speed, jetson_clocks
- Importable in a python script
- Dockerizable in a container
- Do not need super user
- Tested on many different hardware configurations
- Works with all NVIDIA Jetpack
## Install
jetson-stats can be installed with [pip](https://pip.pypa.io), but need **superuser**:
```console
sudo pip3 install -U jetson-stats
```
_Don't forget to **logout/login** or **reboot** your board_
<div align="center">
**🚀 That's it! 🚀**
</div>
## Run
Start jtop it's pretty simple just write `jtop`!
```console
jtop
```
A simple interface will appear on your terminal, more capabilities are documented at [_jtop_](https://rnext.it/jetson_stats/jtop/jtop.html) page.
<div align="center">
[](https://github.com/rbonghi/jetson_stats)
</div>
## Library
You can use jtop such a python library to integrate in your software
```python
from jtop import jtop
with jtop() as jetson:
# jetson.ok() will provide the proper update frequency
while jetson.ok():
# Read tegra stats
print(jetson.stats)
```
You can also use jtop with your _virualenv_!
More information available at [_advanced usage_](https://rnext.it/jetson_stats/advanced-usage.html) page.
## Docker
You can run directly in Docker jtop, you need only to:
1. Install jetson-stats on your **host**
2. Install jetson-stats on your container as well
3. Pass to your container `/run/jtop.sock:/run/jtop.sock`
You can try running this command
```console
docker run --rm -it -v /run/jtop.sock:/run/jtop.sock rbonghi/jetson_stats:latest
```
More information available at [_docker_](https://rnext.it/jetson_stats/docker.html) documentation page.
## Sponsorship
If your company benefits from this library, please consider [💖 sponsoring its development](https://github.com/sponsors/rbonghi).
## Documentation
jetson-stats has usage and reference documentation at <https://rnext.it/jetson_stats>, there is also a [🆘 troubleshooting](https://rnext.it/jetson_stats/troubleshooting.html) page.
## Community
jetson-stats has a [community Discord channel](https://discord.gg/BFbuJNhYzS) for asking questions and collaborating with other contributors. Drop by and say hello 👋
Raw data
{
"_id": null,
"home_page": "https://rnext.it/jetson_stats",
"name": "jetson-stats",
"maintainer": null,
"docs_url": null,
"requires_python": ">=2.7",
"maintainer_email": null,
"keywords": "jetson_stats jtop python system-monitor docker nvidia Jetson Orin AGXOrin Xavier AGXXavier XavierNX Nano TX1 TX2 process viewer",
"author": "Raffaello Bonghi",
"author_email": "raffaello@rnext.it",
"download_url": "https://files.pythonhosted.org/packages/3e/94/7488cd901c204e4204d2f9410a220f904f9d9a395a39b46bdf6632ee1504/jetson-stats-4.3.0.tar.gz",
"platform": "linux",
"description": "<h1 align=\"center\">\n\n<b>jetson-stats</b>\n\n[](https://rnext.it/jetson_stats/)\n\n</h1>\n\n<p align=\"center\">\n <a href=\"https://pypistats.org/packages/jetson-stats\"><img alt=\"PyPI - Downloads\" src=\"https://img.shields.io/pypi/dw/jetson-stats.svg\" /></a>\n <a href=\"https://badge.fury.io/py/jetson-stats\"><img alt=\"PyPI version\" src=\"https://badge.fury.io/py/jetson-stats.svg\" /></a>\n <a href=\"https://www.python.org/\"><img alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/jetson-stats.svg\" /></a>\n <a href=\"https://pypi.org/project/jetson-stats/\"><img alt=\"PyPI - Format\" src=\"https://img.shields.io/pypi/format/jetson-stats.svg\" /></a>\n <a href=\"/LICENSE\"><img alt=\"GitHub\" src=\"https://img.shields.io/github/license/rbonghi/jetson_stats\" /></a>\n <a href=\"https://snyk.io/advisor/python/jetson-stats\"><img alt=\"jetson-stats\" src=\"https://snyk.io/advisor/python/jetson-stats/badge.svg\" /></a>\n <a href=\"https://hub.docker.com/r/rbonghi/jetson_stats\"><img alt=\"Docker Image Size (tag)\" src=\"https://img.shields.io/docker/image-size/rbonghi/jetson_stats/latest\"></a>\n <a href=\"https://hub.docker.com/r/rbonghi/jetson_stats\"><img alt=\"Docker Pulls\" src=\"https://img.shields.io/docker/pulls/rbonghi/jetson_stats\" /></a>\n <a href=\"https://github.com/rbonghi/jetson_stats/actions?query=workflow%3A%22CI+%26+CD%22\"><img alt=\"CI & CD\" src=\"https://github.com/rbonghi/jetson_stats/workflows/CI%20&%20CD/badge.svg\" /></a>\n <a href=\"https://github.com/rbonghi/jetson_stats/actions/workflows/github-code-scanning/codeql\"><img alt=\"CodeQL\" src=\"https://github.com/rbonghi/jetson_stats/actions/workflows/github-code-scanning/codeql/badge.svg?branch=master\" /></a>\n</p>\n<p align=\"center\">\n <a href=\"https://twitter.com/raffaello86\"><img alt=\"Twitter Follow\" src=\"https://img.shields.io/badge/Follow-%40raffaello86-1DA1F2?logo=twitter&style=social\" /></a>\n <a href=\"https://www.instagram.com/robo.panther/\"><img alt=\"robo.panther\" src=\"https://img.shields.io/badge/Follow-robo.panther-E4405F?style=social&logo=instagram\" /></a>\n <a href=\"https://discord.gg/BFbuJNhYzS\"><img alt=\"Join our Discord\" src=\"https://img.shields.io/discord/1060563771048861817?color=%237289da&label=discord\" /></a>\n</p>\n\n**jetson-stats** is a package for **monitoring** and **control** your [NVIDIA Jetson](https://developer.nvidia.com/buy-jetson) [Orin, Xavier, Nano, TX] series.\n\njetson-stats is a powerful tool to analyze your board, you can use with a stand alone application with `jtop` or import in your python script, the main features are:\n\n- Decode hardware, architecture, L4T and NVIDIA Jetpack\n- Monitoring, CPU, GPU, Memory, Engines, fan\n- Control NVP model, fan speed, jetson_clocks\n- Importable in a python script\n- Dockerizable in a container\n- Do not need super user\n- Tested on many different hardware configurations\n- Works with all NVIDIA Jetpack\n\n## Install\n\njetson-stats can be installed with [pip](https://pip.pypa.io), but need **superuser**:\n\n```console\nsudo pip3 install -U jetson-stats\n```\n\n_Don't forget to **logout/login** or **reboot** your board_\n\n<div align=\"center\">\n\n**\ud83d\ude80 That's it! \ud83d\ude80**\n\n</div>\n\n## Run\n\nStart jtop it's pretty simple just write `jtop`!\n\n```console\njtop\n```\n\nA simple interface will appear on your terminal, more capabilities are documented at [_jtop_](https://rnext.it/jetson_stats/jtop/jtop.html) page.\n\n<div align=\"center\">\n\n[](https://github.com/rbonghi/jetson_stats)\n\n</div>\n\n## Library\n\nYou can use jtop such a python library to integrate in your software\n\n```python\nfrom jtop import jtop\n\nwith jtop() as jetson:\n # jetson.ok() will provide the proper update frequency\n while jetson.ok():\n # Read tegra stats\n print(jetson.stats)\n```\n\nYou can also use jtop with your _virualenv_!\n\nMore information available at [_advanced usage_](https://rnext.it/jetson_stats/advanced-usage.html) page.\n\n## Docker\n\nYou can run directly in Docker jtop, you need only to:\n\n1. Install jetson-stats on your **host**\n2. Install jetson-stats on your container as well\n3. Pass to your container `/run/jtop.sock:/run/jtop.sock`\n\nYou can try running this command\n\n```console\ndocker run --rm -it -v /run/jtop.sock:/run/jtop.sock rbonghi/jetson_stats:latest\n```\n\nMore information available at [_docker_](https://rnext.it/jetson_stats/docker.html) documentation page.\n\n## Sponsorship\n\nIf your company benefits from this library, please consider [\ud83d\udc96 sponsoring its development](https://github.com/sponsors/rbonghi).\n\n## Documentation\n\njetson-stats has usage and reference documentation at <https://rnext.it/jetson_stats>, there is also a [\ud83c\udd98 troubleshooting](https://rnext.it/jetson_stats/troubleshooting.html) page.\n\n## Community\n\njetson-stats has a [community Discord channel](https://discord.gg/BFbuJNhYzS) for asking questions and collaborating with other contributors. Drop by and say hello \ud83d\udc4b\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "Interactive system-monitor and process viewer for all NVIDIA Jetson [Orin, Xavier, Nano, TX] series",
"version": "4.3.0",
"project_urls": {
"Documentation": "https://rnext.it/jetson_stats",
"Examples": "https://github.com/rbonghi/jetson_stats/tree/master/examples",
"Funding": "https://github.com/sponsors/rbonghi",
"Homepage": "https://rnext.it/jetson_stats",
"Say Thanks!": "https://discord.gg/BFbuJNhYzS",
"Source": "https://github.com/rbonghi/jetson_stats",
"Tracker": "https://github.com/rbonghi/jetson_stats/issues"
},
"split_keywords": [
"jetson_stats",
"jtop",
"python",
"system-monitor",
"docker",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"nvidia",
"jetson",
"orin",
"agxorin",
"xavier",
"agxxavier",
"xaviernx",
"nano",
"tx1",
"tx2",
"process",
"viewer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3e947488cd901c204e4204d2f9410a220f904f9d9a395a39b46bdf6632ee1504",
"md5": "b2f6eb198243852d8cd25cf9f64c27a0",
"sha256": "2fbc1b2d59b3d10ad307945021d0e176cc84c1d9a867a41da859ca0d24f5e21e"
},
"downloads": -1,
"filename": "jetson-stats-4.3.0.tar.gz",
"has_sig": false,
"md5_digest": "b2f6eb198243852d8cd25cf9f64c27a0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7",
"size": 118383,
"upload_time": "2024-12-18T21:52:37",
"upload_time_iso_8601": "2024-12-18T21:52:37.516486Z",
"url": "https://files.pythonhosted.org/packages/3e/94/7488cd901c204e4204d2f9410a220f904f9d9a395a39b46bdf6632ee1504/jetson-stats-4.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 21:52:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rbonghi",
"github_project": "jetson_stats",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "smbus2",
"specs": []
},
{
"name": "distro",
"specs": []
}
],
"tox": true,
"lcname": "jetson-stats"
}
JSON
