DOCUMENTATION
Read the whole thing.
Komms is designed in the open. Installing the public unsigned 0.4.2 Beta test release? Start with the Beta guide and exact release record. Exploring the system? Continue with the plain-words intro, threat model, and cryptography specification.
GUIDES
From a five-minute plain-words intro to the full protocol spec.
- Start Here
- Why Komms
- Threat Model
- Architecture
- Cryptography
- Transports
- Identity & Trust
- Storage
- Roadmap
- Implementation
- Hardware-in-Loop Bench
- Feature Scope
- Feature Delivery
- Screen Security
- Incognito Keyboard
- Contact Petnames
- Safe Text Formatting
- Safe File Presentation
- Message Editing
- Disappearing Messages
- Group Polls
- Group Roles
- Linked Devices
- Live Audio Calls
- Local Release Gate
- Release Runbook
- Self-hosting
- Alpha Testing
- Brand System
STABILIZATION
The frozen product contract, atomicity, storage, and assurance work behind stable-v1.
RELEASE
Testing, evidence, conformance, field qualification, and exact release decisions.
OPERATIONS
Least-authority service roles, deployment boundaries, and public operator records.
STEWARDSHIP
Contributor, accessibility, licensing, funding, and incident-readiness policy.
DECISIONS
Architecture Decision Records: what we chose, and every alternative we rejected.
- ADR Index
- Rust core + UniFFI
- XChaCha20-Poly1305
- Double Ratchet + PQXDH
- libp2p transport
- Meshtastic first
- AGPLv3 license
- Recipient-scoped delivery tokens
- In-tree mDNS responder
- Token-blind bridging
- FFI embedded runtime
- Mnemonic-sealed backup
- Sender-key groups
- Real-time calls
- Versioned message content
- Encrypted attachments
- Group mention content
- Optional hybrid modes
- Pairwise rendezvous
- Native wake gateway
- Authenticated message edits
- Ephemeral retention
- Convergent group polls
- Group roles and owner authority
- Account-authorized linked devices
- Optional Freenet carrier
- Revocable device authority
- Opaque indexed store
- Atomic protocol commits
- Authenticated group origins
- First-contact admission
- Connect-code discovery
- Leased mailbox delivery
- Nonprofit stewardship
- Reference discovery service
- Stable-v1 conformance kit
PROJECT
How to contribute, and how to report a security issue.