Last updated 12 October 2026
Getting started
This page installs Polypress and compresses, inspects and restores one table.
Install
pip install polypress
Pre-built packages are available for macOS 11 or later on Apple silicon and for Linux on x86-64 and ARM64. For other options, including direct downloads, see Installation.
Compress a table
The example uses a public table of popular baby names from NYC Open Data.
$ polypress compress baby_names.csv
29,685 rows x 6 cols 1.5 MB -> 53.6 KB 28.52x 27.7 MB/s
baby_names.csv.ppz
The output reports the size of the table, the size of the archive, the compression ratio and
the speed. The archive is written next to the input as baby_names.csv.ppz.
Inspect an archive
$ polypress info baby_names.csv.ppz
file baby_names.csv.ppz
size 53.6 KB
container single block
made by polypress 1.00
rows 29,685
columns 6
plan 3 dict, 3 num
reordered 1 columns sorted by a parent
The plan lists how the columns were coded: three with a dictionary of distinct values and three as numbers. One column was stored in the order of a parent column, as described in How Polypress works.
Restore the table
$ polypress restore baby_names.csv.ppz
The table is written back to baby_names.csv. To write it in another format, give
an output file with a different extension, for example
polypress restore baby_names.csv.ppz -o baby_names.json.