Skip to content

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

PMTiles Support

PMTiles generation is built-in. Just install tippecanoe:

# macOS
brew install tippecanoe

# Ubuntu
sudo apt install tippecanoe

Then use gpio pmtiles create to generate PMTiles from GeoParquet files. See the GeoJSON guide for usage.

Plugins

gpio supports a plugin system for community extensions. 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

# 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.