ParqForge humbinal

Use this command to install ParqForge:

winget install --id=humbinal.ParqForge -e

A Rust-based Parquet toolkit with a CLI (pqx) and a desktop GUI. Inspect, preview, and diagnose Parquet files and Hive-partitioned datasets, with data transformation and optimization on the roadmap.

ParqForge

Parquet tools for quick inspection, preview, and dataset navigation.

中文文档

ParqForge is a local-first toolkit for exploring individual Parquet files and Hive-partitioned datasets. It includes a script-friendly CLI and a Windows-first desktop viewer.

Highlights

Inspect schema and file metadata: columns, types, nullability, compression, encodings, row groups, rows, and partitions.
Browse a dataset as a tree with Parquet file names, sizes, and creation times.
Preview data with head, tail, and cat, with 1-based row numbers.
Work with a single .parquet file or a key=value/ partitioned directory.
Generate completions for Bash, Zsh, Fish, PowerShell, and Elvish.
Open files and datasets in the ParqForge Desktop viewer on Windows.
Read-only by design: the current release does not modify your Parquet data.

Install

CLI

Install the prebuilt CLI with cargo-binstall:

cargo binstall parqforge-cli

Alternatively, download a platform archive from the Releases page and add pqx to your PATH. Linux releases provide both variants:

*-linux-*-musl.tar.gz (recommended): statically linked and does not require a particular glibc version.
*-linux-*-gnu.tar.gz: dynamically linked GNU build; requires glibc 2.17 or newer.

Desktop viewer for Windows

Install with WinGet:

winget install humbinal.ParqForge

You can also download the MSI installer or the portable Windows bundle from the Releases page. The MSI installs both ParqForge.exe and pqx.exe, adds pqx to the machine PATH, registers .parquet file associations, and creates a Start Menu shortcut.

Quick start

# Inspect schema and dataset metadata
pqx inspect data.parquet

# Browse a partitioned dataset
pqx tree dataset/

# Preview rows
pqx head data.parquet -n 20
pqx tail data.parquet -n 20
pqx cat data.parquet -n 5

Every command accepts --help. To see all commands or the options for one command:

pqx --help
pqx inspect --help
pqx tree --help

CLI reference

Command	Purpose
`pqx inspect`	Show schema and dataset metadata
`pqx tree`	Show Parquet files as a directory tree
`pqx head`	Preview the first rows
`pqx tail`	Preview the last rows
`pqx cat`	Preview the first and last rows
`pqx completions`	Generate a shell completion script

The `` argument can be a single Parquet file or a Hive-partitioned directory such as date=2026-07-19/region=us/.

Shell completions

Generate a script for your shell and load it according to your shell's conventions:

pqx completions bash
pqx completions zsh
pqx completions fish
pqx completions powershell
pqx completions elvish

For a temporary Bash setup:

source &lt;(pqx completions bash)

For a temporary PowerShell setup:

pqx completions powershell | Out-String | Invoke-Expression

pqx prints the completion script and does not modify your shell configuration automatically.

Documentation

Support ParqForge

If ParqForge is useful to you, you can support its continued development. Donations are optional and help with maintenance, documentation, testing, and future improvements.

For payments in China, scan the corresponding QR code:

WeChat Pay
Scan with WeChat to buy the author a coffee. ☕

Alipay
Scan with Alipay to buy the author a coffee. ☕

License

Apache-2.0. See LICENSE.