types-geoip2
Typing stubs for geoip2
Decision gist · record as of 2026-08-14
Yes, if you are using geoip2 before version 4.0.2 and want static type checking. No, if you are already on geoip2 4.0.2 or later—uninstall this package and use geoip2's built-in type annotations instead. The package itself is stable and permissively licensed.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with a single lightweight runtime dependency (types-maxminddb).
- The package is actively maintained via typeshed, though the latest release was in 2021.
License · maintenance · safety
Apache-2.0 license (permissive) — Licensed under Apache-2.0 (permissive), imposing no restrictions on use in proprietary or open-source projects.
last release 2021-08-28 (1812 days) · last repo commit 2026-08-14 · 5,108 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 164,560 downloads/mo, #10,543 on PyPI
Alternatives
Verify before relying
pip install types-geoip2
import geoip2.database
# Type checker now understands geoip2 types- Whether geoip2 version 4.0.2 or later is already in use (would make this package unnecessary)
- Current maintenance cadence and whether the package will receive updates as geoip2 evolves
What it is and what it does
types-geoip2 is a PEP 561 type stub package that provides type information for the geoip2 library. It allows static type checkers like mypy, PyCharm, and pytype to understand the types and signatures in geoip2 code, catching type errors before runtime. This is useful when working with older versions of geoip2 that did not include their own type annotations.
The package is maintained as part of typeshed, the central repository of type stubs for the Python ecosystem. It depends on types-maxminddb for its own type information. The description notes that geoip2 itself has included type annotations since version 4.0.2, and recommends uninstalling this package if using that version or later.
Use it for
- Enable mypy or PyCharm type checking on codebases using older geoip2 releases
- Catch type errors in geolocation lookup code during development rather than at runtime
- Maintain strict type safety in projects that depend on geoip2 without built-in type support
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are using geoip2 before version 4.0.2 and want static type checking.
No, if you are already on geoip2 4.0.2 or later—uninstall this package and use geoip2's built-in type annotations instead. The package itself is stable and permissively licensed.
Install
types-geoip2 on PyPI
Before you install
Low install friction with a single lightweight runtime dependency (types-maxminddb). The package is actively maintained via typeshed, though the latest release was in 2021.
License in practice
Licensed under Apache-2.0 (permissive), imposing no restrictions on use in proprietary or open-source projects.
Quickstart
pip install types-geoip2
import geoip2.database
# Type checker now understands geoip2 typesVerify before relying
- Whether geoip2 version 4.0.2 or later is already in use (would make this package unnecessary)
- Current maintenance cadence and whether the package will receive updates as geoip2 evolves
Package facts
| License | Apache-2.0 license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetypes-maxminddb |
| Maintenance | Actively maintained 1,812 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 164,560 / month, #10,543 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseTyping :: Typed |
Evidence: types_geoip2-3.0.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “type stubs geoip2”
- types-geoip2Provides type stubs for the geoip2 package, enabling static type…
- geoip2-toolsAutomates downloading and updating of MaxMind GeoIP2 databases,…
- geoip2Queries MaxMind's GeoIP web services and databases to look up…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also types-maxminddb · types-Jinja2 · types-Flask · types-pkg-resources · types-PyJWT · types-ipaddress · types-Werkzeug · types-click · types-filelock · types-backports