Automated decryption tool using machine learning & common sense
Project description
What is this?
Ciphey is an automated decryption tool. You put in encrypted text, and it outputs the decrypted text.
"What type of encryption?"
That's the point. You don't know. Ciphey will find out and do it for you.
How does it work?
You input a string (via a file, or via a terminal)
Ciphey uses a Deep Neural Network to create a probability distribution (softmax).
This distribution gives how likely it is to be a hash, a basic encoding (hex, binary) or encryption (such as caeser, aes etc) Ciphey will then work through each cipher to try and decode it.
Ciphey uses the language module (app/languageChecker) to determine both the language something is written in, and whether or not that string is valid in that language. So Ciphey would say "hello my name is whiteboard" is English. But it wouldn't say "iaid i2iv ria9i" is a language.
Using the probability distribution, Ciphey calls each object on a new thread. Yes, Ciphey is multi-threaded.
Ciphey is designed from the groundup to be as fast as physically possible. The second it sees the answer, it will stop and return that answer.
What encryptions can Ciphey deal with?
Not just encryptions, but hashes and encodings too.
- Vigenère cipher
- Affine cipher
- Transposition Cipher
- Pig Latin
- Morse Code
- Ascii
- Binary
- Base64
- Hexadecimal
- Caesar Cipher
- Reverse (palindrome)
- Sha512
- MD5
- Sha1
- Sha384
- Sha256
How to install
Just download the GitHub repo.
How to use
pip install -r requirements.txt
And then
python3 main.py -t "Encrypted Text Here"
The internal data packet
This is the data packet specification Ciphey uses. To pass data around the different modules and to language checker, it is neccesary to use an internal data packet.
{"lc": self.lc, "IsPlaintext?": True, "Plaintext": translated, "Cipher": "Caesar", "Extra Information": "The rotation used is {counter}"}
How to contribute
Ciphey is always in need of more decryption tools!
- Write a decryption tool (this can include encodings such as Base64 too). Make sure it has a
decrypt
function and is a class. - For each possible decryption, call
self.lc.checkLanguage(translated)
wheretranslated
is the decrypted text. Note by default, all decryption modules when instantiated get passed Language Checker (lc). Look at this for example:
def __init__(self, lc):
self.lc = lc
- If result returns
True
, it is successfully decrypted to English. Return the internal data packet but make sure to change the information to match your decryption module. - Create a new object in the parent class. For example, in Encoding the parent is
encodingParent.py
. Simply add your object to the list of other objects. ForencodingParent.py
this list of objects is currently:
self.binary = Binary(self.lc)
self.base64 = Base64(self.lc)
self.ascii = Ascii(self.lc)
self.hex = Hexadecimal(self.lc)
self.morse = MorseCode(self.lc)
- It'd be nice if you wrote some tests for it, but if you don't know much about testing no worries! I can write the tests for you :)
- I'll put your name on the list of contributors!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.