Skip to content

Codeguruu03/CyberSuite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

22 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›‘οΈ CyberSuite

A Comprehensive Python-Based Cybersecurity Toolkit

Python Version License Platform Maintained


πŸ“– About

CyberSuite is a powerful, user-friendly cybersecurity toolkit that brings essential security testing tools into a single, cohesive Python application. Designed for security professionals, penetration testers, and cybersecurity enthusiasts, CyberSuite simplifies complex security operations with an intuitive command-line interface.

✨ Key Features

  • 🎨 Beautiful CLI Interface - Colorized output with ASCII art banners
  • πŸ›‘οΈ 9 Security Tools - Comprehensive toolkit for penetration testing and security analysis
  • βœ… Input Validation - Comprehensive validation to prevent errors
  • πŸ”’ Security Warnings - Built-in deprecation warnings for outdated algorithms
  • πŸš€ Cross-Platform - Works on Windows, Linux, and macOS
  • πŸ“¦ Easy Installation - Install with pip install cybersuite
  • 🎯 Educational Focus - Perfect for learning cybersecurity concepts
  • πŸ” Advanced Hashing - Supports MD5, SHA-1, SHA-256, SHA-512, and BLAKE2b

πŸ› οΈ Tools Included

1. πŸ” GuardGenie - Password Generator & Analyzer

Generate strong, unique passwords based on personal details and analyze password strength using entropy-based calculations.

Features:

  • Generate 100+ password variations
  • Entropy-based strength analysis
  • Leetspeak transformations
  • Common substitutions (iβ†’1, eβ†’3, aβ†’@, etc.)
  • Color-coded strength indicators

2. πŸ–ΌοΈ StegGenie - Steganography Tool

Hide and extract secret messages within images using LSB (Least Significant Bit) steganography.

Features:

  • Hide text messages in images
  • Hide entire file contents in images
  • Extract hidden messages from images
  • Supports PNG, JPG, BMP, and more

3. 🌐 ScanGenie - Network Scanner

Perform comprehensive network reconnaissance using Nmap integration.

Features:

  • 9 different scan types (SYN, TCP, UDP, etc.)
  • Version detection
  • Service identification
  • Port state analysis
  • Tabular result display

4. #️⃣ HashGenie - Hash Generator

Generate cryptographic hashes for messages and files with security warnings for deprecated algorithms.

Features:

  • MD5, SHA-1, SHA-256 support
  • File and message hashing
  • Security warnings for broken algorithms
  • Hash file export

πŸ“₯ Installation

Method 1: Install from PyPI (Recommended)

# Install CyberSuite
pip install cybersuite

# Install with WiFi scanning support (optional)
pip install cybersuite[wifi]

Method 2: Install from Source

# Clone the repository
git clone https://github.com/Codeguruu03/CyberSuite.git
cd CyberSuite

# Install the package
pip install -e .

# Or use the setup script (Linux/macOS)
chmod +x setup.sh
./setup.sh

Prerequisites

  • Python 3.7+ - Required
  • Nmap - Required for ScanGenie (network scanner)
  • WiFi Adapter - Optional, for WiFiGenie

Installing Nmap

