# Fsociety (otlite)

A Modular Penetration Testing Framework.

- Takes: Domain, Username, Email
- Install: `otlite install fsociety`, into its own virtualenv
- Pinned: [fsociety==3.2.9](https://pypi.org/project/fsociety/3.2.9/)
- Command: `fsociety`
- Python: any otlite runs on (3.10 or newer)
- Verified: 24 Sept 2026, version 3.2.9 on Ubuntu 26.04 LTS, Python 3.12.14
- Licence: MIT; 1,834 GitHub stars
- Source: https://github.com/fsociety-team/fsociety

otlite is the no-Docker edition of OTInstaller for Linux and macOS: [install it](https://otinstaller.com/otlite) with `curl -fsSL https://get.otinstaller.com/otlite | sh`.

## Run it

Fsociety has no typed inputs: pass its own arguments after `--`, starting with `otlite run fsociety -- --help`.

## Before you run it

- **Dual-use.** otlite prints this before installing it: You are solely responsible for how you use these tools and for complying with all applicable laws. Use them only on targets you are authorized to investigate.
- **Asks questions while it runs.** Run it on its own in a terminal; `otlite run --all`, `otlite auto` and playbooks skip it.

## What a run leaves

- `results/fsociety/johndoe/<time>_fsociety_johndoe_<run id>.txt`
- `results/fsociety/johndoe/<time>_fsociety_johndoe_<run id>.meta.json`
- `results/fsociety/johndoe/<time>_fsociety_johndoe_<run id>.envelope.json`

The envelope is the same shape for every tool: the tool and version, the input, timing, exit code and status, the emails, domains, IP addresses and URLs found in the output, and the output file's path, hash and size. `otlite results --tool fsociety` lists saved runs, `otlite extract fsociety` pulls out indicators and `otlite diff fsociety johndoe` compares the two latest runs.

## With other tools

Batch runs skip it: asks questions while it runs; run it on its own.

## Related tools

- [Spiderfoot](https://otinstaller.com/otlite/tools/spiderfoot.md): SpiderFoot automates OSINT for threat intelligence and mapping your attack surface
- [Openosint](https://otinstaller.com/otlite/tools/openosint.md): AI-powered OSINT agent with interactive REPL, MCP server, and direct CLI modes
- [Secator](https://otinstaller.com/otlite/tools/secator.md): secator - the pentester's swiss knife
- [Blackbird](https://otinstaller.com/otlite/tools/blackbird.md): OSINT tool to search for accounts by username and email across social networks
- [User Scanner](https://otinstaller.com/otlite/tools/user-scanner.md): (2-in-1) Email & Username OSINT suite featuring native MCP support for deep data extraction just from a single Email/Username
- [Socialscan](https://otinstaller.com/otlite/tools/socialscan.md): Python library for accurately querying username and email usage on online platforms

[All 47 otlite tools](https://otinstaller.com/otlite/tools) · [otlite docs](https://otinstaller.com/docs/otlite.md)