ghosttrace-osint 1.0.1

OSINT Recon Engine — IP, Domain, Username Intelligence

ghosttrace-osint

ghosttrace-osint is an OSINT reconnaissance tool for IP addresses, domains, and usernames.

Important

There is already a different package named ghosttrace on PyPI. Install this project as ghosttrace-osint.

If you previously installed the conflicting package, remove it first:

pip uninstall ghosttrace

Install

Install this package from PyPI:

pip install ghosttrace-osint

Install From Source

If you want to run ghosttrace-osint from the repository instead of PyPI:

git clone https://github.com/YOURUSERNAME/ghosttrace.git
cd GhostTrace
pip install -r requirements.txt
pip install -e .

Then run it with:

ghosttrace example.com

Usage

The command is ghosttrace:

ghosttrace example.com
ghosttrace 8.8.8.8
ghosttrace johndoe

You can also save a report:

ghosttrace example.com -o report.json

If you want to force the target type:

ghosttrace 8.8.8.8 -t ip
ghosttrace example.com -t domain
ghosttrace johndoe -t username

Configuration

• AbuseIPDB key: To enable AbuseIPDB threat lookups set the ABUSEIPDB_KEY environment variable (or create a .env file with ABUSEIPDB_KEY=yourkey). If not set, the tool skips AbuseIPDB checks.
• Non-interactive runs: Use --no-prompt (or -n) to avoid the final press-Enter prompt when running in scripts or CI: ghosttrace example.com --no-prompt.
• Remove local PyPI token: If you created or used a ~/.pypirc file for publishing, remove it after publishing to avoid leaving tokens on disk.

Screenshots

Main view:

IP scan:

Domain scan:

Username scan:

Windows PowerShell:

Remove-Item -Path $env:USERPROFILE\.pypirc -Force

Unix / Git Bash:

rm ~/.pypirc

Project Structure

GhostTrace/
├── setup.py
├── setup.cfg
├── pyproject.toml
├── README.md
├── LICENSE
├── MANIFEST.in
├── requirements.txt
└── ghosttrace/
	├── __init__.py
	├── __main__.py
	└── modules/
		├── __init__.py
		├── colors.py
		├── banner.py
		├── detector.py
		├── ip_lookup.py
		├── domain_lookup.py
		├── username_lookup.py
		└── reporter.py