Linux (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install nmap

macOS (Homebrew):

brew install nmap

Windows: Download and install from nmap.org


πŸš€ Usage

After pip installation

# Run CyberSuite main menu
cybersuite

# Or run individual tools directly
guardgenie      # Password Generator
steggenie       # Steganography
scangenie       # Network Scanner
hashgenie       # Hash Generator
sqlgenie        # SQL Injection Tester
wifigenie       # WiFi Scanner
webgenie        # Web Directory Scanner
crackgenie      # Password Cracker
netgenie        # Network Utility

If running from source

python main.py

Main Menu

You'll be greeted with the main menu:

                     _____       _              _____        _  _        
                    / ____|     | |            / ____|      (_)| |       
                   | |      _   | |__    ___  | (___   _   _ _ | |_  ___ 
                   | |      | | | |_ \  / _ \  \___ \ | | | | || __|/ _ \
                   | |____  | |_| |  | ||  __/  ____) || |_| | || |_|  __/
                    \_____|  \__, |_|  | \___| |_____/  \__,_|_| \__|\___|
                              __/ |                                       
                             |___/                                        

Welcome to Cyber-Suite! πŸ™

Please select an option:
1. GuardGenie - Password Generator & Analyzer
2. StegGenie - Steganography Tool
3. ScanGenie - Network Scanner (Nmap)
4. HashGenie - Hash Generator
5. SQLGenie - SQL Injection Tester
6. WiFiGenie - WiFi Network Scanner
7. WebGenie - Web Directory Scanner
8. CrackGenie - Password Hash Cracker
9. NetGenie - Network Utility (Netcat)
10. Quit

πŸ“š Tool Usage Examples

πŸ” GuardGenie - Password Generator

# Start GuardGenie
Select option 1 from main menu

# Example usage:
First name: John
Last name: Smith
Birthdate (YYYY-MM-DD): 1990-05-15
[skip other questions by pressing Enter]

# Output: Table with generated passwords and strength ratings

Sample Output:

Password                    | Strength
----------------------------|-------------
JohnSmith                  | Moderate
JohnSmith123               | Strong
Sm1th@1990                 | Very Strong
John$mith                  | Strong

πŸ–ΌοΈ StegGenie - Steganography

Hiding a Message:

# Select option 2 from main menu
Choose an option:
1. Hide text in an image
2. Extract text from an image

# Choose option 1, then:
1. Message
2. File

Enter the message you want to hide: Secret meeting at midnight
Enter the path to the image: photo.png

# Output: photo_hidden.png created

Extracting a Message:

# Choose option 2
Enter the path to the image: photo_hidden.png

# Output: Extracted text from the image: Secret meeting at midnight

🌐 ScanGenie - Network Scanner

# Select option 3 from main menu
Enter the target IP address or hostname: 192.168.1.1

Choose a scan type:
1. SYN scan
2. TCP connect scan
3. UDP scan
[... more options ...]

Enter the option number: 2

# Output: Tabular display of open ports, services, and versions

Sample Output:

Host          | State | Protocol | Port | Service | Version
--------------|-------|----------|------|---------|----------
192.168.1.1   | up    | tcp      | 22   | ssh     | OpenSSH 7.9
192.168.1.1   | up    | tcp      | 80   | http    | nginx 1.18

#️⃣ HashGenie - Hash Generator

Hash a Message:

# Select option 4 from main menu
Choose an option:
1. Hash a message
2. Hash a file

# Select 1
Enter the message to hash: MySecretPassword

Choose a hash algorithm:
1. MD5 (⚠️ Cryptographically broken - for legacy use only)
2. SHA-1 (⚠️ Cryptographically broken - for legacy use only)
3. SHA-256 (βœ“ Recommended)

# Select 3
Hash value: 5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8

Hash a File:

# Select option 2
Enter the path to the file: document.pdf

# Same hash algorithm selection
# Output: Hash saved to document_hash.pdf

⚠️ Security & Legal Disclaimer

IMPORTANT: This tool is intended for educational purposes and authorized security testing only.

Legal Requirements:

  • βœ… Only use on systems you own or have explicit permission to test
  • βœ… Obtain written authorization before any security testing
  • ❌ Unauthorized access to computer systems is illegal

Security Warnings:

  • MD5 and SHA-1 are cryptographically broken - use SHA-256 or higher for security
  • Some scan types require root/administrator privileges
  • Network scans may trigger IDS/IPS alerts

The developers assume NO liability for misuse of this software.


🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow PEP 8 style guidelines
  • Add comprehensive error handling
  • Include docstrings for all functions
  • Test on multiple platforms when possible
  • Update README for new features

πŸ“‹ Requirements

pywifi
stegano
requests
argparse
tabulate
colorama
pyfiglet
python-nmap

πŸ› Known Issues

  • WiFi scanning may require elevated privileges on some systems
  • Nmap must be installed separately (not included in pip dependencies)
  • Some steganography operations may fail with very large files

πŸ—ΊοΈ Roadmap

  • Add GUI interface
  • Implement result export (JSON/CSV)
  • Add more hash algorithms (SHA-512, BLAKE2)
  • Web directory brute-forcing tool
  • SQL injection testing tool
  • Password hash cracking tool
  • Report generation (PDF/HTML)

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2024 Naman Goyal

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...

πŸ‘¨β€πŸ’» Author

Naman Goyal


πŸ™ Acknowledgments

  • Nmap - Network scanning capabilities
  • Stegano - LSB steganography implementation
  • Colorama - Cross-platform colored terminal text
  • PyFiglet - ASCII art text generation
  • All contributors and users of CyberSuite

πŸ“ž Support

If you encounter any issues or have questions:

  1. Check the Issues page
  2. Create a new issue with detailed information
  3. Include your OS, Python version, and error messages

Built with ❀️ for the cybersecurity community

⭐ Star this repository if you find it helpful!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •