{"id":51052701,"url":"https://github.com/seongwon980/htop-gpu","last_synced_at":"2026-06-22T19:00:20.611Z","repository":{"id":352181488,"uuid":"1214163491","full_name":"seongwon980/htop-gpu","owner":"seongwon980","description":"Terminal dashboard for NVIDIA GPUs, system CPU/memory, and processes — clickable, with conda env / docker container / cwd info per process.","archived":false,"fork":false,"pushed_at":"2026-05-09T12:01:40.000Z","size":1736,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-21T19:04:56.730Z","etag":null,"topics":["btop","cli","cuda","dashboard","gpu","htop","machine-learning","monitor","nvidia","nvtop","python","sysadmin","terminal","tui"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/htop-gpu/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seongwon980.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-18T07:44:42.000Z","updated_at":"2026-05-30T09:45:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/seongwon980/htop-gpu","commit_stats":null,"previous_names":["seongwon980/htop-gpu"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/seongwon980/htop-gpu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seongwon980%2Fhtop-gpu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seongwon980%2Fhtop-gpu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seongwon980%2Fhtop-gpu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seongwon980%2Fhtop-gpu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seongwon980","download_url":"https://codeload.github.com/seongwon980/htop-gpu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seongwon980%2Fhtop-gpu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34661709,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["btop","cli","cuda","dashboard","gpu","htop","machine-learning","monitor","nvidia","nvtop","python","sysadmin","terminal","tui"],"created_at":"2026-06-22T19:00:19.600Z","updated_at":"2026-06-22T19:00:20.579Z","avatar_url":"https://github.com/seongwon980.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# htop-gpu\n\n**NVIDIA GPUs, system CPU/memory, and processes in one terminal dashboard** — each process annotated with its conda env, docker container, and working directory.\n\n[![PyPI](https://img.shields.io/pypi/v/htop-gpu.svg?style=flat-square\u0026color=blue\u0026v=2)](https://pypi.org/project/htop-gpu/)\n[![Python](https://img.shields.io/pypi/pyversions/htop-gpu.svg?style=flat-square\u0026v=2)](https://pypi.org/project/htop-gpu/)\n[![License](https://img.shields.io/badge/license-MIT-yellow.svg?style=flat-square\u0026v=2)](LICENSE)\n\n[Install](#install) · [Usage](#usage) · [Keys](#keys) · [Why](#why)\n\n\u003cimg src=\"docs/demo.gif\" alt=\"htop-gpu demo\" width=\"780\"\u003e\n\n\u003c/div\u003e\n\n## Install\n\n```bash\npip install htop-gpu\n```\n\n```bash\nhtop-gpu          # one-shot snapshot\nhtop-gpu -w       # watch mode\nhgpu -w           # short alias\n```\n\nLinux, Python 3.9+, NVIDIA driver. Uses NVML (fast) when available, falls\nback to `nvidia-smi`.\n\n## What it does\n\n- **GPUs, CPU/memory, and processes** in one screen\n- **Click any panel title** to switch what the process table shows\n  (`cpu` / `memory` for top system processes, `gpus` for GPU-only,\n  `processes` to fullscreen the table)\n- **Click column headers** to sort\n- **Click a process row → press `k`** to send `SIGTERM` (falls back to\n  `sudo kill` with a password prompt if you don't own it)\n- **Conda env, docker container, tmux session** shown next to each\n  command, so you can tell at a glance whose stray process is hogging\n  GPU 5\n- **Adaptive layout** — drops decorations as the terminal shrinks; it\n  keeps the GPU + CPU/Mem panels visible even on tiny windows\n\n## Usage\n\nWatch mode is mouse-driven. Everything is also keyboard:\n\n| key                      | what it does                               |\n|--------------------------|--------------------------------------------|\n| `c` / `m` / `p`          | switch to cpu / memory / focus-procs view  |\n| `Esc`, `←`               | back out (clears mode / focus / selection) |\n| `↑` `↓`                  | move selection                             |\n| `k`, `F9`                | kill selected process                      |\n| `l`                      | toggle full command lines                  |\n| `0`–`9`                  | filter to that GPU index                   |\n| `q`, `F10`, `Ctrl-C`     | quit                                       |\n\nMouse uses SGR mouse mode (`\\x1b[?1006h`) — works in iTerm2, Kitty,\nWezTerm, Ghostty, Alacritty, Windows Terminal, modern xterm/Konsole, and\ntmux with `mouse on`.\n\nFor scripts:\n\n```bash\nhtop-gpu --json | jq '.processes[] | select(.gpu_mem_mib \u003e 10000)'\n```\n\n## Credits\n\nUI takes inspiration from [htop](https://htop.dev),\n[btop](https://github.com/aristocratos/btop), and\n[nvtop](https://github.com/Syllo/nvtop). Independent project, not\naffiliated.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseongwon980%2Fhtop-gpu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseongwon980%2Fhtop-gpu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseongwon980%2Fhtop-gpu/lists"}