jetson-stats

jetson-stats is a package for monitoring and control your NVIDIA Jetson [Thor, 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

sudo apt update
sudo apt install python3-pip python3-setuptools -y

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

sudo pip3 install -U jetson-stats

Option 2: Install directly from GitHub

sudo pip3 install git+https://github.com/rbonghi/jetson_stats.git

Option 3: Ubuntu 24.04

sudo pip3 install --break-system-packages -U jetson-stats

or

sudo pip3 install --break-system-packages git+https://github.com/rbonghi/jetson_stats.git

Option 4: Run jtop with or without sudo, and install without --break-system-packages

This installation method works on all Jetson Developer Kits. NOTE: For Jetson AGX Thor Dev Kit follow this

sudo -v
curl -LsSf https://raw.githubusercontent.com/rbonghi/jetson_stats/master/scripts/install_jtop_torun_without_sudo.sh | bash

Upgrade jtop

sudo -v
curl -LsSf https://raw.githubusercontent.com/rbonghi/jetson_stats/master/scripts/upgrade-jtop.sh | bash

---

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.

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 👋