🚀 Features
- IP lookup with optional City & ASN info
- Raw or pretty-printed output
- Local DB support (DB-IP Free Lite)
- Easy settings toggle via CLI
- Cross-platform (Linux / Windows / macOS)
📦 Installation
ipry requires Python 3.10+ to run. Recommended installation via pipx.
🪟 Windows
pip install ipry
Or optionally via pipx:
pipx install ipry
🐧 Linux
pipx install ipry
If pipx is not installed:
sudo pacman -S python-pipx # Arch-based
sudo apt install pipx # Debian/Ubuntu
sudo dnf install pipx # Fedora
apk add py3-pipx # Alpine Linux
sudo xbps-install -S python3-pipx # Void Linux
nix-env -iA nixpkgs.pipx # NixOS
sudo zypper install pipx # OpenSUSE
🍎 macOS
pipx install ipry
If pipx is not installed:
brew install pipx && pipx ensurepath
By default, ipry uses ip-api.com to fetch public IP geolocation data.
🧪 Usage
Lookup any IP:
ipry 8.8.8.8
Raw output (compact JSON):
ipry 8.8.8.8 --raw
Change settings:
ipry --settings
Update all databases:
ipry --update
Show help:
ipry --help
🔧 Available Flags
| Flag | Description |
|---|---|
--raw |
Outputs plain JSON (no colors or formatting) |
--local-db |
Use local geolocation database (from DB-IP.com, licensed under CC BY 4.0) |
--settings |
Open interactive settings menu |
--update |
Force update of all local DB files |
--help |
Show help message |
🌐 Local DB Mode (Optional)
When --local-db is enabled, ipry will download and use local geolocation datasets from DB-IP.com:
These files are free for personal and open-source use under the
Creative Commons Attribution 4.0 License (CC BY 4.0).
1 maintainer
Metadata
1 maintainer
Release files for ipry 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ipry-1.1.0.tar.gz | 9.1 kB | Without provenance | Details for ipry-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ipry-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for ipry-1.1.0-py3-none-any.whl |
Total release size: 19.7 kB
Release files / ipry-1.1.0.tar.gz
| Download URL | ipry-1.1.0.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d24302d2f2bc98b5331ca330f5c52744ae35f266f4d4918adeb6ef10a6cd2a2d
|
|
BLAKE2b-256 checksum How to use checksums |
85f552771b38aadfe3343487d1f4daa06ff1ec78dd99b318b614375104b7e58c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / ipry-1.1.0-py3-none-any.whl
| Download URL | ipry-1.1.0-py3-none-any.whl |
|---|---|
| Size | 10.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b397a4a42bb37f4f24fb86f9ecc364bfdcc4bdb527e2b14e4c9fb1267588732
|
|
BLAKE2b-256 checksum How to use checksums |
9662840980c6d4fffc49d5987b80a44ee39ba237dcf99a5d9d830ae7774d6247
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for ipry 1.1.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A 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.
