hdf5-cli

A read-only, full-screen terminal UI for interactively exploring HDF5 files.

pip install -e ".[dev]"   # from a clone, for development
# or, once published:
pip install hdf5-cli

The 0.13.x releases of the textual-image dependency ship broken wheels, so this project pins it to >=0.12,<0.13. If you manage dependencies yourself, keep that constraint.

h5cli path/to/file.h5

• Navigate the group/dataset tree with the arrow keys; ⏎ expands a group (children load lazily, so large files stay responsive).
• The detail pane shows shape, dtype, chunking, compression, attributes, and summary statistics for the selected dataset.
• Datasets are auto-previewed: numeric data as a value table (a bounded default slice), and image-like datasets (2-D, or 3-D with a 3/4-channel axis) as an inline image where the terminal supports it (kitty/sixel/iTerm).
• Press e to export the selected dataset for further review: .npy, CSV, JSON, PNG, or TIFF.
• Press q to quit.

This tool never writes to the HDF5 file it is exploring.

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q