Skip to content

naborajs/NS-X-DDOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ NS-XDDOS – NS Cyber Surge Engine ⚡

High-Performance Web Request Orchestration & Cyber Behavior Engine
Built for education, analysis, and professional-grade research – not for abuse.


⚠️ ETHICAL & LEGAL NOTICE
NS-X-DDOS (NS Cyber Surge Engine) is a professional educational tool.
It is made to understand traffic behavior, multi-threading, response patterns, and resilience of environments that you own or are explicitly allowed to analyze.

Using this tool on systems, servers, or networks without permission is illegal.
You alone are responsible for how you use it.


🔥 What is NS-X-DDOS?

NS-X-DDOS is an advanced network surge engine that:

  • Sends controlled waves of HTTP/HTTPS requests
  • Lets you observe how environments behave under different intensities
  • Helps you understand:
    • concurrent connections
    • latency behavior
    • timeout patterns
    • basic resilience characteristics

It is built as a learning & research framework, not a toy.


🧠 Feature Highlights

  • 🧵 Multi-threaded request engine
  • 🌐 Full HTTPS support
  • 📊 Rich terminal interface with structured summaries
  • 🎯 Configurable intensity: requests, threads & rounds
  • 🧮 Aggregated stats: success, timeouts, connection issues, responses
  • 🧪 Beginner → Advanced configuration flow
  • 📱 Works on Termux (Android), Windows, Linux, macOS

🖥 Supported Platforms

Platform Supported Notes
Android (Termux) Great for on-the-go learning
Windows 10/11 Run via CMD / PowerShell
Linux (Ubuntu/Kali etc.) Ideal for labs & VMs
macOS Works from Terminal
VPS / Cloud Only for authorized labs

📂 Project Structure (Recommended)

NS-X-DDOS/ ├─ nsx.py # Main engine script ├─ stats.py # Stats / aggregation logic (optional split) ├─ README.md # You are here ├─ requirements.txt # Python dependencies ├─ assets/ │ ├─ banner.txt # ASCII art / logo │ └─ screenshots/ # Screens / GIFs for repo └─ docs/ └─ index.html # (optional) static docs page


🚀 Step-by-Step Setup Guide (Any Device)

1️⃣ Install Python

🔹 Android (Termux)

pkg update && pkg upgrade
pkg install python git

Check:

python --version

🔹 Windows 10/11

  1. Download Python from the official website.

  2. During installation, tick: ✅ Add Python to PATH

  3. Open CMD or PowerShell, then:

python --version pip --version

🔹 Linux (Ubuntu / Debian / Kali)

sudo apt update
sudo apt install python3 python3-pip git -y

Use python3 instead of python if needed.

🔹 macOS

brew install python git

or use official .pkg installer from python.org


2️⃣ Clone the Repository

git clone https://github.com/YOUR-USERNAME/NS-X-DDOS.git
cd NS-X-DDOS

Replace YOUR-USERNAME with your GitHub profile name.


3️⃣ Install Dependencies

If you have a requirements.txt, use:

pip install -r requirements.txt

If you want to install manually (fallback):

pip install requests rich

💡 If you're on Termux and pip is not found, use pip3 instead.


4️⃣ Launch NS-XDDOS

From inside the project directory:

python nsx.py

(or python3 nsx.py depending on your system)

The engine will start an interactive session:

Ask for a target address

Ask for number of total actions

Ask for thread intensity

Ask for number of rounds

Everything is step-by-step, so even beginners can follow.


🔁 Auto-Update System

NS-X-DDOS comes with a built-in auto-update feature so you don’t need to manually download new versions every time.

When a new version is pushed to the repository:

  • The tool checks the latest version from the VERSION file on GitHub
  • Compares it with your local version
  • If an update is available, it lets you pull it automatically

🔧 How to Check for Updates

From inside the project folder:

python nsx.py --update

or

python nsx.py -u

🎛 Usage Flow – Beginner → Advanced

🟢 Beginner Mode (Safe Learning)

Use this if you’re new:

Threads: 5–10

Total actions: 50–150

Rounds: 1

Goal here: Understand how the statistics move:

successful actions

timeouts

connection issues

overall timing


🟡 Intermediate Mode (Serious Exploration)

Once you’re comfortable:

Threads: 15–30

Total actions: 200–500

Rounds: 1–3

Now you start to see:

behavior fluctuations

when environments start getting slower

how timeouts increase

Use only on:

your deployments

lab environments

explicit permission-based systems


🔴 Advanced Mode (Power Users Only)

This is high intensity mode. Use only if:

You understand concurrency, networks & HTTP behavior

You’re operating in a controlled, authorized environment

Here you tune:

Threads: high, but calculated

Total actions: large scale

Rounds: multiple

⚠️ This is where you treat NS-X-DDOS as a professional instrument, not a script.


📊 Example Output (Conceptual)

