Hostile‑Command‑Suite

What is Hostile‑Command‑Suite?

Hostile‑Command‑Suite is a terminal‑based OSINT (Open Source Intelligence) investigation framework that combines automated profile scraping, multi‑platform username and email discovery, and local AI analysis via Ollama. It is built for security researchers and intelligence analysts who need a self‑contained, offline‑capable toolchain.

How to use Hostile‑Command‑Suite?

Install Ollama and pull a model (e.g., ollama pull qwen3:8b), then install Sherlock and Mosint. Clone the repository, create a Python virtual environment, and install dependencies. Run python3 HCSO.py --interactive for a guided investigation or pass target data directly on the command line (e.g., python3 HCSO.py "John Smith, @johnsmith123, [email protected]"). Use the --model flag to select a different Ollama model.

Key features of Hostile‑Command‑Suite

• Sherlock integration for username search across 400+ platforms.
• Mosint integration for email intelligence and breach analysis.
• Automated profile scraping of discovered accounts.
• DuckDuckGo web search for comprehensive OSINT gathering.
• Local Ollama AI for intelligent tool selection and analysis.
• Rich red/black themed terminal interface with progress indicators.

Use cases of Hostile‑Command‑Suite

• Investigate a username across dozens of social media platforms.
• Enrich an email address with breach data and domain information.
• Compile a public profile from a name, username, and company name.
• Discover cross‑platform connections and assess exposure levels.
• Automate lead‑driven pivoting during a threat intelligence investigation.

FAQ from Hostile‑Command‑Suite

What dependencies are required?

You need Ollama (for AI analysis), Sherlock and Mosint (for OSINT tooling), and a Python virtual environment with the packages in requirements.txt. All investigations are run locally.

Does the AI analysis send data to the cloud?

No. All AI analysis happens locally via Ollama. No data leaves your machine, and investigation results are not stored long‑term.

What license applies to this project?

Hostile‑Command‑Suite is released under the PolyForm Noncommercial License 1.0.0, which permits non‑commercial use only.

Can I add my own OSINT tools?

Yes. Create a new MCP server file in mcp_tools/, register it in MCPToolManager, and update the agent prompts. The README provides step‑by‑step instructions.

Is there any rate limiting or ethical guidance?

The README emphasizes legal compliance, authorization, and respecting platform rate limits. The system is designed for defensive security and legitimate research only.