HashCrack-Pro

HashCrack-Pro is a command-line tool for educational password hash cracking. It supports multiple attack modes — dictionary, rule-based, and brute-force — with features like salted hashes, PBKDF2 iterations, and parallel CPU processing.

⚠️ Please use responsibly and only on hashes you have explicit permission to test.

🚀 Usage

Once installed, you can run the tool directly from the command line.

python HashCrack-Pro.py --hash-file targets.txt --dict wordlist.txt

🧪 Quick Example

# 1. Create a file with a hash to crack (MD5 of "hello")
echo "md5:5d41402abc4b2a76b9719d911017c592" > targets.txt

# 2. Create a small wordlist
echo -e "12345\nhello\npassword" > words.txt

# 3. Run HashCrack-Pro with the wordlist
python HashCrack-Pro.py --hash-file targets.txt --dict words.txt

Expected output:

[+] 5d41402abc: hello (alg=md5 salt=None iter=100000)

This shows the tool successfully cracked the MD5 hash of the word hello.

📌 Installation & Dependencies

HashCrack-Pro is built using only the Python standard library — no external packages are required.
If you later want to extend the tool (e.g., add support for bcrypt or Argon2), you can add those libraries to the requirements.txt file and install them with:

pip install -r requirements.txt

✨ Features

• Can try to crack different kinds of hashes (MD5, SHA1, SHA256, SHA512, PBKDF2-SHA256).
• Works with normal wordlists, simple rules that change the words a bit, or tries every possible password with brute force.
• Can use salts and repeat hashing (iterations) if the hash needs it.
• Uses your computer’s cores to go faster when testing passwords.
• Shows the result in the terminal in a clear way.
• Handles big wordlists without running out of memory.

⚙️ Tech Stack

• Python 3 — The main programming language used to build the tool.
• hashlib — Lets the program create and compare different kinds of hashes.
• argparse — Helps read and handle command line options from the user.
• concurrent.futures — Makes the program run faster by using more than one CPU core.
• itertools & string — Used to generate possible password guesses for brute force mode.

🖥️ Contact

• GitHub: github.com/cyristal-gems
• LinkedIn: linkedin.com/in/cyristalj