Skip to main content

nsys-tui

Terminal UI for NVIDIA Nsight Systems profiles — timeline viewer, kernel navigator, NVTX hierarchy.

CI License: MIT Python 3.10+

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)

Source distribution for nsys-tui 0.1.5
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)

Table of built distributions (wheels) for nsys-tui 0.1.5
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page