XuehaiPan/nvitop

这是什么？

核心功能

• 01交互式监控界面，支持柱状图、历史曲线、排序和进程过滤。
• 02树形视图同时展示 GPU 进程及其父进程。
• 03可在界面中向进程发送 SIGINT、SIGTERM 或 SIGKILL 信号。
• 04只读模式可禁用会改变进程状态的快捷键。
• 05nvisel 可按剩余显存、利用率和设备数量选择 CUDA 设备。
• 06提供设备与进程状态的 Python API，以及配有 Grafana 仪表盘的 Prometheus exporter。

适用场景

• 通过 SSH 查看实验室或集群服务器上共享 GPU 被哪些用户和进程占用。
• 在启动训练任务前，用 nvisel 为 CUDA_VISIBLE_DEVICES 选出空闲显卡。
• 借助 Python API 编写自定义 GPU 监控脚本或仪表盘。
• 将 GPU 指标接入 Prometheus 与 Grafana 做长期追踪。

快速上手

1. 1

   使用 uvx 安装并直接运行（无需永久安装）

   uvx nvitop
2. 2

   或从 PyPI 使用 pip 安装

   pip3 install --upgrade nvitop
3. 3

   或使用 pipx 运行

   pipx run nvitop

使用前须知

• !需要安装 NVIDIA GPU 及 NVML 库（驱动程序）。
• !监控模式需要支持 curses 的终端；在 Windows 上部分终端可能不支持鼠标。

标签

常见问题

nvitop 是什么？

面向 NVIDIA GPU 的交互式终端监控工具，可查看设备与进程状态，并附带 CUDA 设备选择工具和 Python API。 nvitop 是一个面向 NVIDIA GPU 的交互式进程查看器。它在显示每块卡的利用率、显存和温度的同时，列出运行在其上的 GPU 进程，并补充用户、CPU 和主机内存等系统侧信息。监控模式会持续刷新，支持排序、过滤、父进程树视图、环境变量查看，并可通过键盘或鼠标向进程发送信号。

nvitop 可以免费使用吗？用的什么许可证？

nvitop 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

nvitop 还在维护吗？

活跃维护中。nvitop 最近一次提交是在 2026年10月17日。

nvitop 适合用来做什么？

通过 SSH 查看实验室或集群服务器上共享 GPU 被哪些用户和进程占用。 在启动训练任务前，用 nvisel 为 CUDA_VISIBLE_DEVICES 选出空闲显卡。 借助 Python API 编写自定义 GPU 监控脚本或仪表盘。 将 GPU 指标接入 Prometheus 与 Grafana 做长期追踪。

nvitop 怎么安装和运行？

使用 uvx 安装并直接运行（无需永久安装）: uvx nvitop 或从 PyPI 使用 pip 安装: pip3 install --upgrade nvitop 或使用 pipx 运行: pipx run nvitop

在哪里获取 nvitop？

源代码和安装说明在 GitHub 上：https://github.com/XuehaiPan/nvitop