# rischanlab/bruteforce_py architecture

> Architecture diagram of the GitHub repository rischanlab/bruteforce_py, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rischanlab/bruteforce_py
- Repository: https://github.com/rischanlab/bruteforce_py

## Overview

1. **Repository shape**
   - This is a flat, script-oriented Python repository, not a package or framework.
   - `README.md` describes it as a collection of “bruteforce” Python scripts for many protocols and services.
   - There is no visible shared library layer, build system, or orchestration service.

2. **Primary architectural pattern**
   - Each `.py` file is a standalone entrypoint for one target service or attack surface.
   - The repo is organized by protocol/service name rather than by reusable components.
   - In practice, the architecture is “many single-purpose command-line tools” rather than one integrated application.

3. **Service-specific modules**
   - The file set covers a broad set of remote authentication and login targets: SSH, FTP, Telnet, SMTP, POP, IMAP, NNTP, MySQL, SNMP, Web auth, WordPress, cPanel, Webmin, Gmail, Facebook, Friendster, Linksys, and others.
   - Several names suggest specialized targets or contexts such as `rootbrute.py`, `accbrute.py`, `locbrute.py`, `wordpressbf.py`, and `webauthbrute.py`.
   - This implies separate protocol handlers and/or target-specific request logic in each script.

4. **Variant families**
   - Many tools come in multiple variants: `*_iprange.py`, `*_random.py`, and in one case `sshbrute_fork.py`.
   - The `iprange` scripts indicate a target-selection boundary where the script iterates over a range of hosts instead of a single endpoint.
   - The `random` scripts indicate randomized candidate generation, likely for usernames, passwords, or target selection.
   - `fork` suggests a process-level concurrency variant for parallel attempts.

5. **Likely data flow**
   - Operator supplies a target, a candidate set, or a range.
   - The script generates attempt combinations.
   - Each attempt is sent directly to a remote service over the relevant protocol.
   - The script observes the response to determine success or failure and reports it to the console or terminal.

6. **Protocol boundary**
   - The main architectural boundary is between the local Python script and the remote network service.
   - Each script encapsulates the protocol-specific connection method and authentication exchange for its target.
   - There is no sign of a centralized API server, database, or message queue mediating those attempts.

7. **Execution model**
   - These are intended to run independently, likely from the command line.
   - No evidence of long-running daemonization or a controller/worker topology across files.
   - Concurrency appears to be optional and script-local, based on naming like `fork`.

8. **Shared concerns that are probably repeated across files**
   - Command-line parsing
   - Network connection setup
   - Credential iteration
   - Success/failure detection
   - Status output and termination conditions
   - Because the repo is flat, these concerns are likely duplicated rather than abstracted.

9. **Technology footprint**
   - The implementation language is Python.
   - The repository does not show external infrastructure dependencies in the tree; everything appears local-script based.
   - No build artifacts, package metadata, or dependency manifests are visible.

10. **Operational boundary and scope**
   - The repository is a collection of automation scripts for authentication attempts against external systems.
   - From an architecture-diagram perspective, the only significant external systems are the target services themselves.
   - There is no internal persistence layer or cross-script coordination visible in the repository layout.

11. **How to diagram it**
   - Draw the repo as a set of independent Python executables grouped by target category.
   - Show a user/operator feeding inputs into a chosen script.
   - Show that script making outbound network requests to a remote service and receiving auth responses.
   - Group variants (`iprange`, `random`, `fork`) as alternative execution modes for the same general workflow.

