---
id: maxminddb-geolite2
version: "2018.703"
license: unclear
license_treatment: unclear
maintenance: abandoned
---

# maxminddb-geolite2 — Provides access to the geolite2 database.  This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com/

License: unclear · Maintenance: abandoned · Downloads: 213.0K/mo

## 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 above — 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

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

- License: not declared (unclear)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 213.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

geolocation by IP address, geoip lookup, maxmind geolite2, IP to country city location, geolocation database, IP geolocation library, geolocation, abandoned, stale-data

[View on SkillFed](https://skillfed.io/packages/maxminddb-geolite2) · [View on PyPI](https://pypi.org/project/maxminddb-geolite2/)