finds.dev

antirez/freakwan

A floor-routing WAN implementing a chat over bare-LoRa (no LoRaWAN).

View on GitHub

★ 501PythonBSD-2-Clauseupdated Jan 2026

// the take

FreakWAN is a MicroPython mesh chat and data protocol that runs directly on LoRa radios (SX1276/SX1262) on ESP32 boards, with no LoRaWAN or internet/cellular dependency at all. It's for hobbyists building off-grid community or disaster-resilience networks, not for anyone needing a production IoT messaging stack.

The encryption scheme is genuinely well thought out for the constraint: AES-CBC with a derived MAC key, a packed IV that borrows entropy from the message ID to stay useful at only 32 bits, and a HMAC truncated to make room for a padding-length nibble, all to save bytes on a channel that measures bandwidth in bytes per second. The relay logic (TTL decrement, first-hop-only ACKs, Listen-Before-Talk, quiet mode) is a sensible, specific answer to LoRa's half-duplex and collision problems rather than a generic flooding scheme bolted on. It does a lot with very little: BLE, IRC bot, Telegram bridge, a custom 1-bit image codec, and an OLED UI all in vanilla MicroPython with zero external dependencies. Shipping working firmware images for the finicky 4MB-flash T3-S3 variant removes a real first-hour failure point for anyone trying this on actual hardware.

There's no sender authentication: the 48-bit sender ID is unsigned, so spoofing a nickname or a device is trivial, and even encrypted-channel keys sit unencrypted in device flash by the project's own admission. Packet fragmentation is explicitly 'proposal not implemented,' so anything that needs to exceed LoRa's ~256-byte cap just doesn't work yet, which caps message and image size. Duplicate suppression relies on a message-ID cache with no documented eviction/sizing strategy on hardware that has very little RAM to spare. It's a single-maintainer side project still labeled work-in-progress (the T-ECHO C port is alpha), IRC runs unencrypted because MicroPython can't fit SSL, and there's no retry/delivery guarantee beyond a fixed number of blind retransmissions.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
501
Forks
29
Language
Python
License
BSD-2-Clause
Last commit
9 Jan 2026

// nearby

If freakwan isn't quite it.

All repos →