███╗   ██╗██╗   ██╗███╗   ███╗      ██████╗ ███████╗██╗███╗   ██╗████████╗
  ████╗  ██║██║   ██║████╗ ████║     ██╔═══██╗██╔════╝██║████╗  ██║╚══██╔══╝
  ██╔██╗ ██║██║   ██║██╔████╔██║     ██║   ██║███████╗██║██╔██╗ ██║   ██║   
  ██║╚██╗██║██║   ██║██║╚██╔╝██║     ██║   ██║╚════██║██║██║╚██╗██║   ██║   
  ██║ ╚████║╚██████╔╝██║ ╚═╝ ██║     ╚██████╔╝███████║██║██║ ╚████║   ██║   
  ╚═╝  ╚═══╝ ╚═════╝ ╚═╝     ╚═╝      ╚═════╝ ╚══════╝╚═╝╚═╝  ╚═══╝   ╚═╝  

⚡ Premium Phone Number OSINT Search Engine ⚡

---

Warning

LEGAL DISCLAIMER & TERMS OF USE

• This tool is created strictly for educational purposes and security auditing only.
• The developer (Lucky) does NOT own, collect, store, or distribute any personal data retrieved by this tool.
• All data queried is sourced from public leaks already circulating on the dark-web.
• The developer is NOT responsible for any misuse, illegal activities, privacy violations, or legal consequences resulting from this tool.
• By utilizing this software, you assume full legal responsibility for your actions.

---

📖 Table of Contents

• ✨ Key Features
• 🚀 Installation Guide
• 🛠️ How to Use
• 📋 System Requirements
• 📁 Repository Structure
• 🔒 Security & License

---

✨ Key Features

• 🔄 Dual API Pipeline — Direct queries through primary engine with auto-fallback to secondary API routes.
• 👾 Holographic UI Banner — Beautiful, retro terminal banner that resolves dynamically from matrix noise.
• 🎨 Cyber Animations — Interactive scanning bars, loader bars, decryption status spinners, and flashing success prompts.
• 🧹 Auto Data Sanitation — Filters out null, empty, or redundant records automatically before displaying results.
• 🗃️ Deduplication Engine — Intelligent fingerprint hashing to deduplicate matching records across multiple queries.
• 🪪 Standardized Fields — Beautiful categorization for identity info (Aadhaar, PAN, Voter ID), contact details, location data, and operator specs.

---

🚀 Installation Guide

Option 1: Automated Script (Linux / Termux / macOS)

Simply download and run the automated installer to set up all dependencies:

# Clone the repository
git clone https://github.com/lucky-om/NUM-OSINT.git
cd NUM-OSINT

# Set execution privileges
chmod +x install.sh run.sh

# Run the installer script
./install.sh

Option 2: Manual Installation (All Platforms)

For manual setup on Windows, Linux, or macOS:

# Clone the repository
git clone https://github.com/luckyverse/NUM-OSINT.git
cd NUM-OSINT

# Install required Python modules
pip install -r requirements.txt

---

🛠️ How to Use

Launch the launcher script or python engine directly:

# Using the launcher script (Linux/macOS)
./run.sh

# Or directly running Python (All Platforms)
python3 num-osint.py

🎮 Terminal Commands & Inputs

Once you complete the startup security verification:

• Enter any 10-digit mobile number (e.g. 9876543210) to perform a query.
• Type help to access the command reference.
• Type clear or cls to clear the terminal output.
• Type exit or quit to close the interface safely.

---

📋 System Requirements

Dependency	Minimum Version	Description
🐍 Python	≥ 3.8	Backend interpreter
📡 requests	≥ 2.31.0	HTTP request handler for OSINT API querying
🎨 colorama	≥ 0.4.6	ANSI escape code interpretation for terminal styling

---

📁 Repository Structure

NUM-OSINT/
├── 📁 .git/
├── 📄 .gitignore
├── 📄 LICENSE             # Proprietary license terms
├── 📄 README.md           # Documentation and guides
├── 📄 SECURITY.md         # Vulnerability reporting protocol
├── 📄 config.py           # API routes & key hashes configuration
├── 📄 install.sh          # Dependency installation script
├── 📄 num-osint.py        # Core application source code
├── 📄 requirements.txt    # List of python package dependencies
└── 📄 run.sh              # Premium shell launcher

---

🔒 Security & License

• Vulnerability Reporting: To report any security flaws or concerns, please refer to our guidelines in SECURITY.md.
• License: © 2026 Lucky. All Rights Reserved. This software is proprietary and subject to terms detailed in LICENSE.

Developed with ⚡ by Lucky
luckyverse.tech