Installation¶

Quick Install¶

CLI tool:

uv tool install geoparquet-io

Python library:

uv add geoparquet-io

Using pip/pipx

If you prefer pip: pip install geoparquet-io If you prefer pipx: pipx install geoparquet-io

Installing Plugins¶

gpio supports plugins that add specialized format support:

# Install with PMTiles support
uv tool install geoparquet-io --with gpio-pmtiles

# Add plugin to existing installation
uv tool install --with gpio-pmtiles geoparquet-io

Available plugins:

gpio-pmtiles - Convert between GeoParquet and PMTiles

See the Plugins Guide for more information.

From Source¶

git clone https://github.com/geoparquet/geoparquet-io.git
cd geoparquet-io
uv sync --all-extras

Requirements¶

Python: 3.10+
PyArrow: 12.0.0+
DuckDB: 1.5.0+

All dependencies are installed automatically.

Optional Dependencies¶

Development¶

uv sync --all-extras

Documentation¶

uv sync --group docs
uv run mkdocs serve

Verifying Installation¶

gpio --version
gpio --help
gpio inspect your_file.parquet

Shell Completion¶

BashZshFish

# Add to ~/.bashrc
eval "$(_GPIO_COMPLETE=bash_source gpio)"

# Add to ~/.zshrc
eval "$(_GPIO_COMPLETE=zsh_source gpio)"

# Add to ~/.config/fish/config.fish
eval (env _GPIO_COMPLETE=fish_source gpio)

Upgrading¶

uv tool upgrade geoparquet-io     # CLI
uv add --upgrade geoparquet-io    # Library

Uninstalling¶

uv tool uninstall geoparquet-io   # CLI
uv remove geoparquet-io           # Library

Platform Support¶

OS: Linux, macOS, Windows
Python: 3.10, 3.11, 3.12, 3.13
Arch: x86_64, ARM64

Troubleshooting¶

DuckDB Issues¶

uv add --upgrade duckdb

PyArrow Compatibility¶

uv add --upgrade "pyarrow>=12.0.0"

Next Steps¶

Head to Quick Start to learn the basics.