Skip to content

Commit 6a77ea7

Browse files
nayandas69nayandas69
committed
HashiramaCells
0 parents  commit 6a77ea7

File tree

10 files changed

+519
-0
lines changed

10 files changed

+519
-0
lines changed

‎.gitignore‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Virtual environment
2+
.venv
3+
4+
# Ignore Python cache files
5+
__pycache__/
6+
7+
# Ignore VS Code settings
8+
.vscode/
9+
*.code-workspace

‎Instructions.md‎

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
# **PyDoS - Advanced Stress Tester**
2+
3+
## **Introduction**
4+
PyDoS is a **powerful and user-friendly stress testing tool** designed for **ethical website performance testing**. It includes **multi-threaded attacks, headless browser-based simulations, captcha bypass, and proxy support** to test website load capacities.
5+
6+
**WARNING:** **Unauthorized use of this tool is strictly prohibited and may result in legal consequences.**
7+
8+
## **Features**
9+
- **Multi-threaded HTTP Attack** (GET/POST)
10+
- **Headless Browser-Based Testing** (**Selenium Stealth Mode**)
11+
- **Captcha Bypass** (**Anti-Captcha API**)
12+
- **Proxy & Non-Proxy Support**
13+
14+
## **Installation Guide**
15+
16+
### **1. Clone the Repository**
17+
```bash
18+
git clone https://github.com/nayandas69/pydoS.git
19+
cd pydoS
20+
```
21+
22+
### **2. Install Dependencies**
23+
```bash
24+
pip install -r requirements.txt
25+
```
26+
27+
Then, also install Playwright browsers:
28+
```bash
29+
playwright install
30+
```
31+
32+
### **3. Run the Tool**
33+
```bash
34+
python pydoS.py
35+
```
36+
37+
## **How to Use PyDoS & Available Commands & Examples**
38+
39+
### **1. Basic HTTP Attack (GET Method)**
40+
```bash
41+
python pydoS.py https://example.com -t 500 -m GET
42+
```
43+
44+
### **2. POST Request Attack**
45+
```bash
46+
python pydoS.py https://example.com -t 300 -m POST
47+
```
48+
49+
### **3. Enable Proxy Support**
50+
```bash
51+
python pydoS.py https://example.com -t 500 -m GET --proxy
52+
```
53+
54+
### **4. Enable Headless Browser Attack**
55+
```bash
56+
python pydoS.py https://example.com -t 500 -m GET --browser
57+
```
58+
59+
### **5. Enable Captcha Bypass**
60+
```bash
61+
python pydoS.py https://example.com -t 500 -m GET --captcha
62+
```
63+
64+
### **6. Run with Browser & Captcha**
65+
```bash
66+
python pydoS.py https://example.com -t 1000 -m POST --browser --captcha
67+
```
68+
69+
### **7. Run with ALL Features (Max Stress Test)**
70+
```bash
71+
python pydoS.py https://example.com -t 1000 -m POST --browser --captcha --proxy
72+
```
73+
74+
## **Legal Disclaimer**
75+
> **WARNING:** This tool is intended for **educational purposes and ethical testing only**.
76+
> **DO NOT** use this tool to attack websites you do not own. **Unauthorized usage is illegal.**
77+
> **Use responsibly. You are responsible for your actions.**
78+
79+
80+
## **What the Author Says**
81+
> "I built PyDoS for **security professionals and developers** to stress test their own websites in a **controlled and ethical manner**. If you are using this tool, **ensure that you have legal permission** to test the target website. Stay responsible, and always act within legal and ethical guidelines." – **Nayan Das**
82+
83+
84+
## **Contact & Support**
85+
- **Author:** [Nayan Das](https://github.com/nayandas69)
86+
- **Email:** [nayanchandradas@hotmail.com](mailto:nayanchandradas@hotmail.com)
87+
- **Website:** [https://nayanchandradas.com](https://socialportal.nayanchandradas.com)
88+
- **Report Issues:** [GitHub Issues](https://github.com/nayandas69/pydoS/issues)
89+
90+
**Happy Testing & Stay Ethical!**

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 nayandas69
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 187 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,187 @@
1+
# **PyDoS - Advanced Stress Tester**
2+
3+
## **What is PyDoS?**
4+
PyDoS is an **advanced stress testing tool** designed for **testing** the **performance and security** of your **own websites**.
5+
It supports **multi-threaded HTTP attacks**, **headless browser-based attacks**, **captcha bypassing**, and **proxy rotation**.
6+
7+
![PyDoS](assets/PyDoS.gif)
8+
9+
---
10+
## **LEGAL DISCLAIMER**
11+
> **WARNING!** This tool is intended for **educational purposes and ethical testing only**.
12+
> **DO NOT** use this tool to attack websites you do not own. Unauthorized usage is **illegal** and may result in **serious legal consequences**.
13+
> **USE RESPONSIBLY!** You are responsible for your actions.
14+
15+
---
16+
17+
# **Features**
18+
- **Multi-threaded HTTP attack** (GET/POST)
19+
- **Headless browser attack** (Selenium & Playwright)
20+
- **Captcha bypass** (Anti-Captcha API)
21+
- **User input support** (Fully customizable)
22+
- **Proxy support** (For IP rotation)
23+
- **Custom User-Agent rotation** (Avoids easy blocking)
24+
- **Test your website under high traffic**
25+
26+
---
27+
28+
# **Setup & Installation**
29+
## **1. Install Required Dependencies**
30+
Run the following commands in your **VS Code terminal** (Command Prompt / PowerShell):
31+
32+
```bash
33+
git clone https://github.com/nayandas69/pydoS.git
34+
cd pydoS
35+
```
36+
37+
```bash
38+
pip install -r requirements.txt
39+
```
40+
41+
Then, install Playwright browsers:
42+
```bash
43+
playwright install
44+
```
45+
46+
---
47+
48+
## **2. Run PyDoS with Commands**
49+
### **Basic Attack (GET Method)**
50+
```bash
51+
python pydoS.py https://yourwebsite.com -t 500 -m GET
52+
```
53+
- Sends **500 concurrent GET requests** to `https://yourwebsite.com`.
54+
55+
### **POST Request Attack**
56+
```bash
57+
python pydoS.py https://yourwebsite.com -t 300 -m POST
58+
```
59+
- Sends **300 concurrent POST requests**.
60+
61+
---
62+
63+
## **3. Enable Advanced Features**
64+
### **Proxy Support**
65+
```bash
66+
python pydoS.py https://yourwebsite.com -t 500 -m GET --proxy
67+
```
68+
- Uses **proxy rotation** from `config.py`.
69+
70+
### **Headless Browser Attack (Selenium & Playwright)**
71+
```bash
72+
python pydoS.py https://yourwebsite.com -t 500 -m GET --browser
73+
```
74+
- Simulates **real users visiting the site** in a **headless browser**.
75+
76+
### **Captcha Bypass**
77+
```bash
78+
python pydoS.py https://yourwebsite.com -t 500 -m GET --captcha
79+
```
80+
- **Solves captchas** automatically using **Anti-Captcha API**.
81+
82+
### **Headless Browser & Captcha Bypass**
83+
```bash
84+
python pydoS.py https://yourwebsite.com -t 1000 -m POST --browser --captcha
85+
```
86+
- Uses **1000 threads**
87+
- Uses **POST requests**
88+
- Enables **headless browsers**
89+
- **Bypasses captchas**
90+
91+
### **Ultimate Attack (All Features)**
92+
```bash
93+
python pydoS.py https://yourwebsite.com -t 1000 -m POST --browser --captcha --proxy
94+
```
95+
- Uses **1000 threads**
96+
- Uses **POST requests**
97+
- Enables **headless browsers**
98+
- **Bypasses captchas**
99+
- **Uses proxies**
100+
101+
---
102+
103+
# **Configuration Settings (config.py)**
104+
### **Modify default settings in `config.py`**
105+
```python
106+
# Default Configuration Settings
107+
DEFAULT_TARGET = "https://yourwebsite.com"
108+
DEFAULT_THREADS = 500
109+
DEFAULT_METHOD = "GET"
110+
DEFAULT_TIMEOUT = 5
111+
DEFAULT_USE_PROXY = False
112+
DEFAULT_PROXIES = ["http://127.0.0.1:8080"]
113+
DEFAULT_USE_BROWSER_ATTACK = False
114+
DEFAULT_USE_CAPTCHA_BYPASS = False
115+
```
116+
117+
---
118+
119+
# **How PyDoS Works**
120+
### **1. Multi-Threaded HTTP Attack**
121+
- Sends **multiple HTTP requests** to stress-test a website.
122+
- Simulates **high traffic loads**.
123+
124+
### **2. Headless Browser Attack**
125+
- Uses **Selenium + Playwright** to **simulate real user behavior**.
126+
- Avoids **bot detection**.
127+
128+
### **3. Captcha Bypass**
129+
- Uses **Anti-Captcha API** to **solve captchas automatically**.
130+
131+
### **4. Proxy Support**
132+
- **Rotates IP addresses** to avoid detection.
133+
134+
---
135+
136+
# **FAQ**
137+
### **1. Is this tool illegal?**
138+
> **NO, if used ethically!** PyDoS is for **testing your own website's security**.
139+
> **ILLEGAL if used maliciously!** **Do not** attack unauthorized websites.
140+
141+
### **2. I get a ‘No module named distutils’ error**
142+
Run:
143+
```bash
144+
pip install setuptools
145+
```
146+
147+
### **3. How do I enable real browser-based testing?**
148+
Run:
149+
```bash
150+
python pydoS.py https://yourwebsite.com -t 500 -m GET --browser
151+
```
152+
153+
---
154+
155+
# **Ethical Usage Notice**
156+
> **USE ONLY FOR TESTING YOUR OWN WEBSITE!**
157+
> **DO NOT ATTACK OTHER WEBSITES WITHOUT PERMISSION!**
158+
> **FAILURE TO COMPLY MAY LEAD TO LEGAL CONSEQUENCES!**
159+
> **BE RESPONSIBLE & STAY ETHICAL!**
160+
161+
---
162+
163+
# **Author Information**
164+
- **Author:** [Nayan Das](https://github.com/nayandas69)
165+
- **Email:** [nayanchandradas@hotmail.com](mailto:nayanchandradas@hotmail.com)
166+
- **Website:** [https://nayanchandradas.com](https://socialportal.nayanchandradas.com)
167+
168+
---
169+
170+
# **Contributing**
171+
Want to improve PyDoS? Feel free to contribute!
172+
```bash
173+
git clone https://github.com/nayandas69/pydoS.git
174+
cd pydoS
175+
```
176+
Make your changes and submit a **Pull Request**
177+
178+
---
179+
180+
# **Support**
181+
If this tool helped you, give it a ⭐ on GitHub!
182+
For issues, contact me at **nayanchandradas@hotmail.com**
183+
184+
---
185+
186+
**Built with ❤️ by nayandas69**
187+
**Happy Testing & Stay Ethical!**

‎assets/PyDoS.gif‎

25 MB
Loading

‎config.py‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# PyDoS Configuration
2+
3+
# ============================================================
4+
# APP_INFO Dictionary (Do Not Modify)
5+
# ------------------------------------------------------------
6+
# This dictionary contains essential metadata about the PyDoS
7+
# application, including the application's name, author,
8+
# contact details, version, and license.
9+
# Modifying this section may violate attribution rights
10+
# and is strongly discouraged.
11+
# ============================================================
12+
APP_INFO = {
13+
"name": "PyDoS - Advanced Stress Tester",
14+
"author": "Nayan Das",
15+
"email": "nayanchandradas@hotmail.com",
16+
"website": "https://socialportal.nayanchandradas.com",
17+
"version": "1.0",
18+
"license": "MIT",
19+
}
20+
21+
# Default settings for the application
22+
DEFAULT_TARGET = "https://yourwebsite.com"
23+
DEFAULT_THREADS = 500
24+
DEFAULT_METHOD = "GET" # GET, POST
25+
DEFAULT_TIMEOUT = 5
26+
DEFAULT_USE_PROXY = False
27+
DEFAULT_PROXIES = ["http://127.0.0.1:8080"]
28+
DEFAULT_USE_BROWSER_ATTACK = False
29+
DEFAULT_USE_CAPTCHA_BYPASS = False

0 commit comments

Comments
 (0)