Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Python module and CLI tool that returns IP address ownership and location information based on MaxMind's Geolite2 databases

Project Description

A Python module and CLI tool that returns IP address ownership and location information based on MaxMind’s GeoLite2 databases

usage: geoip          [-h] [-d DATABASE_DIRECTORY] [-v]
                      ip_address [ip_address ...]

positional arguments:
  ip_address            One or more IP addresses to look up

optional arguments:
  -h, --help            show this help message and exit
                        Overrides the path to the directory containing MaxMind
  -v, --version         show program's version number and exit


In order to use simplegeoip2, you must have the MaxMind GeoLite2 databases on your system. This simplest way to do this is to use the geoipupdate tool from MaxMind.


While this script should work under Python 2 and 3, using Python 3 for your OS is strongly recommended.

On Debian or Ubuntu systems, run:

$ sudo apt-get install python3-pip

Python 3 installers for Windows and macOS can be found at

To install or upgrade to the latest stable release of checkdmarc on macOS or Linux, run

$ sudo pip3 -U install simplegeoip2

Or, install the latest development release directly from GitHub:

$ sudo pip3 -U install git+

Note to Windows users

On Windows, pip3 is pip, regardless if you installed Python 2 or 3. So on Windows, simply substitute pip as an administrator in place of sudo pip3, in the above commands.

Bug reports

Please report bugs on the GitHub issue tracker

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(5.7 kB) Copy SHA256 Hash SHA256
Wheel py2.py3 Dec 18, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting