maxminddb-geolite2

What it is and what it does

maxminddb-geolite2 wraps MaxMind's GeoIP2 library and bundles a snapshot of the GeoLite2 City geolocation database, allowing you to look up geographic information (country, city, coordinates) for a given IP address without needing to download or manage the database separately.

The package ships with a fixed database snapshot from 2018 and has not been updated since. It has no runtime dependencies beyond the MaxMind library it wraps, making it a self-contained installation—but the bundled data is stale and will not reflect current IP address allocations or geopolitical changes.

Use it for:

• Quick geolocation lookups in small projects or scripts where database freshness is not critical.
• Development and testing environments where you need IP-to-location mapping without external API calls.
• Legacy applications that depend on this specific package version and cannot migrate to maintained alternatives.
• Offline geolocation when network access to live GeoIP services is unavailable or undesired.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides geolocation lookups by IP address using MaxMind's GeoLite2 City database, bundled with the package for immediate use.

No. The package is abandoned (last update 2018-07-18), its bundled database is severely outdated, and its license status is unclear. For any production or current geolocation work, use a maintained alternative such as the official MaxMind GeoIP2 library with a current database subscription, or a modern open-source geolocation package. Install only if you are maintaining legacy code that explicitly requires this package.

Install

maxminddb-geolite2 on PyPI

pip install maxminddb-geolite2

uv add maxminddb-geolite2

poetry add maxminddb-geolite2

Installing maxminddb-geolite2

Before you install

High install friction due to a large bundled database file (maxminddb-geolite2-2018.703.tar.gz). The package is abandoned—last release was 2018-07-18, over 2949 days ago, with no active maintenance.

License in practice

License treatment is unclear; the package metadata declares no SPDX license. The description notes GeoLite2 data is under Creative Commons Attribution-ShareAlike 3.0 Unported, but the package's own license is not specified.

Quickstart

pip install maxminddb-geolite2

from geolite2 import geolite2

reader = geolite2.reader()
result = reader.get('1.1.1.1')
geolite2.close()

The bundled GeoLite2 database is from 2018 and will not be updated; IP geolocation accuracy degrades over time as address allocations change.

Verify before relying

• Whether the 2018-era GeoLite2 data is still accurate enough for production geolocation use.
• Whether the package's license obligations (Creative Commons Attribution-ShareAlike 3.0 for the data) are compatible with your project's license.
• Whether the official MaxMind library dependency is still maintained and compatible with current Python versions.

Package facts

Evidence: maxminddb-geolite2-2018.703.tar.gz

Tags

More Internet packages