安装需要 superuser 权限;Ubuntu 24.04 需加 --break-system-packages 参数;在 Docker 中运行需宿主机和容器都安装 jetson-stats 并挂载 /run/jtop.sock

jetson_stats
rbonghiAGPL-3.0活跃维护在 NVIDIA Jetson 系列开发板上实时查看 CPU、GPU、内存和功耗状态,还能直接调整风扇与功耗模式,省去手动翻 sysfs 的麻烦。
📊 Simple package for monitoring and control your NVIDIA Jetson [Orin, Xavier, Nano, TX] series
sudo apt update && sudo apt install python3-pip python3-setuptools -y
sudo pip3 install -U jetson-stats
jtop面向 NVIDIA Jetson Thor、Orin、Xavier、Nano、TX 系列开发板,README 未给出具体显存或内存要求
在 NVIDIA Jetson 上监控和控制板卡状态的工具,提供终端界面 jtop 和可导入的 Python 库
在 NVIDIA Jetson 系列开发板上实时查看 CPU、GPU、内存和功耗状态,还能直接调整风扇与功耗模式,省去手动翻 sysfs 的麻烦。
核心能力
- 用 jtop 终端界面实时查看 CPU、GPU、内存、引擎和风扇状态
- 解析硬件型号、架构、L4T 与 NVIDIA Jetpack 版本
- 控制 NVP 功耗模式、风扇转速和 jetson_clocks
- 可作为 Python 库导入脚本,读取 jetson.stats 数据
- 支持在 Docker 容器内运行,通过挂载 jtop.sock 通信
容易踩的坑
- 7.2.2最新正式版2026-10-01 · 2026-10-01 09:11 UTC
What's Changed
- Add SYSFS diagnostics page by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/905
- Thor VIC actmon load, SYSFS polish, side-effect Orin ENGINE crash fix by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/908
- feat(thor,psysfs): pynvml per-block codec utilization panel by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/909
- Jetpack Release 7.2.2 by @SichenLiang in https://github.com/rbonghi/jetson_stats/pull/911
- build(deps): bump docker/build-push-action from 7.3.0 to 7.4.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/912
- Fix jtop_env.sh Python detection by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/914
- fix(ci): restore lint and Jetpack release validation by @johnnynunez in https://github.com/rbonghi/jetson_stats/pull/915
New Contributors
- @SichenLiang made their first contribution in https://github.com/rbonghi/jetson_stats/pull/911
Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.2.1...7.2.2
- 7.2.12026-08-09 · 2026-08-09 08:40 UTC
查看更新说明
What's Changed
- build(deps): bump actions/setup-python from 6 to 7 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/890
- Fix typo: 'architecure' -> 'architecture' by @fazalpsinfo-cmyk in https://github.com/rbonghi/jetson_stats/pull/891
- Fix GPU usage stuck at 0 on JetPack 7.x Orin (early-boot NVML latch) by @hholtmann in https://github.com/rbonghi/jetson_stats/pull/889
- build(deps): bump docker/login-action from 4.4.0 to 4.5.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/892
- build(deps): bump docker/login-action from 4.5.0 to 4.5.1 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/893
- build(deps): bump docker/login-action from 4.5.1 to 4.5.2 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/898
- build(deps): bump docker/login-action from 4.5.2 to 4.6.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/899
- fix: parse GR3D_FREQ utilization+array form on JetPack 7 Orin by @alansrobotlab2 in https://github.com/rbonghi/jetson_stats/pull/894
- feat(7INFO): add static CPU section to 7INFO page by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/895
- fix(3CPU): add blank separator row between Frq and next CPU block by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/896
- fix(sensor): add space between device name and label for hwmon sensors by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/897
- fix(power): add INA238 VIN support and skip UCSI supplies by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/900
- Jetpack Release 7.2.1 by @aquanjsw in https://github.com/rbonghi/jetson_stats/pull/901
New Contributors
- @fazalpsinfo-cmyk made their first contribution in https://github.com/rbonghi/jetson_stats/pull/891
- @hholtmann made their first contribution in https://github.com/rbonghi/jetson_stats/pull/889
- @alansrobotlab2 made their first contribution in https://github.com/rbonghi/jetson_stats/pull/894
- @aquanjsw made their first contribution in https://github.com/rbonghi/jetson_stats/pull/901
Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.2.0...7.2.1
- 7.2.02026-07-14 · 2026-07-14 17:08 UTC
查看更新说明
What's Changed
- feat: add Jetson Thor fan discovery for split PWM/RPM hwmon pairing by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/837
- build(deps): bump docker/login-action from 4.0.0 to 4.1.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/841
- build(deps): bump actions/github-script from 8 to 9 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/844
- build(deps): bump docker/build-push-action from 7.0.0 to 7.1.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/843
- feat: Thor GPU process table and VRAM chart via pynvml by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/852
- feat(scripts): add uv-based jtop upgrade script for jtop / jetson-stats. by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/853
- Handle old python3/pip3 versions and PATH variations in pip uninstall… by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/854
- build(deps): bump docker/build-push-action from 7.1.0 to 7.2.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/857
- build(deps): bump docker/login-action from 4.1.0 to 4.2.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/858
- Fix Thor Engines 5ENG to display values by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/861
- Feature add on Thor 2GPU to display Compute/Graphic process type by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/865
- Fix static GPU controls on JetPack 7.2 for Orin by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/867
- add backstop to close() method in JTopServer shutdown by @andrew-noble in https://github.com/rbonghi/jetson_stats/pull/868
- fix upgrade-jtop.sh: handle root-owned pycache from sudo jtop runs by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/869
- build(deps): bump actions/checkout from 6 to 7 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/871
- build(deps): bump docker/build-push-action from 7.2.0 to 7.3.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/882
- build(deps): bump docker/login-action from 4.2.0 to 4.3.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/883
- build(deps): bump docker/login-action from 4.3.0 to 4.4.0 by @dependabot[bot] in https://github.com/rbonghi/jetson_stats/pull/884
- engine: treat non-zero clk_rate as online; expose PVA0_VPS on Orin Thor by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/881
- fix(gui): show all sensors on 6CTRL in short SSH terminals by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/879
- sensors: prefix hwmon sensor labels with device name by @whitesscott in https://github.com/rbonghi/jetson_stats/pull/878
- fix(jetson_clocks): handle non-zero exit from
jetson_clocks --showby @whitesscott in https://github.com/rbonghi/jetson_stats/pull/877
New Contributors
- @andrew-noble made their first contribution in https://github.com/rbonghi/jetson_stats/pull/868
Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.1.5...7.2.0
- 7.1.52026-03-24 · 2026-03-24 22:23 UTC
查看更新说明
Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.1.4...7.1.5
- 7.1.42026-03-24 · 2026-03-24 09:52 UTC
查看更新说明
Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.1.2...7.1.4
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
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:
- Install jetson-stats on your host
- Install jetson-stats on your container as well
- 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 👋

