← Back
cfahlgren1

cfahlgren1/parquet-xray

See how a Parquet file is laid out, byte by byte

View on GitHub ↗https://huggingface.co/spaces/cfahlgren1/parquet-xray ↗
Stars
46
Forks
3
Watchers
46
Open issues
3
Contributors
2
Language
TypeScript
License
Apache License 2.0
Default branch
main
Created Sep 28, 2026Updated Oct 1, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Parquet X-ray

See how a Parquet file is laid out on disk: row groups, column chunks, pages, indexes, bloom filters and the footer.

Try it on Hugging Face →

A Parquet file with a row group open and a page's details in a popover

Paste a Hub URL, an hf:// path, any URL that allows CORS range requests, or open a local file. Only the footer and page indexes are downloaded, so a 2 GB file opens after reading about 3 MB. Parsing uses hyparquet.

Development

npm install
npm run dev       # http://localhost:5173/?url=sensors.parquet
npm run verify    # lint, type-check, tests, build

See CONTRIBUTING.md for how the code is organized.

License

Apache 2.0