Skip to content
college-archivePublic

About

CSE 194 - Worm Project

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Here’s a clean and informative README.md for your educational worm project, explaining its purpose, setup, usage, and ⚠️ safety disclaimer.


🐛 Educational Python Worm – Proof of Concept

This is a cross-platform educational worm built for cybersecurity learning purposes. It demonstrates how malware can self-replicate, hide, persist, and communicate with a command-and-control (C2) server — all inside a safe and controlled environment (e.g., a virtual machine).


🚀 Features

  • ✅ Cross-platform: Windows, macOS, Linux
  • 🔁 Continuous self-replication
  • 📁 Spreads across system/user folders
  • 💽 USB propagation
  • 📡 Sends system info to dashboard server
  • 🧱 Adds persistence (autostart on login)
  • 🕹️ Server dashboard with:
    • Web-based infection viewer
    • Kill switch to remotely shut down worms
    • Map view of infected IPs (GeoIP-based)

⚠️ DISCLAIMER

This project is for educational purposes only.
Do NOT deploy or run this outside of a sandboxed virtual machine.
Use it to learn, not to harm.
You are responsible for any misuse.


📦 Project Structure

.
├── worm.py                # Main worm script (client)
├── server_dashboard.py    # Flask-based C2 dashboard
├── templates/             # (Optional) HTML templates
├── requirements.txt       # Python dependencies
└── README.md              # You are here

🖥️ Server Setup (Dashboard)

📌 Requirements:

  • Python 3
  • Flask
  • geocoder (for IP → location)

💡 Install:

pip install flask geocoder

▶️ Run the Server:

python server_dashboard.py

Open http://localhost:5000 to view:

  • Infection logs
  • Geolocation map
  • Kill switch

🧬 Worm Setup (Client)

💡 On a VM (test safely):

python worm.py

The worm will:

  • Replicate across folders
  • Send data to server
  • Spread to USBs
  • Run on boot
  • Check kill switch

☠️ Remote Kill Switch

To kill all worms:

  1. Go to your dashboard.
  2. Toggle the kill switch to "ON".
  3. All active worms will stop running on next check.

🌍 Infection Map

The dashboard uses public IPs to:

  • Plot infected clients on a world map
  • Visualize global spread (if run in multi-VM test lab)

✅ Safe Testing Checklist

  • Run server locally (on VM host)
  • Run worm on isolated VM (VirtualBox, VMware, etc.)
  • Disconnect VM network if needed
  • Delete worm and replication folders after demo

👨‍🏫 Educational Use Cases

  • Malware analysis practice
  • Red team exercises
  • Security presentations
  • CS or cybersecurity coursework

Let me know if you want a demo video script, screenshot pack, or PyInstaller bundle (.exe / .app / .elf) for full realism.

About

CSE 194 - Worm Project

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages