FIND THE SIGNAL. MAP THE PERSON.
Username, email, domain, and image recon across 300+ sources, with one clean report.
Download · Quick start · Features · FAQ
Recon is a OSINT toolkit for Python 3.12. Username, email, domain, and image recon across 300+ sources, with one clean report.
| Platform | Windows, macOS, Linux |
| Runtime | Python 3.12 |
| Sources | 312, plugin-based |
| Output | JSON, CSV, HTML |
| Price | Free, MIT |
v1.7.0 is live. The build in the download folder mirrors the source in this repository.
Workspace — targets, sources, reports, settings.
| Check a handle across 312 platforms with rate limiting and retries. | Breach checks, domain reputation, and public profile discovery. | DNS, certificates, subdomains, and technology fingerprints. |
| Reverse image lookup across public engines with a merged result set. | One HTML report with sources, timestamps, and confidence per hit. | Every source is a small plugin with a documented interface. |
- Install Python 3.12 and pipx.
- Install Recon with pipx install recon-osint.
- Create a case folder for the target.
- Run one or more modules.
- Export the report and archive the raw responses.
recon/
├── bin\
├── config\
├── profiles\
└── logs\
Uninstall by deleting the folder. Nothing is written outside it and the per-user config directory.
# install
pipx install recon-osint
# run
recon user johndoe --sources all --out case-01
recon email j@example.com --breach --json
recon domain example.com --subs --tech
# report
recon report case-01 --html
- Only public data, and only where lawful.
- Case folders keep raw responses.
- Sources are pluggable.
Is this legal?
Only collect public information, and only for lawful purposes such as your own footprint or authorized research. Local law still applies.
Do the sources need API keys?
Some do. Recon works without them and clearly marks which sources were skipped.
Does it store results?
Yes, in the case folder you choose. Nothing is uploaded by default.
Can I add a source?
Drop a plugin into sources/ and register it. The interface is documented in docs/.
| Latest release | v1.7.0 — 3 days ago |
| Last commit | core: stability fixes and dependency bump |
| Open issues | 6 |
| Contributors | 9 |
| Update cadence | weekly |
Changelog — v1.7.0
- Stability fixes across the main workflow
- Reduced startup time
- Updated dependencies
- Documentation cleanup
- Username sweep across 312 sources
- Email and domain modules
- HTML case reports
- Plugin interface
- Timeline correlation
- Team workspaces
src/ core implementation
docs/ usage, FAQ, publishing notes
assets/ original artwork
CHANGELOG.md release history
DISCLAIMER.md responsible-use notice
MIT. See LICENSE.
Unofficial project. Recon is not affiliated with any platform or publisher it interoperates with. Use it only on systems you own, and only where such modifications are permitted.