tui
Interactive terminal UI for exploring a sample of a dataset (not the whole file).
Requires pip install "undatum[tui]" and a real TTY.
pip install "undatum[tui]"
undatum tui data.csv
undatum tui data.parquet --limit 500
undatum tui workbook.xlsx --table Sheet2
undatum tui nested.jsonl --flatten-nested
Keys: q quit, ? help, o open, s profile, f frequency on the selected
column, / filter the sample, e export the current view, w convert/save as
(full file, --low-memory), v validate the sample, m mask preview, p
export pipeline YAML, : command palette, ctrl+s SQL (default LIMIT 500 on
the data view), Tab cycle panes. From the file picker, u opens a local
path or s3:// / gs:// / az:// URI. The status line shows the equivalent CLI command. Recent
files are stored as paths only in ~/.undatum/tui-history.json. Use table /
profile / sql when you are not on an interactive terminal.
Reference
Reads: any readable format · Writes: interactive terminal view · Memory: bounded: a sample of rows · Engines: auto, duckdb, python
undatum tui [OPTIONS] [INPUT_FILE]
| Argument | Description |
|---|---|
INPUT_FILE | Path to a data file. Opens a file picker if omitted. |
| Option | Description | Default |
|---|---|---|
-n, --limit INTEGER | Sample rows to show in the grid (default 200, max 5000). | 200 |
-d, --delimiter TEXT | CSV delimiter character (auto-detected when omitted). | |
--quotechar TEXT | CSV quote character (iterabledata default '"' when omitted). | |
--encoding TEXT | File encoding (e.g. 'utf8', 'latin1'). | |
-F, --format-in TEXT | Override input file format detection (e.g. 'csv', 'jsonl'). | |
-e, --engine [auto|duckdb|python] | Processing engine: auto (default), duckdb, or python. | |
--table, --sheet TEXT | Table or sheet name for multi-table sources (Excel, SQLite, lakehouse). | |
--start-page INTEGER | Sheet index (0-based) for Excel files. | 0 |
--trust | Acknowledge pickle deserialization risk when reading pickle sources. | |
--on-error TEXT | Parse-error policy: raise (default), skip, or warn. | |
--error-log TEXT | Append parse errors as JSONL (use with --on-error skip or warn). | |
--flatten-nested | Unfold nested dict / array-of-dict fields into dotted paths (e.g. city.lat). | |
--max-nested-depth INTEGER | With --flatten-nested, maximum nest depth to unfold (engine default 5). | |
--keep-nested-parents / --no-keep-nested-parents | With --flatten-nested, keep parent dict/array fields alongside dotted children. | --keep-nested-parents |
--verbose / --no-verbose | Enable verbose logging output. | --no-verbose |
See also shared options.