🚀 Round #2: Sending operations ━━━━━━━━━━━━━━━━━ 100% 0:00:03

     Round #2 – Surge Summary for
          https://your-domain.com

┌────────────────────────────────┬───────────────┐ │ Total Actions │ 500 │ ├────────────────────────────────┼───────────────┤ │ Successful (200) │ 472 │ ├────────────────────────────────┼───────────────┤ │ Timeouts │ 18 │ ├────────────────────────────────┼───────────────┤ │ Connection Issues │ 10 │ ├────────────────────────────────┼───────────────┤ │ Other Responses │ 0 │ ├────────────────────────────────┼───────────────┤ │ Elapsed Time (s) │ 12.341 │ ├────────────────────────────────┼───────────────┤ │ Avg Response Time (s) │ 0.221 │ ├────────────────────────────────┼───────────────┤ │ Min / Max RT (s) │ 0.050 / 1.982 │ ├────────────────────────────────┼───────────────┤ │ Median RT (s) │ 0.179 │ ├────────────────────────────────┼───────────────┤ │ P95 RT (s) │ 0.691 │ ├────────────────────────────────┼───────────────┤ │ Operations per Second │ 40.51 │ └────────────────────────────────┴───────────────┘ ╭─────────────────────────── Health Snapshot ─────────────────────────╮ │ Overall State: STABLE │ │ Details: Mostly successful, few timeouts at higher intensity │ │ Last Seen: HTTP 200 │ ╰──────────────────────────────────────────────────────────────────────╯


🧩 Tips for Responsible & Professional Use

✅ Always have permission for any environment you work on

✅ Start low, grow slowly, observe behavior

✅ Treat NS-X-DDOS as a learning & diagnostic instrument

❌ Never point it at random sites, services, or people

❌ Don’t try to “flex” with it on public infrastructure

Remember: Real professionals don’t show off their tools on unauthorized targets.


🕯 A Note for Those Who Arrive Here

If you're reading this, understand something clearly:

This project is not here to impress everyone —
only the few who recognize potential when they see it.

Some will scroll past.
Some will question it.
A very small number will stay —
and those are the ones this exists for.

Nothing here asks for attention. Nothing here explains itself loudly. Nothing here tries to convince you.

Tools like this aren’t advertised — they're claimed by those who know how to read between the lines.

So before you continue… pause.

Ask yourself one question:

"Did I find this tool — or did it find me?"


💖 Support the Project – Keep Ghost Engine Alive

Ghost Engine v4 (and tools like NS-X-DDOS in the ecosystem) took time, passion, research, refinement, and love to build.

If this project:

protects your privacy

helps you grow in cybersecurity

inspires your learning journey

…then consider supporting its development.

Your contribution:

Helps maintain future updates 🛠

Funds new features, optimization & deeper refinement

Supports open-source security & research utilities

Motivates continued development 💙

There is no pressure and no expectation — only appreciation if you choose to help.


🪙 Donation Addresses

Cryptocurrency Address
Bitcoin (BTC) bc1q5zapes7euft2lrk7ylpwj90p8y4ctmadn285du
Solana (SOL) HTgZhMCd5pf474macjkHhrrJmQhczGPfrGwNaRFL7Pqc
Ethereum (ETH) 0x51c356fb219117e388b85c5fa734e6ae1a3f8df6

✨ Even the smallest support means something — not because of the amount…

but because it tells me:

"Someone out there believes in this project."

Thank you for being here — and thank you for keeping the Ghost alive 👻💙




⟡ The Creator ⟡

Sometimes a tool reveals the mind of the one who built it.
If you want to understand this project, understand the person behind it.


Nishant Sarkar — NS GAMMING

🇮🇳 Siliguri, West Bengal
💠 Identity: Developer | Creator | Learner ✅ Website: nsgamming.xyz


⟡ Connect ⟡

Platform Link
🌐 Website https://nsgamming.xyz
🎥 YouTube https://youtube.com/@Nishant_sarkar
📸 Instagram https://instagram.com/nishant_sarkar__10k
📨 Email nishant.ns.business@gmail.com
💬 Telegram @Nishantsarkar10k / @Nishantsarkar100k
🐦 Twitter (X) https://x.com/NSGAMMING699
💬 WhatsApp Channel https://whatsapp.com/channel/0029Vb4QTP7GE56sVeiOJJ1i
💻 GitHub https://github.com/ns-gamming
🧵 Discord https://discord.gg/eRnfcBuv5v

⟡ A Final Thought ⟡

Not everyone who reaches the end understands the beginning.
Some simply read. Some explore. A few return with purpose.

If you're one of those few — you already know what comes next.


⚫ End of Document • NS-X

About

⚡ High-Performance Multi-Threaded Web Request & Stress-Testing Framework — Built for Ethical Research, Load Testing & Cybersecurity Education.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages