nsys-tui
Terminal UI for NVIDIA Nsight Systems profiles — timeline viewer, kernel navigator, NVTX hierarchy.
Installation
pip install -e .
Quick Start
# Show profile info
nsys-tui info profile.sqlite
# Interactive timeline TUI (Perfetto-style)
nsys-tui timeline profile.sqlite --gpu 0 --trim 39 42
# Interactive tree TUI
nsys-tui tui profile.sqlite --gpu 0 --trim 39 42
# GPU kernel summary
nsys-tui summary profile.sqlite --gpu 0
# Export to Perfetto JSON
nsys-tui export profile.sqlite -o traces/
Timeline TUI
A curses-based horizontal timeline viewer with:
- Time-cursor navigation — ←/→ pans through time, ↑/↓ selects stream
- Per-stream colors — 7-color palette for visual stream differentiation
- NVTX hierarchy — stacked NVTX span bars above stream swimlanes
- Kernel details — inline names, duration labels, heat-based styling
- Bookmarks — save/jump to positions and ranges
- Config panel — tweak stream rows, tick density, NVTX depth live
Keybindings
| Key | Action |
|---|---|
| ←/→ | Pan through time |
| Shift+←/→ | Page pan (1/4 viewport) |
| ↑/↓ | Select stream |
| Tab / Shift+Tab | Snap to next/prev kernel |
| +/- | Zoom in/out |
| a | Toggle absolute/relative time |
| T | Cycle time tick density |
| B | Save bookmark |
| ' | Show bookmark list (1-9 to jump) |
| ` | Jump back to previous position |
| C | Config panel |
| h | Help overlay |
| / | Filter kernels by name |
| m | Set min duration threshold |
| q | Quit |
Commands
| Command | Description |
|---|---|
info |
Profile metadata and GPU info |
summary |
GPU kernel summary with top kernels |
overlap |
Compute/NCCL overlap analysis |
nccl |
NCCL collective breakdown |
iters |
Detect training iterations |
tree |
NVTX hierarchy as text |
tui |
Interactive tree TUI |
timeline |
Horizontal timeline TUI |
search |
Search kernels/NVTX by name |
export |
Export Perfetto JSON traces |
export-csv |
Flat CSV export |
export-json |
Flat JSON export |
viewer |
Generate interactive HTML viewer |
Development
pip install -e '.[dev]'
pytest tests/ -v
License
MIT
Metadata
Release files for nsys-tui 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nsys_tui-0.1.5.tar.gz | 59.4 kB | Without provenance | Details for nsys_tui-0.1.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nsys_tui-0.1.5-py3-none-any.whl | Python 3 | none | any | Details for nsys_tui-0.1.5-py3-none-any.whl |
Total release size: 123.7 kB
Release files / nsys_tui-0.1.5.tar.gz
| Download URL | nsys_tui-0.1.5.tar.gz |
|---|---|
| Size | 59.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e63ea3a46715d4e0ab3395382081cd81eb41d99506afdcdda730796e714fac00
|
|
BLAKE2b-256 checksum How to use checksums |
518a2147b3961934359dc83fc31c823cd8363cb6210683c411062fc9ba6b9200
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / nsys_tui-0.1.5-py3-none-any.whl
| Download URL | nsys_tui-0.1.5-py3-none-any.whl |
|---|---|
| Size | 64.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0a6ff6c1b3b4577b115c1e131fb6e01ecb78c55067ec2e1fee04abf5dbf0d006
|
|
BLAKE2b-256 checksum How to use checksums |
df1e07cc143fabf8754593530da0f34da7ca84bcac399533ce581e0fff446f6b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for nsys-tui 0.1.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.