Welcome to jetson-stats’s documentation!

Indices and tables

Jetson stats

PyPI - Downloads PyPI version PyPI - Python Version PyPI - Format CI & CD

jetson-stats is a package for monitoring and control your NVIDIA Jetson [Xavier NX, Nano, AGX Xavier, TX1, TX2] Works with all NVIDIA Jetson ecosystem.

:sparkling_heart: **Sponsor** jetson-stats

When you install jetson-stats are included:

Read the Wiki for more detailed information or read the package documentation.


sudo -H pip install -U jetson-stats

🚀 That’s it! 🚀

PS: Don’t forget to **reboot* your board*

**You can run jtop in your python script read here**

Virtual environment

If you need to install in a virtual environment like virtualenv, you must install before in your host and after in your environment, like:

virtualenv venv
source venv/bin/activate
pip install -U jetson-stats


It is a system monitoring utility that runs on the terminal and see and control realtime the status of your NVIDIA Jetson. CPU, RAM, GPU status and frequency and other…

The prompt interface will be show like this image, now clickable!:


You can run the jtop simple using a simple command jtop

YES! Sudo is not more required!

nvidia@jetson-xavier-nx:~/$ jtop

Other options are available with -h option:

nvidia@jetson-xavier-nx:~/$ jtop -h
usage: jtop [-h] [--no-warnings] [--restore] [--loop] [-r REFRESH] [-p PAGE]

jtop is system monitoring utility and runs on terminal

optional arguments:
  -h, --help            show this help message and exit
  --no-warnings         Do not show warnings (default: False)
  --restore             Reset Jetson configuration (default: False)
  --loop                Automatically switch page every 5s (default: False)
  -r REFRESH, --refresh REFRESH
                        refresh interval (default: 500)
  -p PAGE, --page PAGE  Open fix page (default: 1)
  -v, --version         show program's version number and exit

You can change page using left, right arrow or TAB to change page.


jtop have four different pages to control your NVIDIA Jetson:

  1. ALL Are collected all information about your board: CPUs status, Memory, GPU, disk, fan and all status about jetson_clocks, NVPmodel and other

  2. GPU A real time GPU history about your NVIDIA Jetson

  3. CPU A real time CPU plot of NVIDIA Jetson

  4. MEM A real time Memory chart and swap monitor

  5. CTRL Enable/Disable jetson_clocks, nvpmodel or fan directly from here

  6. INFO All information about libraries, CUDA, Serial Number, interfaces, … ## Controls To control the your NVIDIA Jetson are available this keyboard commands:

In page 4 MEM:

  • c Clear cache

  • s Enable/Disable extra swap

  • + and - Increase and decrease swap size

In page 5 CTRL:

  • a Start/Stop jetson_clocks service (Note: jetson_clocks start only after 60s from up time)

  • e Enable/Disable jetson_clocks on board boot

  • + and - Increase and decrease the NVPmodel

  • f Manual/jetson_clocks mode for your fan

  • p and m Increase and decrease the Fan speed


Check jetson-stats health, enable/disable desktop, enable/disable jetson_clocks, improve the performance of your wifi are available only in one click using jetson_config



The command show the status and all information about your NVIDIA Jetson



Simple manager to switch on and switch off a swapfile in your jetson.

nvidia@jetson-nano:~/$ sudo jetson_swap -h
usage: createSwapFile [[[-d directory ] [-s size] -a] | [-h] | [--off]]
  -d | --dir    <directoryname> Directory to place swapfile
  -n | --name   <swapname> Name swap file
  -s | --size   <gigabytes>
  -a | --auto   Enable swap on boot in /etc/fstab
  -t | --status Check if the swap is currently active
  --off         Switch off the swap
  -h | --help   This message

jetson variables

When you install jetson-stats in your bash will be available a list of new environment variables to know which which hardware version is available are you working, which Jetpack is installed and other variable show below