Prerequisites for Running GhostTrack: Complete Setup Guide for Linux and Android

To run GhostTrack, you need Python 3, git, and two Python libraries (requests and phonenumbers) installed on a Linux Debian-based system or Android Termux, plus an active internet connection.

GhostTrack is an open-source OSINT utility developed by HunxByts that provides IP tracking, phone number analysis, and username lookup capabilities through a command-line interface. Before executing the main script, your environment must meet specific prerequisites for running GhostTrack to ensure the HTTP requests and phone number parsing functions operate correctly.

Operating System and System Packages

GhostTrack is built as a portable Python script that runs on Unix-like environments. The repository documentation specifies two primary deployment targets.

Linux and Termux Support

The tool officially supports Debian-based Linux distributions and Android via Termux. Because GhostTR.py is a standalone Python script, it executes anywhere Python 3 is available, though the installation instructions target these specific environments.

Required System Binaries

You must install two system-level packages before cloning the repository:

• git – Required to clone https://github.com/HunxByts/GhostTrack.git
• python3 and python3-pip – The interpreter and package manager needed to run the script and install dependencies

On Debian/Ubuntu systems, install these with:

sudo apt-get update
sudo apt-get install -y git python3 python3-pip

For Android Termux users, the equivalent commands are:

pkg install git python3

Python Dependencies and Runtime Requirements

Once system packages are present, you must configure the Python environment according to the specifications in requirements.txt.

Core Libraries in requirements.txt

The requirements.txt file in the repository root defines two mandatory Python packages:

• requests – Handles all HTTP API calls within GhostTR.py, including IP WHOIS lookups to ipwho.is (line 45) and social media profile checks (lines 54‑58)
• phonenumbers – Parses and formats phone numbers, extracting carrier and timezone data (lines 86‑98 in GhostTR.py)

Install these dependencies by running:

pip3 install -r requirements.txt

Network Connectivity for API Calls

Internet access is mandatory. The script queries external services including ipwho.is, api.ipify.org, and various social media URLs to retrieve tracking data. Without outbound HTTP connectivity, the core features in GhostTR.py cannot function.

Step-by-Step Installation Workflow

Follow this complete workflow to satisfy all prerequisites for running GhostTrack on a fresh Linux machine:

# Install system prerequisites

sudo apt-get update
sudo apt-get install -y git python3 python3-pip

# Clone the repository

git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack

# Install Python dependencies

pip3 install -r requirements.txt

# Launch the tool

python3 GhostTR.py

For Termux on Android, omit sudo and use pkg instead of apt-get, then run python GhostTR.py.

Launching and Verifying GhostTrack

When all prerequisites are met and you execute python3 GhostTR.py, the terminal displays a colorful banner followed by a numeric menu:

[ 1 ] IP Tracker
[ 2 ] Show Your IP
[ 3 ] Phone Number Tracker
[ 4 ] Username Tracker
[ 0 ] Exit

Select an option by typing its number. For example, entering 1 followed by an IP address like 8.8.8.8 triggers the requests.get call to ipwho.is defined in the source code, returning geolocation data.

Summary

• Operating System: Debian-based Linux or Android Termux
• System Packages: git, python3, and python3-pip (or pkg equivalents)
• Python Libraries: requests and phonenumbers (installed via requirements.txt)
• Network: Active internet connection required for external API queries
• Main Executable: GhostTR.py in the repository root

Frequently Asked Questions

Can I run GhostTrack on Windows?

GhostTrack is designed for Linux and Termux environments according to the repository documentation. While Python scripts are generally cross-platform, the installation instructions and path handling in GhostTR.py assume a Unix-like shell. Windows users would need to adapt the commands or use WSL (Windows Subsystem for Linux).

What Python version is required for GhostTrack?

The repository requires Python 3.x (any recent 3.x release). The shebang and execution commands in the README specifically call python3, ensuring compatibility with the requests and phonenumbers libraries used in GhostTR.py.

Why does GhostTrack need internet access?

The tool relies on external APIs to function. According to the source code in GhostTR.py, the script sends HTTP requests to ipwho.is for IP geolocation, api.ipify.org for public IP detection, and various social media platforms for username verification. Without network connectivity, these data sources are unreachable.

Where are the dependencies defined in the repository?

All Python package requirements are centralized in requirements.txt at the repository root. This file lists requests and phonenumbers with their minimum versions, allowing pip to resolve and install them automatically when you run pip3 install -r requirements.txt.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}