Metadata-Version: 2.1
Name: gpustat
Version: 0.6.0
Summary: An utility to monitor NVIDIA GPU status and usage
Home-page: https://github.com/wookayin/gpustat
Author: Jongwook Choi
Author-email: wookayin@gmail.com
License: MIT
Description: `gpustat`
        =========
        
        [![pypi](https://img.shields.io/pypi/v/gpustat.svg?maxAge=86400)][pypi_gpustat]
        [![Build Status](https://travis-ci.org/wookayin/gpustat.svg?branch=master)](https://travis-ci.org/wookayin/gpustat)
        [![license](https://img.shields.io/github/license/wookayin/gpustat.svg?maxAge=86400)](LICENSE)
        
        Just *less* than nvidia-smi?
        
        ![Screenshot: gpustat -cp](screenshot.png)
        
        NOTE: This works with NVIDIA Graphics Devices only, no AMD support as of now. Contributions are welcome!
        
        Self-Promotion: A web interface of `gpustat` is available (in alpha)! Check out [gpustat-web][gpustat-web].
        
        [gpustat-web]: https://github.com/wookayin/gpustat-web
        
        
        Usage
        -----
        
        `$ gpustat`
        
        Options:
        
        * `--color`            : Force colored output (even when stdout is not a tty)
        * `--no-color`         : Suppress colored output
        * `-u`, `--show-user`  : Display username of the process owner
        * `-c`, `--show-cmd`   : Display the process name
        * `-p`, `--show-pid`   : Display PID of the process
        * `-F`, `--show-fan`   : Display GPU fan speed
        * `-P`, `--show-power` : Display GPU power usage and/or limit (`draw` or `draw,limit`)
        * `--watch`, `-i`, `--interval`   : Run in watch mode (equivalent to `watch gpustat`) if given. Denotes interval between updates. ([#41][gh-issue-41])
        * `--json`             : JSON Output (Experimental, [#10][gh-issue-10])
        
        ### Tips
        
        - To periodically watch, try `gpustat --watch` or `gpustat -i` ([#41][gh-issue-41]).
            - For older versions, one may use `watch --color -n1.0 gpustat --color`.
        - Running `nvidia-smi daemon` (root privilege required) will make the query much **faster** and use less CPU ([#54][gh-issue-54]).
        - The GPU ID (index) shown by `gpustat` (and `nvidia-smi`) is PCI BUS ID,
          while CUDA differently assigns the fastest GPU with the lowest ID by default.
          Therefore, in order to make CUDA and `gpustat` use **same GPU index**,
          configure the `CUDA_DEVICE_ORDER` environment variable to `PCI_BUS_ID`
          (before setting `CUDA_VISIBLE_DEVICES` for your CUDA program):
          `export CUDA_DEVICE_ORDER=PCI_BUS_ID`.
        
        
        Quick Installation
        ------------------
        
        Install from [PyPI][pypi_gpustat]:
        
        ```
        pip install gpustat
        ```
        
        To install the latest version (master branch) via pip:
        
        ```
        pip install git+https://github.com/wookayin/gpustat.git@master
        ```
        
        If you don't have root privilege, please try to install on user namespace: `pip install --user`.
        Note that from v0.4, `gpustat.py` is no more a zero-dependency executable.
        However, in rare cases you'll need a single executable script (legacy), you can also try:
        
        ```
        wget https://raw.githubusercontent.com/wookayin/gpustat/v0.3.2/gpustat.py -O ~/.local/bin/gpustat
        chmod +x ~/.local/bin/gpustat    # Assuming ~/.local/bin is in your $PATH
        ```
        
        [pypi_gpustat]: https://pypi.python.org/pypi/gpustat
        [gh-issue-10]: https://github.com/wookayin/gpustat/issues/10
        [gh-issue-41]: https://github.com/wookayin/gpustat/issues/41
        [gh-issue-54]: https://github.com/wookayin/gpustat/issues/54
        
        
        License
        -------
        
        [MIT License](LICENSE)
        
Keywords: nvidia-smi gpu cuda monitoring gpustat
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Monitoring
Description-Content-Type: text/markdown
Provides-Extra: test
