Speculator Project

July 4, 2026 ยท View on GitHub

Version License OS Shell

Overview

The Speculator Project is the successor to Argos, building on the techniques and lessons learned during its development. It provides a Bash script designed to customise Debian-based virtual machines for Open Source Intelligence (OSINT) activities. Its goal is to create a secure and standardised environment for intelligence gathering.

The Speculatores

We took our name from the Speculatores, the scouts and spies of the Roman legions. They operated in silence, collected what mattered and reported back. Read more.

Features

  • Comprehensive Tool Installation: Offers a variety of tools for analysing usernames, social media, metadata, domains and more.
  • In-browser OSINT Dashboard: Installs Exploratores, a browser-based OSINT toolkit, and sets it as the Firefox ESR start page and a bookmark for one-click access.
  • Browser Setup: Configures Firefox, Brave and Tor browsers to support secure research.
  • Desktop Customisation: Configures the GNOME desktop environment for OSINT workflows.
  • Resilient Installation: The script is designed to continue even if a single tool fails to install, ensuring the most complete setup possible.

System Requirements

  • Operating System: Debian 13 "Trixie" (amd64).
  • Virtualisation: VirtualBox (recommended). The script installs VirtualBox Guest Additions automatically.
  • Disk Space: Minimum 50 GB recommended.
  • RAM: Minimum 4 GB recommended.
  • Permissions: Sudo privileges are required.
  • Internet Connection: Needed to download and configure tools.

Installation

Quick install (single command):

git clone https://github.com/SOsintOps/speculator-project.git && cd speculator-project && sudo ./speculator_install.sh

Or step by step:

  1. Clone the repository: 
    git clone https://github.com/SOsintOps/speculator-project.git
cd speculator-project
  2. Run the script with superuser privileges: 
    sudo ./speculator_install.sh

Usage

After installation and a system reboot, the tools and environment are ready for use. The script configures browsers, installs essential OSINT tools and prepares the system for secure investigations. Refer to the tool documentation for specific usage instructions, or consult the FAQ page for common queries.

Tools Included

Person Investigation (email, username, phone, fullname)

Aliens Eye - BDFR - Blackbird - Enola - Eyes - GHunt - h8mail - Holehe - Ignorant - Instaloader - Maigret - Mailcat - Mr.Holmes - Naminter - Osintgram - PhoneInfoga - Profil3r - Sherlock - Social-Analyzer - SocialScan - Stalkie - Toutatis - Turbolehe - WhatsMyName

Domain and Web Tools

Amass - Fierce - HTTPX - Metagoofil - Nuclei - Photon - Subfinder - Sublist3r - theHarvester - TLDSweep

Metadata and Image Tools

Carbon14 - ExifTool - MAT2 - MediaInfo - Xeuledoc

Frameworks

Changedetection.io - Maigret Web - Recon-ng - Sn0int

Video and Media

Gallery-dl - Streamlink - yt-dlp

Archives

ArchiveBox - Internet Archive CLI - WaybackPy - Waybackpack

Browsers

Brave - Firefox (configured for OSINT) - Tor

Firefox ESR opens on Exploratores, a local browser-based OSINT toolkit that works offline as your investigation start page.

Additional Utilities

BleachBit - FFmpeg - Google Earth Pro - Kazam - Name-That-Hash - Search-That-Hash - VLC Media Player - WireTapper

Documentation

Contributing

See CONTRIBUTING.md for guidelines on reporting bugs, suggesting features and submitting pull requests.

License

This project is licensed under the MIT License.

Disclaimer

The Speculator Project draws on techniques described in OSINT Techniques, 11th Edition by Michael Bazzell. This project is not affiliated with, endorsed by, or connected to Michael Bazzell or IntelTechniques in any way.

This script is provided "as-is" without any warranties. It is intended solely for educational and testing purposes. Please use it responsibly and at your own risk.