I'm thrilled to announce that enigmapython, my powerful Enigma machine emulator, is now available on MicroPython! 🚀

🔹 Why is this exciting?

enigmapython isn’t just a package... it’s a historically accurate and educational tool that allows students, researchers, and history enthusiasts to explore WWII cryptography hands-on.

Now, with MicroPython support, you can run it on embedded devices like ESP32, Raspberry Pi Pico, and other microcontrollers!

🔹 How This Helps Education & Research

✅ Cryptography Lessons – Learn how encryption shaped history by experimenting with real Enigma machine settings on resource-constrained devices.

✅ Historical Research – Recreate encoded wartime messages and decrypt them just like WWII codebreakers.

✅ STEM & Embedded Systems – Run an Enigma emulator on a microcontroller, making learning cryptography more interactive than ever!

Using mip (on network enabled devices):

import mip
mip.install("github:denismaggior8/micropython-enigma-python", version="1.2.3")

This repo mirrors the enigmapython releases on PyPi, meaning that by installing micropython-enigma-python version 1.2.3 (as in the example above) you get the enigmapython 1.2.3 PyPi equivalent.

This is a very simple MicroPython snippet that shows how to use the library (once installed in the system)

# Import enigmapython modules
from enigmapython.EnigmaB_A133RotorI import EnigmaB_A133RotorI
from enigmapython.EnigmaB_A133Etw import EnigmaB_A133Etw
from enigmapython.EnigmaB_A133 import EnigmaB_A133
from enigmapython.ReflectorUKW_EnigmaB_A133 import ReflectorUKW_EnigmaB_A133

# Setup Enigma machine components
rotor1 = EnigmaB_A133RotorI(ring=0,position=0)
rotor2 = EnigmaB_A133RotorI(ring=0,position=0)
rotor3 = EnigmaB_A133RotorI(ring=0,position=0)
reflector = ReflectorUKW_EnigmaB_A133()
etw = EnigmaB_A133Etw()

# Setup Enigma B machine
enigma = EnigmaB_A133(rotor3, rotor2, rotor1, reflector, etw, True)

# Let's encrypt a string
print(enigma.input_string("denis"))

To get more examples you can inspect this repo's examples folder or the original enigmapython examples here.

If you run enigmapython on hardware not yet listed here, drop me an email at denis.maggiorotto[at]gmail.com or open a PR.

Be aware: ESP8266-like boards are currently UNSUPPORTED due to their low memory

Found it useful/funny/educational? Please consider to