Skip to content

kaushiksrini/parqeye

Repository files navigation

parqeye

CI

parqeye lets you peek inside your Parquet files. Instantly inspect their contents, schema, and metadata — right from your terminal.

Demo

Features

  • Interactive Data Visualization - Browse through your Parquet data in a table view with keyboard navigation.
  • Schema Explorer - Inspect column types, nested structures, and field definitions.
  • File Metadata - View Parquet file-level metadata including version, created by, encoding stats and more.
  • Row Group Statistics - Examine row group-level metadata, statistics, and data distribution across groups.
  • Tab-based Interface - Quickly switch between Visualize, Schema, Metadata, and Row Groups views.
  • Terminal-native - Works directly in your terminal.

Usage

Run parqeye by providing the path to the .parquet file.

parqeye <path-to-parquet-file>

Installation

Direct Download

You can download the latest release from the Releases page.

Build from Source

You can build from source by downloading the repository and running the following command:

cargo build --release

Cargo

If you use Rust, build directly from crates.io

cargo install parqeye

Homebrew

If you have Homebrew, you can install using:

brew install kaushiksrini/parqeye/parqeye

License

This package is released under the MIT License.

Acknowledgements

TODOs

  • Lazy/streaming loading of parquet files.
  • Filter columns by value in the visualize tab.
  • Read parquet files on the cloud (s3://...).

About

Peek inside Parquet files right from your terminal

Resources

License

Stars

Watchers

Forks

Packages

No packages published