Home

OSINT Forge

OSINT Forge is a modular, open-source command-line framework for building and running authorized OSINT workflows on Debian and Ubuntu. It installs and maintains trusted tools through reviewed plugins, processes individual or batch targets, and preserves private, reproducible case records.

Use OSINT Forge only for lawful research. Scan infrastructure only when you own it or have explicit authorization.

Current release

v0.3.1 is the latest stable release. It hardens the private, versioned case-management foundation introduced in v0.3.0, including case metadata and paths, interrupted and concurrent runs, generated reports, plugin discovery, batch output, framework replacement, and Recon-ng and SpiderFoot runtime privacy.

• Release v0.3.1
• Changelog
• Roadmap: committed through v1.0, tentative direction through v2.0

The main branch is the active development branch. Use the latest stable tag for real authorized work.

Start here

• Installation — install or upgrade on Debian and Ubuntu
• Command Reference — complete CLI overview
• Case Management — create, run, resume, inspect, and report cases
• Batch Workflows — process organized target files
• Plugin Catalog — included tools, targets, and limitations
• Plugin Development — build and validate governed plugins
• Architecture — framework, state, schemas, and execution model
• Development and CI — tests, supported environments, and pull requests
• Troubleshooting — diagnose installation and runtime problems
• Security and Ethics — authorization, privacy, and reporting vulnerabilities
• Licensing and Contributions — GPL terms and contribution rules
• Release Process — release gates, tagging, and verification
• Roadmap — committed releases through v1.0 and tentative goals through v2.0

Current capabilities

• Seven governed plugin definitions: ExifTool, GHunt, Maigret, Nmap, Recon-ng, Sherlock, and SpiderFoot
• Install, update, remove, doctor, search, category, and contract-validation commands
• Safe argument-array adapters for email, username, domain, IP, image, and file targets
• Parallel batch execution with private structured output
• Versioned cases with documented purpose and authorization scope
• Resumable case runs that retry failed or missing jobs and skip successful jobs
• Raw-output, command, timestamp, plugin-version, exit-status, and activity provenance
• Owner-only case artifacts and protected report destinations
• 60 automated tests plus ShellCheck and clean Debian/Ubuntu integration jobs
• Python 3.10 through 3.13 CI coverage

Quick start

git clone --branch v0.3.1 https://github.com/LizardPope1101/osint-forge.git
cd osint-forge
chmod +x bootstrap.sh
./bootstrap.sh

osint forge validate
osint forge list
osint --version

Individual OSINT tools remain opt-in. Install only what an authorized workflow requires.

Project links

• Source repository
• Latest release
• Issue tracker
• Security policy
• GPL-3.0-or-later license
• Contributing guide

Copyright © 2026 LizardPope1101.