Home

Awesome

<h1 align="center">

<b>jetson-stats</b>

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 [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:

Install

jetson-stats can be installed with pip, but need superuser:

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!

jtop

A simple interface will appear on your terminal, more capabilities are documented at jtop page.

<div align="center">

jtop

</div>

Library

You can use jtop such a python library to integrate in your software

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 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

docker run --rm -it -v /run/jtop.sock:/run/jtop.sock rbonghi/jetson_stats:latest

More information available at docker documentation page.

Sponsorship

If your company benefits from this library, please consider 💖 sponsoring its development.

Documentation

jetson-stats has usage and reference documentation at https://rnext.it/jetson_stats, there is also a 🆘 troubleshooting page.

Community

jetson-stats has a community Discord channel for asking questions and collaborating with other contributors. Drop by and say hello 👋