Main entry points: [`sshbrute_fork.py`](https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_fork.py) (ssh fork), [`sshbrute_iprange.py`](https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_iprange.py) (ssh range), [`sshbrute_random.py`](https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_random.py) (ssh random), [`ftpbrute_iprange.py`](https://github.com/rischanlab/bruteforce_py/blob/master/ftpbrute_iprange.py) (ftp range)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_local["Local Python scripts"]
  node_operator(("Operator<br/>human"))
  node_ssh_suite["SSH tools<br/>script family"]
  node_ftp_suite["FTP tools<br/>script family"]
  node_telnet_suite["Telnet tools<br/>script family"]
  node_mail_suite["Mail tools<br/>script family"]
  node_db_suite["Database tools<br/>script family"]
  node_web_suite["Web auth tools<br/>script family"]
  node_target_suite["Target-specific tools<br/>script family"]
  node_misc_suite["Misc tools<br/>script family"]
  node_sshbrute_fork["ssh fork<br/>python script<br/>[sshbrute_fork.py]"]
  node_sshbrute_iprange["ssh range<br/>python script"]
  node_sshbrute_random["ssh random<br/>python script<br/>[sshbrute_random.py]"]
  node_ftpbrute_iprange["ftp range<br/>python script"]
  node_ftpbrute_random["ftp random<br/>python script<br/>[ftpbrute_random.py]"]
  node_telnetbrute_iprange["telnet range<br/>python script"]
  node_smtpbrute_random["smtp random<br/>python script"]
  node_webauth_random_usersupport["web random<br/>python script"]
  node_wordpressbf["wordpress bf<br/>python script<br/>[wordpressbf.py]"]
  node_snmp_brute["snmp brute<br/>python script<br/>[snmp_brute.py]"]
end

subgraph group_remote["Remote targets"]
  node_ssh_service[("SSH<br/>remote service")]
  node_ftp_service[("FTP<br/>remote service")]
  node_telnet_service[("Telnet<br/>remote service")]
  node_mail_services[("Mail servers<br/>remote service")]
  node_mysql_service[("MySQL<br/>remote service")]
  node_web_login[("Web login<br/>remote auth")]
  node_wordpress_login[("WordPress<br/>remote auth")]
  node_snmp_agent[("SNMP<br/>remote service")]
  node_social_targets[("Social sites<br/>remote auth")]
  node_misc_targets[("Other targets<br/>remote service")]
end

node_operator -->|"selects"| node_ssh_suite
node_operator -->|"selects"| node_ftp_suite
node_operator -->|"selects"| node_telnet_suite
node_operator -->|"selects"| node_mail_suite
node_operator -->|"selects"| node_db_suite
node_operator -->|"selects"| node_web_suite
node_operator -->|"selects"| node_target_suite
node_operator -->|"selects"| node_misc_suite
node_ssh_suite -->|"includes"| node_sshbrute_fork
node_ssh_suite -->|"includes"| node_sshbrute_iprange
node_ssh_suite -->|"includes"| node_sshbrute_random
node_ftp_suite -->|"includes"| node_ftpbrute_iprange
node_ftp_suite -->|"includes"| node_ftpbrute_random
node_telnet_suite -->|"includes"| node_telnetbrute_iprange
node_mail_suite -->|"includes"| node_smtpbrute_random
node_web_suite -->|"includes"| node_webauth_random_usersupport
node_target_suite -->|"includes"| node_wordpressbf
node_misc_suite -->|"includes"| node_snmp_brute
node_sshbrute_fork -->|"auth attempts"| node_ssh_service
node_sshbrute_iprange -->|"auth attempts"| node_ssh_service
node_sshbrute_random -->|"auth attempts"| node_ssh_service
node_ftpbrute_iprange -->|"auth attempts"| node_ftp_service
node_ftpbrute_random -->|"auth attempts"| node_ftp_service
node_telnetbrute_iprange -->|"auth attempts"| node_telnet_service
node_smtpbrute_random -->|"auth attempts"| node_mail_services
node_webauth_random_usersupport -->|"auth attempts"| node_web_login
node_wordpressbf -->|"auth attempts"| node_wordpress_login
node_snmp_brute -->|"auth attempts"| node_snmp_agent
node_mail_suite -.->|"targets"| node_mail_services
node_db_suite -->|"targets"| node_mysql_service
node_web_suite -->|"targets"| node_web_login
node_target_suite -->|"targets"| node_social_targets
node_misc_suite -.->|"targets"| node_misc_targets

click node_sshbrute_fork "https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_fork.py"
click node_sshbrute_iprange "https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_iprange.py"
click node_sshbrute_random "https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_random.py"
click node_ftpbrute_iprange "https://github.com/rischanlab/bruteforce_py/blob/master/ftpbrute_iprange.py"
click node_ftpbrute_random "https://github.com/rischanlab/bruteforce_py/blob/master/ftpbrute_random.py"
click node_telnetbrute_iprange "https://github.com/rischanlab/bruteforce_py/blob/master/telnetbrute_iprange.py"
click node_smtpbrute_random "https://github.com/rischanlab/bruteforce_py/blob/master/smtpbrute_random.py"
click node_webauth_random_usersupport "https://github.com/rischanlab/bruteforce_py/blob/master/webauthbrute_random_usersupport.py"
click node_wordpressbf "https://github.com/rischanlab/bruteforce_py/blob/master/wordpressbf.py"
click node_snmp_brute "https://github.com/rischanlab/bruteforce_py/blob/master/snmp_brute.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_operator,node_ssh_suite,node_ftp_suite,node_telnet_suite,node_mail_suite,node_db_suite,node_web_suite,node_target_suite,node_misc_suite,node_sshbrute_fork,node_sshbrute_iprange,node_sshbrute_random,node_ftpbrute_iprange,node_ftpbrute_random,node_telnetbrute_iprange,node_smtpbrute_random,node_webauth_random_usersupport,node_wordpressbf,node_snmp_brute toneBlue
class node_ssh_service,node_ftp_service,node_telnet_service,node_mail_services,node_mysql_service,node_web_login,node_wordpress_login,node_snmp_agent,node_social_targets,node_misc_targets toneAmber
```

## Components

### Local Python scripts

Standalone brute-force entrypoint scripts and their variants

- **Operator**: human · Runs a chosen script with a target and candidates
- **SSH tools**: script family · SSH brute-force entrypoints and concurrency variants
- **FTP tools**: script family · FTP brute-force entrypoints and target-range/random variants
- **Telnet tools**: script family · Telnet brute-force entrypoints and variants
- **Mail tools**: script family · SMTP, POP, IMAP, NNTP, and Gmail-related brute-force scripts
- **Database tools**: script family · MySQL brute-force scripts and host-range/random variants
- **Web auth tools**: script family · Generic web login brute-force scripts
- **Target-specific tools**: script family · Scripts aimed at specific products or accounts
- **Misc tools**: script family · Other standalone brute-force or discovery scripts
- [ssh fork](https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_fork.py): python script · SSH brute-force variant with forked concurrency · `sshbrute_fork.py`
- [ssh range](https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_iprange.py): python script · SSH brute-force variant over an IP range · `sshbrute_iprange.py`
- [ssh random](https://github.com/rischanlab/bruteforce_py/blob/master/sshbrute_random.py): python script · SSH brute-force variant using randomization · `sshbrute_random.py`
- [ftp range](https://github.com/rischanlab/bruteforce_py/blob/master/ftpbrute_iprange.py): python script · FTP brute-force variant over an IP range · `ftpbrute_iprange.py`
- [ftp random](https://github.com/rischanlab/bruteforce_py/blob/master/ftpbrute_random.py): python script · FTP brute-force variant with randomized attempts · `ftpbrute_random.py`
- [telnet range](https://github.com/rischanlab/bruteforce_py/blob/master/telnetbrute_iprange.py): python script · Telnet brute-force variant over an IP range · `telnetbrute_iprange.py`
- [smtp random](https://github.com/rischanlab/bruteforce_py/blob/master/smtpbrute_random.py): python script · SMTP brute-force variant with randomized attempts · `smtpbrute_random.py`
- [web random](https://github.com/rischanlab/bruteforce_py/blob/master/webauthbrute_random_usersupport.py): python script · Web auth brute-force variant with random user support · `webauthbrute_random_usersupport.py`
- [wordpress bf](https://github.com/rischanlab/bruteforce_py/blob/master/wordpressbf.py): python script · WordPress-specific brute-force script · `wordpressbf.py`
- [snmp brute](https://github.com/rischanlab/bruteforce_py/blob/master/snmp_brute.py): python script · SNMP brute-force script · `snmp_brute.py`

### Remote targets

External services and login surfaces the scripts talk to

- **SSH**: remote service · Remote SSH authentication endpoint
- **FTP**: remote service · Remote FTP authentication endpoint
- **Telnet**: remote service · Remote Telnet authentication endpoint
- **Mail servers**: remote service · SMTP, POP, IMAP, NNTP, and Gmail login surfaces
- **MySQL**: remote service · Remote MySQL authentication endpoint
- **Web login**: remote auth · Generic web authentication surface
- **WordPress**: remote auth · WordPress admin or login surface
- **SNMP**: remote service · Remote SNMP service exposed to credential attempts
- **Social sites**: remote auth · Target-specific online account login surfaces
- **Other targets**: remote service · Additional protocol or service targets covered by the repo

## Connections

- Operator → SSH tools: selects · Chooses the SSH toolchain for an attack run
- Operator → FTP tools: selects · Chooses the FTP toolchain for an attack run
- Operator → Telnet tools: selects · Chooses the Telnet toolchain for an attack run
- Operator → Mail tools: selects · Chooses the mail-related toolchain for an attack run
- Operator → Database tools: selects · Chooses the database toolchain for an attack run
- Operator → Web auth tools: selects · Chooses the generic web-auth toolchain for an attack run
- Operator → Target-specific tools: selects · Chooses a target-specific toolchain for an attack run
- Operator → Misc tools: selects · Chooses a miscellaneous script for an attack run
- SSH tools → ssh fork: includes · Forked concurrency variant
- SSH tools → ssh range: includes · IP range variant
- SSH tools → ssh random: includes · Randomized variant
- FTP tools → ftp range: includes · IP range variant
- FTP tools → ftp random: includes · Randomized variant
- Telnet tools → telnet range: includes · IP range variant
- Mail tools → smtp random: includes · Randomized SMTP variant
- Web auth tools → web random: includes · Web-auth variant with random user support
- Target-specific tools → wordpress bf: includes · WordPress-specific brute-force script
- Misc tools → snmp brute: includes · SNMP brute-force script
- ssh fork → SSH: auth attempts · Sends SSH login attempts and checks responses
- ssh range → SSH: auth attempts · Brute-forces SSH across a host range
- ssh random → SSH: auth attempts · Brute-forces SSH with randomized candidates
- ftp range → FTP: auth attempts · Brute-forces FTP across a host range
- ftp random → FTP: auth attempts · Brute-forces FTP with randomized candidates
- telnet range → Telnet: auth attempts · Brute-forces Telnet across a host range
- smtp random → Mail servers: auth attempts · Brute-forces mail-related login surfaces
- web random → Web login: auth attempts · Submits web login attempts and inspects results
- wordpress bf → WordPress: auth attempts · Targets WordPress login endpoints
- snmp brute → SNMP: auth attempts · Sends SNMP credential attempts
- Mail tools → Mail servers: targets · Mail-family scripts all converge on remote mail services
- Database tools → MySQL: targets · Database scripts target MySQL endpoints
- Web auth tools → Web login: targets · Generic web-auth scripts target a web login boundary
- Target-specific tools → Social sites: targets · Specialized scripts target named online services and accounts
- Misc tools → Other targets: targets · Miscellaneous scripts hit other service boundaries
