Files in this release originate from inconsistent repositories or configurations. View details.
GridPin
Offline forward and reverse geocoding from a memory-mapped country file. Off the grid. On the grid.
No server, no database import, no per-request fees, and every geocoding query stays on your machine. After you install the package and download a sheet, GridPin makes no network requests.
pip install --upgrade gridpin==0.5.0
The wheel contains the engine, not the data: download a country sheet separately. Free static sheets for the United States, Germany, France, Italy, Spain, the Netherlands, Brazil and Serbia are listed at https://gridpin.dev/docs#delivery — no account, no key, no sign-up.
One command does the download and the check: pip install gridpin-mcp, then
gridpin-fetch fr puts the France sheet in ~/.cache/gridpin and verifies it against the
signed release; from Python, gridpin_mcp.sheets.download("fr") returns the same path. The
same package is an MCP server for AI agents (uvx gridpin-mcp).
The United States is one nationwide sheet: point addresses in 35 states, Census address ranges elsewhere. Germany covers 15 of 16 Länder; Bavaria is not covered. Spain covers all 52 postal provinces; Brazil is one nationwide sheet. Client update required: use 0.5.0, because older engines have no US rules.
import gridpin
g = gridpin.Geocoder("france.bin")
g.geocode("8 Boulevard du Port, Amiens", 1)
g.reverse(49.8945, 2.2949, 1)
# optional POI layer (cascade built in: address index first,
# POI only on weak results, exact addresses never overridden)
g = gridpin.Geocoder("france.bin", poi="fr_poi.bin")
If GridPin is useful to you, a star on GitHub helps other people find it.
Three limits worth knowing before you build on this:
-
Reverse returns the nearest indexed address — or a street-centroid approximation — together with
distance_m. It is not a rooftop fix. -
Speed: exact lookups run at ~3,000/s, measured on the France sheet and a single arm64 laptop core. Typo-tolerant fuzzy matching is much slower (tens of ms/query) — use
geocode_many()to batch. -
POI is France-only today and opt-in. Address lookup is the core product; the POI layer is younger and never overrides an exact address match.
-
Country files & docs: https://gridpin.dev/docs
-
Quality benchmark, including where other geocoders score higher: https://gridpin.dev/bench
-
Engine license: Apache-2.0. Data files carry their own source licenses — see https://github.com/gridpin/gridpin/blob/main/ATTRIBUTIONS.md
1 maintainer
Metadata
1 maintainer
Release files for gridpin 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Inconsistent provenance
These files originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| gridpin-0.5.0.tar.gz | 432.4 kB | With provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| gridpin-0.5.0-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| gridpin-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| gridpin-0.5.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| gridpin-0.5.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| gridpin-0.5.0-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details |
| gridpin-0.5.0-cp39-abi3-macosx_10_12_x86_64.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 6.9 MB
Release files / gridpin-0.5.0.tar.gz
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0.tar.gz |
|---|---|
| Size | 432.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cbd6f368c3fce1087bb6917a11d6fbd48227de218740e7be24b4de99b30fea45
|
|
BLAKE2b-256 checksum How to use checksums |
fcc12f1f09987b71e6286ea6d9b3be1f70732e0674969c5b236a48bcaf996930
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / gridpin-0.5.0-cp39-abi3-win_amd64.whl
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 964.5 kB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
904b737bf7963af86f69da289458dc2530ac9e4b04d2a823ca0e83614b6a7be7
|
|
BLAKE2b-256 checksum How to use checksums |
b6d05063a6659c31cf854c14684722de54c551d6869d20858d63b79987c5f211
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / gridpin-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
d365020c381e023bed1f504350d1041582ade915d482969772b884890af1a43a
|
|
BLAKE2b-256 checksum How to use checksums |
cf9f384e46f4eb1f761acff6c30cbf6bee98f23114ed22648af94ac68df61913
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / gridpin-0.5.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ee8e7950b40d555bbc3ffabe5d88a2422795e7be1a23f8fe4edcb795d2691679
|
|
BLAKE2b-256 checksum How to use checksums |
67f282cf5e31293a96746435d98d8e6285c97f2846ceb8337aa673f9d8677a75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / gridpin-0.5.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
8259cfca134f5fe302de9bf9cc97460ecfcf2df549d251419373c3d2c1e81436
|
|
BLAKE2b-256 checksum How to use checksums |
4eed3e8ce916206c4437f4ec2c1993854e5e44038139260ed08afe2dfab475dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / gridpin-0.5.0-cp39-abi3-macosx_11_0_arm64.whl
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
32eb9b779aa9579a459812e0497addeb8d53bc84aae7a727690b678f10efbb08
|
|
BLAKE2b-256 checksum How to use checksums |
9b7db0567d81cc2e5b08735de40fec64a900c78f8c2153711ddf80bb7d57408d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / gridpin-0.5.0-cp39-abi3-macosx_10_12_x86_64.whl
Inconsistent provenance
This file belongs to a release with inconsistent provenance: the files in this release originate from different repositories or configurations.
We recommend inspecting each repository and configuration before proceeding. View details.
| Download URL | gridpin-0.5.0-cp39-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
550ad54034d159653c1eea38cfcc869376c4f345fce6184f8b400bbfd2841ef9
|
|
BLAKE2b-256 checksum How to use checksums |
c14dd57f8153136272dbe8b2c2aa65e926e3ba7c06e1d51551ce0cae187c860d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for gridpin 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Inconsistent provenance
The release files originate from multiple, inconsistent configurations.
While this could reflect a legitimate choice by the project maintainers, it may also indicate that the release has been compromised.
Configuration
- 3 files release.yml
- 4 files wheels-backfill.yml
Attestation for gridpin-0.5.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
