zapchat (Python)

Terminal-native LAN chat. No accounts, no cloud, no servers — just your local network.

This is the Python distribution of zapchat. It speaks the same discovery protocol as the Node.js version, so a Python user and an npm user on the same Wi-Fi can chat with each other.

The Python client runs the proven protocol v1 wire format (JSON envelopes over TCP, signed discovery beacons). The Node.js client's protocol v2 adds TLS-style encryption on top of the same envelope shapes — the Python client interoperates with npm peers via the shared discovery and messaging format.

Install

pip install zapchat

Run

zapchat

That is it. Everyone on the same network who runs zapchat shows up automatically, and you can start chatting.

zapchat 3.0.0 — LAN chat, no accounts, no server
  you are sam on #general (tcp:45913)
  waiting for people on this network... (ctrl+c to quit, /help)
* alex connected
10:24 alex: morning all
10:25 sam: morning! which room are we using today?

Commands

How it works

• Every instance sends a small UDP beacon (multicast + subnet broadcast) announcing its username, room and TCP port.
• Beacons are how instances find each other; then they open direct TCP connections and exchange newline-delimited JSON messages.
• Rooms are derived, not stored: a room exists while somebody is in it.
• There is no server of any kind. If the LAN works, zapchat works.

Works with the npm version of zapchat on the same network (same beacons, same message protocol).

Privacy

• No accounts, no telemetry, no cloud: the only network traffic is UDP beacons and TCP messages on your local network.
• Config is one small JSON file (your username, a random client id, the last room). Chat history stays in memory.
• Messages are plain text on your LAN — anyone who can capture that traffic can read it. For sensitive conversations use an encrypted messenger.

Requirements

• Python 3.9+ (standard library only — zero dependencies)
• Python 3.9+ on any OS: Windows, macOS, Linux

License

MIT © Samarth Chugh (Sam3360)