nputop：交互式 Ascend NPU 进程查看器（nvitop昇腾版）-优快云博客

nputop：交互式 Ascend NPU 进程查看器 🚀

项目链接：https://github.com/youyve/nputop
[该仓库创建于2024年12月9日]

nputop 是一个专为监控和管理运行在 Ascend NPU 上的进程设计的交互式命令行工具。受流行的 nvitop 项目的启发，nputop 为 Ascend NPU 生态系统带来了类似的直观用户体验，提供利用率、内存使用情况、温度、功耗等的实时洞察。

🌟 主要功能

实时监控：跟踪 NPU 使用率、内存状态、温度和功耗。
交互式界面：使用键盘/鼠标导航，轻松管理进程。
进程管理：直接查看、选择和交互运行中的 NPU 进程。
多 NPU 支持：同时高效管理多个 Ascend NPU。
命令行便利：最小化设置，轻松集成到终端工作流中。

📸 截图

有详细的实时昇腾硬件参数信息和进程信息在这里插入图片描述

⚙️ 安装

前置条件：

Python ≥ 3.9
Ascend NPU 驱动程序（Ascend NPU 驱动）

如果你使用的是 Conda，推荐通过 conda-forge 安装：

# 方式一：直接指定 conda-forge 频道安装
conda install -c conda-forge nputop

# 方式二（推荐）：将 conda-forge 设置为默认优先频道
conda config --add channels conda-forge
conda config --set channel_priority strict

# 然后安装
conda install nputop

或者，如果你喜欢使用 pip，可以直接从 PyPI 安装：

pip install ascend-nputop

如需开发或本地可编辑安装：

git clone https://github.com/youyve/nputop.git
cd nputop
pip install -e .

🚀 快速开始

直接从终端启动 nputop：

nputop

设置环境变量（ASCEND_RT_VISIBLE_DEVICES）以限制可见的 NPU。

🔑 使用方法与快捷键

切换屏幕：↑ ↓ or TAB
切换紧凑模式：C
终止进程：选择一个进程并按 K
手动刷新：R
退出：Q 或 Ctrl+C

🛠️ 项目结构

nputop
├── assets/             # 文档用图片
├── nputop/
│   ├── api/            # Ascend NPU API 和后端
│   ├── gui/            # 交互式界面（仅限 GPL-3.0）
│   ├── cli.py          # 命令行入口
│   └── version.py      # 版本和元数据
├── COPYING             # GPL-3.0 许可证文件
├── LICENSE             # Apache 2.0 许可证文件
├── NOTICE              # 致谢和声明
├── pyproject.toml      # 项目配置
├── setup.py            # 构建脚本
└── README.md           # 文档

📋 已知问题与路线图

🚧 对 Ascend 的支持有限：目前仅完全支持 Ascend 910 系列。
🚧 某些NPU指标的参数显示还不完整。

这些性能问题和功能差距正在持续开发中积极解决。热烈欢迎贡献以帮助改进 nputop。

🤝 贡献

我们热烈欢迎贡献！您可以：

通过 Issues 报告错误或请求功能。
Fork 仓库并提交拉取请求。
改进文档和示例。

📃 许可证

本项目（nputop）衍生自原始项目 nvitop，作者为薛海攀。

适用的许可证为：

API 模块：Apache 许可证 2.0
GUI 模块：GNU 通用公共许可证 v3.0 仅限

版权所有 (c) 2025 XuehaiPan <XuehaiPan@pku.edu.cn>
版权所有 (c) 2025 Lianzhong You <youlianzhong@gml.ac.cn>

详情请见 LICENSE、COPYING 和 NOTICE。

使用 nputop 愉快地监控您的 Ascend NPU！🎉