How yo-le-zz/anonymous works
Anonymous is a self-hostable, end-to-end encrypted group chat without accounts. The main workflow is: a person connects with the client, creates or joins a room using an out-of-band invitation, then sends encrypted messages or files that the server relays and stores as opaque data. The client also handles local secrets, room controls and live updates; the server supplies temporary sessions, access control, room and message APIs, and maintenance. README capabilities such as reactions, administration and public status are retained where evidence supports them; unsampled implementation details and uncertain links are omitted.
Main entry points: src/main.py HTTP and live relay · src/main.py Client workflow · retention.py Retention and upkeep · media.py Encrypted files
Components 19
Client
- Client workflow
client/src/main.py - Client preferences
client/src/config.py - Local room secrets
client/src/storage.py - Message payloads
client/src/protocol.py - Stream framing
client/src/framing.py - Encrypted files
client/src/media.py
Server
- HTTP and live relay
server/src/main.py - Envelope protocol
server/src/protocol.py - Server configuration
server/src/config.py - Configuration assistant
server/src/config_wizard.py
Security and policy
- E2E encryption
client/src/crypto.py - Ephemeral sessions
server/src/session.py - Server access tokens
server/src/auth.py - Progressive anti-spam
server/src/ratelimit.py - Content policy
server/src/moderation.py
State and maintenance
- Message and room store
server/src/database.py - File storage
server/src/storage.py - Retention and upkeep
server/src/retention.py
Other components
- Chat participant
Connections 25
- Chat participant → Client workflow: uses
README.md - Client workflow → HTTP and live relay: connects and exchanges
README.md - Client workflow → E2E encryption: encrypts and decrypts
client/src/main.py - Client workflow → Message payloads: encodes payloads
client/src/main.py - Client workflow → Stream framing: frames transfers
client/src/main.py - Client workflow → Encrypted files: uploads and downloads
client/src/main.py - Encrypted files → E2E encryption: derives file keys
client/src/media.py - Encrypted files → Message payloads: uses file chunk size
client/src/media.py - Client workflow → Local room secrets: loads and saves rooms
client/src/main.py - Client workflow → Client preferences: reads preferences
client/src/main.py - HTTP and live relay → Envelope protocol: validates envelopes
server/src/main.py - HTTP and live relay → Message and room store: reads and writes records
server/src/main.py - HTTP and live relay → File storage: stores and removes files
server/src/main.py - HTTP and live relay → Ephemeral sessions: registers and verifies sessions
server/src/main.py - HTTP and live relay → Server access tokens: checks access
server/src/main.py - HTTP and live relay → Progressive anti-spam: applies limits
server/src/main.py - HTTP and live relay → Content policy: checks policy
server/src/main.py - HTTP and live relay → Retention and upkeep: starts maintenance
server/src/main.py - HTTP and live relay → Server configuration: loads configuration
server/src/main.py - HTTP and live relay → Configuration assistant: dispatches configuration
server/src/main.py - Retention and upkeep → Message and room store: purges expired records
server/src/retention.py - Retention and upkeep → File storage: deletes expired files
server/src/retention.py - Retention and upkeep → Ephemeral sessions: cleans expired sessions
server/src/retention.py - Retention and upkeep → Progressive anti-spam: sweeps counters
server/src/retention.py - Retention and upkeep → Content policy: reloads word policy
server/src/retention.py