Skip to main content

cipherid

A small, dependency-free teaching package that guesses a few common text encodings and classical ciphers. It can recognize Base64, hexadecimal, URL percent-encoding, ROT13, some Caesar shifts, and plain English text.

Modern encryption such as AES is designed to look random. The package cannot reliably tell which modern cipher was used or recover its plaintext without the right key. Its language guesses are also uncertain for short samples.

Use it from Python

From the project directory:

from cipherid import identify

for guess in identify("SGVsbG8gd29ybGQ="):
    print(guess.name, guess.decoded)

To inspect a text file from Python:

from cipherid import identify_file

for guess in identify_file("sample.txt"):
    print(guess.name, guess.decoded)

Command line

python -m cipherid "SGVsbG8gd29ybGQ="
python -m cipherid --file sample.txt

TRAINING_EXAMPLES in __init__.py provides 5,000 reproducible labeled examples: 1,000 generated English phrases, each represented as plain text, Base64, hexadecimal, URL percent-encoding, and ROT13. You can inspect them from Python:

from cipherid import TRAINING_EXAMPLES

print(len(TRAINING_EXAMPLES))  # 5000
print(TRAINING_EXAMPLES[:5])

These examples demonstrate known transformations; they are not examples of modern encryption like AES. The detector uses structural checks for the formats it supports, rather than training a statistical model on this synthetic dataset. Modern encryption is designed to hide patterns, and identifying it generally requires metadata or the key.

Metadata

Release files for cipherid-vwlau 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cipherid-vwlau 0.1.0
File Size Uploaded Provenance Actions
cipherid_vwlau-0.1.0.tar.gz 4.7 kB Without provenance Details for cipherid_vwlau-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cipherid-vwlau 0.1.0
File Interpreter ABI Platform Actions
cipherid_vwlau-0.1.0-py3-none-any.whl Python 3 none any Details for cipherid_vwlau-0.1.0-py3-none-any.whl

Total release size: 10.9 kB

Release files / cipherid_vwlau-0.1.0.tar.gz

Download URL cipherid_vwlau-0.1.0.tar.gz
Size 4.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8a0439ab47efb5f97bd772ec77b73caea1ef0776f5a070b94cc5e8936806f589
BLAKE2b-256 checksum
How to use checksums
261051c88f91f5f785556a49af6a9984c7cedc24fc96196ea4754658b9820d30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release files / cipherid_vwlau-0.1.0-py3-none-any.whl

Download URL cipherid_vwlau-0.1.0-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fbfc87d294755f1feb2747ef7c22e563cdc4c92db6036eb9a3bd7f82159e2744
BLAKE2b-256 checksum
How to use checksums
1e550380dfb38f0834ef9f075a098b56da05cf28272d0aadabbf26ee4fde9c78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Security for cipherid-vwlau 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page