jetson_stats

rbonghiAGPL-3.0活跃维护

在 NVIDIA Jetson 系列开发板上实时查看 CPU、GPU、内存和功耗状态,还能直接调整风扇与功耗模式,省去手动翻 sysfs 的麻烦。

📊 Simple package for monitoring and control your NVIDIA Jetson [Orin, Xavier, Nano, TX] series

7.2.2发布于 2026-10-01 09:11 UTC2,634star331fork同步于 2026-11-10 23:44 UTC

怎么上手

由 README 提炼,执行前请确认
sudo apt update && sudo apt install python3-pip python3-setuptools -y
sudo pip3 install -U jetson-stats
jtop
硬件要求按 README 说明

面向 NVIDIA Jetson Thor、Orin、Xavier、Nano、TX 系列开发板,README 未给出具体显存或内存要求

有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 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 通信

容易踩的坑

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

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本7.2.2
  1. 7.2.2最新正式版2026-10-01 · 2026-10-01 09:11 UTC

    What's Changed

    New Contributors

    Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.2.1...7.2.2

  2. 7.2.12026-08-09 · 2026-08-09 08:40 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.2.0...7.2.1

  3. 7.2.02026-07-14 · 2026-07-14 17:08 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/rbonghi/jetson_stats/compare/7.1.5...7.2.0

  4. 7.1.52026-03-24 · 2026-03-24 22:23 UTC
    查看更新说明
  5. 7.1.42026-03-24 · 2026-03-24 09:52 UTC
    查看更新说明

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    jetson-stats

    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.

    jtop

    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 👋