Polypress 1.0.0

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.

Next steps