A self-hosted SMS/MMS messaging system with an Android client and Python server backend. Own your messages, pick your provider, run it on your own iron.

Architecture

  • Android App — Full messaging client with real-time WebSocket notifications, contact integration, and media support
  • FastAPI Server — Message routing, media compression and deduplication, admin panel, per-user data isolation
  • Provider Layer — Pluggable SMS providers (Twilio, MessageBird, Vonage)

Features

  • SMS and MMS with attachments
  • Group messaging with delivery tracking
  • Automatic media compression and thumbnail generation
  • Do Not Disturb and conversation archiving
  • Storage quotas and API key authentication
  • WebSocket push notifications