The repository or configuration that created this release differ from a previous release. 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, Canada, 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; Canada is one nationwide sheet (all provinces and territories). 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.6.0, because older engines have no Canadian 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.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Change of provenance
The repository or configuration that created these release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gridpin-0.6.0.tar.gz | 455.5 kB | With provenance | Details for gridpin-0.6.0.tar.gz |
Built distributions (wheels)
Total release size: 7.1 MB
Release files / gridpin-0.6.0.tar.gz
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.0.tar.gz |
|---|---|
| Size | 455.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
51988ed2cf6b70c49671bdac8e7ff63b088f4fc304a6f72a218e1bdd112e8848
|
|
BLAKE2b-256 checksum How to use checksums |
124f13f40cfd3b78647806f00b6b2efad566fccb132c8174cf5ad3ebe421d2ff
|
| 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 31, 2026.
Transparency logRelease files / gridpin-0.6.0-cp39-abi3-win_amd64.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
8eb9c4e1768ab29710b16cad882555e06ea9db893390d2e7f576412736b38e9a
|
|
BLAKE2b-256 checksum How to use checksums |
b977341e8ef6b615cd4afadc23fe85c27b0164cb315a2a793fc5bc7f4b0e812d
|
| 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 31, 2026.
Transparency logRelease files / gridpin-0.6.0-cp39-abi3-manylinux_2_34_x86_64.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.0-cp39-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1222864edcd06746120536954df542c3cb7c22b152ca08b2123492eb2b12bfa0
|
|
BLAKE2b-256 checksum How to use checksums |
32aa69f6fee1f137655af1ec18e15634bea54c274c3f993b04e3f32101e5913c
|
| 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 31, 2026.
Transparency logRelease files / gridpin-0.6.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
83103376e0d6c57b9d6243652fc628a5b2fdf365ddd6cd829c098a3a18199066
|
|
BLAKE2b-256 checksum How to use checksums |
5d8666cbaf98e3da5b7ff38c79762bbe0aa481ac1940f437cc913e23e2a9ffe8
|
| 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 31, 2026.
Transparency logRelease files / gridpin-0.6.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.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 |
2752964997719ef2234a2fb048ff932ab28b12acc102f477fdd23cc567107d4f
|
|
BLAKE2b-256 checksum How to use checksums |
1df90e30af9ca5ad3779a14cd82e81c86b35858c3e858550148410835f13ed28
|
| 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 31, 2026.
Transparency logRelease files / gridpin-0.6.0-cp39-abi3-macosx_11_0_arm64.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.0-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b2ff6d753e347dcadb2d21864fd23475a25ab6a04ff222060b85e98f2d847c6b
|
|
BLAKE2b-256 checksum How to use checksums |
ca7c9c12ed69cf09e921bbdd4a73542cb8f0b56357ea2037f3246b760ef0ccd3
|
| 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 31, 2026.
Transparency logRelease files / gridpin-0.6.0-cp39-abi3-macosx_10_12_x86_64.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | gridpin-0.6.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 |
f5d921ba8173183227524822a0a3bd99a9de7e6dc08466b111f367f21019bae1
|
|
BLAKE2b-256 checksum How to use checksums |
986bb07ce5ddec824cb771f08600cd08af26dc6c9efbd416e8c328644e72436c
|
| 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 31, 2026.
Transparency logSecurity for gridpin 0.6.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.
Change of provenance
The configuration that created this release differs from a previous release.
While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.
Attestation for gridpin-0.6.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 31, 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.
