openscilab

ipspot: Look Up Public and Private IP Addresses

IPSpot is a Python library and CLI for detecting local and public IPv4/IPv6 addresses, with optional geolocation from multiple API providers. It suits scripts and interactive network checks that need address and location data without building provider integrations.

View on GitHub Compare
Stars
106
Forks
8
Stars, last 30 days
+0
Last commit
today
Contributors
4

Our take

Quietno commits in the last 90 days

Health score

32/100

How it is scored
Activity
36
Community
34
Issues
21
Pull requests
37

+0 stars in the last 30 days

IPSpot is a focused, straightforward option for Python-based IP and geolocation lookups, with recent releases and merged changes but no commits recorded in the last 90 days.

Good fit if

  • You need IPv4 and IPv6 address detection from Python or a CLI.
  • Your workflow benefits from optional geolocation and choosing among lookup providers.
  • You are comfortable relying on external APIs for public IP and location data.

Look elsewhere if

  • You need address or geolocation results without contacting external providers.
  • Your project requires a service or deployment stack rather than a Python library or CLI.
  • You need recent commit activity or demonstrated issue closure as an adoption requirement. The available health data shows no issues closed in the recent 90-day period.
All health signals
Last commit2026-10-12 (today)
Commits, last 90 days0
Releases, last 12 months4 (latest v0.8, 2026-02-05)
Contributors4 (top contributor: 72% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days7 (typically merged in 2 days)
Project age18 months

Checked on 2026-10-13 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

106

Forks

8

Change since Nov 14, 2026: 0 stars·0 forks

Overview

IPSpot retrieves a machine's private IPv4 and IPv6 addresses and looks up its public addresses through external API providers. Optional geolocation adds details such as country, region, coordinates, timezone, and organization.

It is useful when a Python application or command-line workflow needs a quick view of the machine's network identity. Provider selection and fallback options help accommodate differences in the available lookup services.

Key Features

  • Detects private IPv4 and IPv6 addresses.
  • Retrieves public IPv4 and IPv6 addresses using external providers.
  • Supports optional geolocation data for public address lookups.
  • Offers provider selection, including automatic and safer automatic modes.
  • Provides configurable timeouts, retries, retry delays, and backoff for library lookups.
  • Can be used as a Python library or from the ipspot command-line interface.
  • Offers a no-geolocation CLI mode for address-only results.

Use Cases

  • A developer can inspect public and private addresses from a terminal while debugging a network configuration.
  • A Python script can report the machine's public IP and approximate location as part of a diagnostic workflow.
  • A monitoring or operations workflow can check IPv4 and IPv6 connectivity through supported public lookup providers.
  • A tool that needs address data can use IPSpot rather than implementing integrations with multiple lookup APIs itself.

What you need

Detected in the repository

  • Python (from setup.py)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from PyPI:

pip install ipspot

Then run ipspot or python -m ipspot. See the README for library examples and provider options.

Considerations

Public IP and geolocation lookups depend on external providers, so availability and returned location details can vary by provider. The project has published releases and merged pull requests in the past year, but its health status is Quiet because no commits were recorded in the last 90 days; the available data also shows no issues closed in that period. Four contributors are recorded, and contribution is not flagged as concentrated around one person. The project requires Python; the provided requirements data indicates CI and tests are present.

Found this useful?

Share it with someone who would like ipspot.