Metadata-Version: 2.4
Name: lanmess
Version: 1.1.4
Summary: LAN-only end-to-end encrypted messenger with a TUI
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.52.0
Requires-Dist: cryptography>=41.0.0
Dynamic: license-file

# LANMess

LAN-only end-to-end encrypted messenger with a terminal UI.

## Install

pip install lanmess

## Run

lanmess

## First launch

1. Display name.
2. Group code (min 12 chars, shared with your peers).
3. PIN (min 12 chars, mixed character classes). This unlocks your local database.

The group code is only used once, at setup. After that you unlock with your PIN.

## Security model (v1.1.4)

- Per-pair session handshake (X25519 ephemerals both sides, fresh per session).
- Symmetric hash ratchet per message for forward secrecy within a session.
- Ed25519 signatures on every control frame and every message.
- Length-padded messages (256-byte blocks).
- Safety numbers for out-of-band identity verification (`/verify`).
- All data at rest sealed by a random per-device master, wrapped with Argon2id(PIN).
- The group code is no longer part of the at-rest key path.

See THREAT_MODEL.md for what is and isn't protected.

## Migrating from 1.1.3

Enter your PIN. Everything is re-encrypted under a new random master. The
group code is preserved inside the encrypted identity blob so contact hashes
and discovery tags keep working.
