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

> Discover GhostTrack prerequisites. Install Python 3, git, and libraries on Linux or Termux. Get started with our easy setup guide for GhostTrack.

- Repository: [K1LLU/GhostTrack](https://github.com/HunxByts/GhostTrack)
- Tags: how-to-guide
- Published: 2026-04-29

---

**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`](https://github.com/HunxByts/GhostTrack/blob/main/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:

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

```

For Android Termux users, the equivalent commands are:

```bash
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`](https://github.com/HunxByts/GhostTrack/blob/main/requirements.txt).

### Core Libraries in requirements.txt

The [`requirements.txt`](https://github.com/HunxByts/GhostTrack/blob/main/requirements.txt) file in the repository root defines two mandatory Python packages:

- **`requests`** – Handles all HTTP API calls within [`GhostTR.py`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/GhostTR.py))

Install these dependencies by running:

```bash
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`](https://github.com/HunxByts/GhostTrack/blob/main/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:

```bash

# 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`](https://github.com/HunxByts/GhostTrack/blob/main/requirements.txt))
- **Network**: Active internet connection required for external API queries
- **Main Executable**: [`GhostTR.py`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/GhostTR.py).

### Why does GhostTrack need internet access?

The tool relies on external APIs to function. According to the source code in [`GhostTR.py`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/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`.