https://github.com/smartlegionlab/smart-ip-info
A simple command-line tool to get information about IP addresses.
https://github.com/smartlegionlab/smart-ip-info
cli ip-address-lookup ip-information python-app python-application python-cli smartlegionlab
Last synced: 11 months ago
JSON representation
A simple command-line tool to get information about IP addresses.
- Host: GitHub
- URL: https://github.com/smartlegionlab/smart-ip-info
- Owner: smartlegionlab
- License: bsd-3-clause
- Created: 2025-05-01T13:52:13.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-11T11:14:51.000Z (12 months ago)
- Last Synced: 2025-06-11T12:28:22.652Z (12 months ago)
- Topics: cli, ip-address-lookup, ip-information, python-app, python-application, python-cli, smartlegionlab
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Smart IP Info v0.1.3
[](https://github.com/smartlegionlab/smart-ip-info/)
[](https://pypi.org/project/smart-ip-info)
[](https://github.com/smartlegionlab/smart-ip-info/)
[](https://github.com/smartlegionlab/smart-ip-info/)
[](https://github.com/smartlegionlab/smart-ip-info/)
A simple command-line tool to get information about IP addresses.
## 🌟 Features
- 100% pure Python (no external dependencies)
- Supports both CLI and programmatic usage
- Fast IP lookup (uses ip-api.com free tier)
- Detailed network information
- Clean, developer-friendly output
- Privacy-focused (no tracking)
## 📦 Installation
```bash
pip install smart-ip-info
```
Or for the latest development version:
```bash
pip install git+https://github.com/smartlegionlab/smart-ip-info.git
```
## 🚀 Usage
### Command Line Interface
Basic usage:
```bash
smart-ip-info --ip 8.8.8.8
```
Interactive mode (prompts for IP):
```bash
smart-ip-info
```
### Python API
```python
from smart_ip_info import get_ip_info, format_ip_info
# Get info about an IP
info = get_ip_info("8.8.8.8")
# Get info about your own IP
my_info = get_ip_info()
# Format results
print(format_ip_info(info))
```
## 📊 Example Output
```plaintext
IP Address: 8.8.8.8
Country: United States (US)
Region: California (CA)
City: Mountain View
ZIP: 94043
Coordinates: 37.4056, -122.0775
Timezone: America/Los_Angeles
ISP: Google LLC
Organization: Google Public DNS
AS: AS15169 Google LLC
Proxy: False
Hosting: True
```
---
## ⚠️ Limitations
- Free tier has 45 requests/minute limit
- No commercial API support (yet)
- IPv6 support is limited
***
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
***
Licensed under the terms of the BSD 3-Clause License
(see LICENSE for details).
Copyright © 2025, A.A. Suvorov
All rights reserved.