Metadata-Version: 2.4
Name: ghosttrace-osint
Version: 1.0.2
Summary: OSINT Recon Engine — IP, Domain, Username Intelligence
Home-page: https://github.com/YOURUSERNAME/ghosttrace
Author: YourName
Author-email: youremail@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: license-file

# 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:

```bash
pip uninstall ghosttrace
```

## Install

Install this package from PyPI:

```bash
pip install ghosttrace-osint
```

## Install From Source

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

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

Then run it with:

```bash
ghosttrace example.com
```

## Usage

The command is `ghosttrace`:

```bash
ghosttrace example.com
ghosttrace 8.8.8.8
ghosttrace johndoe
```

You can also save a report:

```bash
ghosttrace example.com -o report.json
```

If you want to force the target type:

```bash
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:

![Main view](images/ghosttrace_view1.png)

IP scan:

![IP scan](images/check_by_ip.png)

Domain scan:

![Domain scan](images/check_by_domain.png)

Username scan:

![Username scan](images/check_by_username.png)

Windows PowerShell:

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

Unix / Git Bash:

```bash
rm ~/.pypirc
```

## Project Structure

```text
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
```
