https://github.com/fsociety-team/fsociety

A Modular Penetration Testing Framework
https://github.com/fsociety-team/fsociety

cli docker fsociety osint penetration-testing python python3

Last synced: 6 months ago
JSON representation

A Modular Penetration Testing Framework

• Host: GitHub
• URL: https://github.com/fsociety-team/fsociety
• Owner: fsociety-team
• License: mit
• Created: 2020-05-17T04:35:05.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-04-24T13:52:48.000Z (6 months ago)
• Last Synced: 2025-04-24T14:47:50.954Z (6 months ago)
• Topics: cli, docker, fsociety, osint, penetration-testing, python, python3
• Language: Python
• Homepage: https://fsociety.dev/
• Size: 3.58 MB
• Stars: 1,468
• Watchers: 49
• Forks: 170
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-python-testing - fsociety - A Modular Penetration Testing Framework. (Penetration Testing)
• best-of-web-python - GitHub - 24% open · ⏱️ 24.04.2025): (Web Testing)

README

          


  



# fsociety

[![PyPI](https://img.shields.io/pypi/v/fsociety?color=orange&logo=pypi&logoColor=orange&style=flat-square)](https://pypi.org/project/fsociety/)

[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue?logo=python&style=flat-square)](https://www.python.org/downloads/)

![PyPI - Downloads](https://img.shields.io/pypi/dm/fsociety?style=flat-square)

[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/fsocietyteam/fsociety/latest?style=flat-square)](https://hub.docker.com/r/fsocietyteam/fsociety)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-organge.svg?logo=git&logoColor=organge&style=flat-square)](http://makeapullrequest.com)

[![Open in Visual Studio Code](https://img.shields.io/badge/VSCode-Open-0098FF?style=flat-square)](https://open.vscode.dev/fsociety-team/fsociety)

[![Twitter Follow](https://img.shields.io/twitter/follow/fsociety_team?color=blue&style=flat-square)](https://twitter.com/fsociety_team)

A Modular Penetration Testing Framework

[![Packages](https://img.shields.io/badge/PACKAGES.md-red?style=flat-square)](https://github.com/fsociety-team/fsociety/blob/main/PACKAGES.md)

[![Changelog](https://img.shields.io/badge/CHANGELOG.md-red?style=flat-square)](https://github.com/fsociety-team/fsociety/blob/main/CHANGELOG.md)



  



## Install

```bash

pip install fsociety

```

## Update

```bash

pip install --upgrade fsociety

```

## Usage

```bash

usage: fsociety [-h] [-i] [-s]

A Penetration Testing Framework

optional arguments:

  -h, --help     show this help message and exit

  -i, --info     gets fsociety info

  -s, --suggest  suggest a tool

```

## Docker

```bash

docker pull fsocietyteam/fsociety

docker run -it fsocietyteam/fsociety fsociety

```

## Developing

```bash

git clone https://github.com/fsociety-team/fsociety.git

pip install -e ".[dev]"

```

## License

This software is licensed under the [MIT](https://github.com/fsociety-team/fsociety/blob/main/LICENSE) License.

![Fuck It Ship It](https://img.shields.io/badge/fuck%20it-ship%20it-blue?style=flat-square)