XuehaiPan/nvitop

これは何？

主な機能

• 01棒グラフや履歴グラフを備えた対話型モニター。ソートやプロセスのフィルタリングにも対応。
• 02GPUプロセスを親プロセスとあわせて表示するツリービュー。
• 03インターフェースからプロセスにSIGINT、SIGTERM、SIGKILLを送信。
• 04読み取り専用モードでは、プロセスを変更するショートカットを無効化。
• 05空きメモリ、使用率、デバイス数に基づいてCUDAデバイスを選択するnvisel。
• 06デバイスとプロセスの状態を取得するPython APIに加え、Prometheus exporterとGrafanaダッシュボードを提供。

ユースケース

• SSH経由でラボやクラスタのサーバーに接続し、共有GPUを使用しているユーザーやプロセスを確認する。
• ジョブの起動前にCUDA_VISIBLE_DEVICESを設定し、学習ジョブに使う空きGPUを選ぶ。
• Python APIを使って、独自のGPU監視スクリプトやダッシュボードを構築する。
• GPUメトリクスをPrometheusとGrafanaに取り込み、長期的に追跡する。

クイックスタート

1. 1

   uvxでインストール（恒久的なインストールは不要）

   uvx nvitop
2. 2

   またはpipでPyPIからインストール

   pip3 install --upgrade nvitop
3. 3

   またはpipxで実行

   pipx run nvitop

使う前に知っておきたいこと

• !NVMLライブラリ（ドライバー）がインストールされたNVIDIA GPUが必要です。
• !モニターモードにはcursesに対応したターミナルが必要です。Windowsでは、一部のターミナルでマウスを利用できない場合があります。

トピック

よくある質問

nvitop とは？

GPUやプロセスごとの状態を表示するNVIDIA GPU向け対話型ターミナルモニター。CLIでのデバイス選択とPython APIも備える。 nvitopはNVIDIA GPU向けの対話型プロセスビューアーです。デバイスごとの使用率、メモリ使用量、温度と、各GPUで実行中のプロセスを表示し、ユーザー名、CPU、ホストメモリなど、ホスト側の情報も確認できます。モニターモードでは継続的に画面を更新し、ソート、フィルタリング、親プロセスを含むツリービュー、環境変数の確認に対応しています。また、キーボードやマウスからプロセスにシグナルを送信できます。

nvitop は無料で使えますか？ライセンスは？

nvitop は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

nvitop は今もメンテナンスされていますか？

活発にメンテナンス中。nvitop の最終コミットは 2026年10月17日 です。

nvitop は何に使えますか？

SSH経由でラボやクラスタのサーバーに接続し、共有GPUを使用しているユーザーやプロセスを確認する。 ジョブの起動前にCUDA_VISIBLE_DEVICESを設定し、学習ジョブに使う空きGPUを選ぶ。 Python APIを使って、独自のGPU監視スクリプトやダッシュボードを構築する。 GPUメトリクスをPrometheusとGrafanaに取り込み、長期的に追跡する。

nvitop のインストール方法は？

uvxでインストール（恒久的なインストールは不要）: uvx nvitop またはpipでPyPIからインストール: pip3 install --upgrade nvitop またはpipxで実行: pipx run nvitop

nvitop はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/XuehaiPan/nvitop