kavachnet 0.1.2

AI-based VPN & Proxy Detector

KavachNet

KavachNet is a lightweight, AI-based VPN & Proxy detection tool. It helps identify if an IP address belongs to a known data center, VPN provider, or cloud infrastructure (like Azure, AWS, etc.).

Features

• Web Interface: A built-in Streamlit dashboard to check IPs visually.
• Python API: Easy-to-use functions to integrate into your own Python applications.
• Auto-Updates: Fetches the latest IP ranges from public sources (e.g., Azure Service Tags).
• Caching: Caches IP lists locally to improve performance and reduce network calls.

Installation

Install the package via pip:

pip install kavachnet

Usage

1. Web Interface (CLI)

To launch the interactive web dashboard:

kavachnet-web

2. Python API

You can use kavachnet directly in your Python scripts to check IP addresses.

from kavachnet import is_vpn_ip, refresh_cache

# Check a single IP
ip_to_check = "8.8.8.8"
result = is_vpn_ip(ip_to_check)

if result:
    print(f"{ip_to_check} is a VPN/Data Center IP!")
else:
    print(f"{ip_to_check} appears to be a residential or unknown IP.")

# Force update the local cache of VPN IP ranges
refresh_cache()

How It Works

KavachNet aggregates public IP ranges from major cloud providers and VPN services. When you check an IP, it verifies if the IP falls within these known subnets.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request on GitHub.

License

This project is licensed under the MIT License.