wookayin/gpustat

O que é?

Recursos principais

• 01Mostra o nome da GPU, a temperatura, a utilização e o uso de memória em uma linha por dispositivo.
• 02Lista os processos em cada GPU, com usuário, PID e uso de memória.
• 03Oferece suporte a backends NVIDIA (NVML), AMD (ROCm SMI) e Huawei Ascend 910B.
• 04Disponibiliza um modo de monitoramento que atualiza a saída em um intervalo escolhido.
• 05Oferece saída em JSON e uma API Python para uso em scripts.

Casos de uso

• Verificar quais GPUs de uma estação de trabalho ou servidor compartilhado estão livres antes de iniciar um treinamento.
• Acompanhar a memória e a utilização da GPU durante o treinamento de um modelo de longa duração.
• Coletar métricas de GPU em JSON em scripts de monitoramento.
• Consultar o status da GPU por SSH em um formato rápido e legível.

Início rápido

1. 1

   Instale o gpustat pelo PyPI

   pip install gpustat
2. 2

   Se você tiver GPUs NVIDIA, instale a vinculação oficial de NVML da NVIDIA (não o pynvml)

   pip install nvidia-ml-py
3. 3

   Execute o gpustat para mostrar o status da GPU

   gpustat

Antes de usar

• !GPUs NVIDIA exigem um driver NVIDIA (versão 450.00 ou superior para gpustat 1.0+).
• !Usar o pacote pynvml em vez de nvidia-ml-py não funcionará.

Em coleções

Tópicos

Perguntas frequentes

O que é gpustat?

Ferramenta de linha de comando que mostra o status de GPUs NVIDIA, AMD e Huawei Ascend — uso, memória, temperatura e processos — em um formato compacto e legível. gpustat é um utilitário Python leve de linha de comando para consultar e monitorar o status de GPUs. Ele exibe uma linha por dispositivo com o nome da GPU, temperatura, utilização, uso de memória e os processos em execução, oferecendo uma visualização mais compacta que a do nvidia-smi.

gpustat é gratuito? Qual é a licença?

gpustat é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gpustat ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de gpustat foi em 8 de out. de 2026.

Para que posso usar gpustat?

Verificar quais GPUs de uma estação de trabalho ou servidor compartilhado estão livres antes de iniciar um treinamento. Acompanhar a memória e a utilização da GPU durante o treinamento de um modelo de longa duração. Coletar métricas de GPU em JSON em scripts de monitoramento. Consultar o status da GPU por SSH em um formato rápido e legível.

Como instalar gpustat?

Instale o gpustat pelo PyPI: pip install gpustat Se você tiver GPUs NVIDIA, instale a vinculação oficial de NVML da NVIDIA (não o pynvml): pip install nvidia-ml-py Execute o gpustat para mostrar o status da GPU: gpustat

Onde consigo gpustat?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/wookayin/gpustat