Platform Capabilities.

A structured view of Plexichat’s core systems, from real-time messaging to deployment and operational governance.

Messaging & Collaboration

Channels & Threads

Organize conversations across servers, channels, direct messages, and threads.

  • Server, channel, and DM support
  • Threaded discussions and participation
  • Pins and system message types
  • Message history with attachments

Rich Content

Message formatting and interaction primitives for modern collaboration.

  • Markdown rendering
  • Embeds and link previews
  • Reactions and emoji support
  • Attachments and media metadata

Presence & Notifications

Real-time user presence with signaling for activity and alerts.

  • Presence updates and status
  • Mentions and notification streams
  • Typing indicators and activity hints
  • Push notification endpoints
Voice & Media

Voice & Stage

WebRTC signaling with modern SFU support.

  • Mediasoup or Janus SFU integration
  • Stage channels and speaker controls
  • Low-latency audio/video sessions
  • Real-time voice permissions

Media Pipeline

Secure and scalable media handling for files and embeds.

  • S3/MinIO compatible media storage
  • Media proxying and URL validation
  • Metadata extraction for uploads
  • Avatar and icon processing

Asset Management

Identity and expression assets baked into the platform.

  • Custom avatars and server icons
  • Emoji management and reactions
  • Media permissions by role
  • Audit visibility for uploads
Identity & Governance

Accounts & Sessions

Security-first authentication and session handling.

  • Token-based authentication
  • Multi-session tracking
  • TOTP-based 2FA support
  • IP-based security rules

Roles & Permissions

Granular access control for large organizations.

  • Role hierarchies and scoped permissions
  • Channel and server enforcement
  • Moderator and admin workflows
  • Permission-aware actions

Moderation & Reports

Operational tools for governance and safety.

  • User and message reports
  • Automoderation rule sets
  • Admin dashboards and visibility
  • Security event review
Developer Platform

API Surface

Versioned REST endpoints with live documentation.

  • API base URL: /api/v1
  • Interactive docs at /docs and /redoc
  • Static docs at /docs/api
  • Schema-driven request validation

Webhooks & Integrations

Event-driven integrations for external systems.

  • Webhook creation and execution
  • Webhook message tracking
  • External service callbacks
  • Integration-friendly routes

Bot & OAuth Support

Extensible platform features for automation.

  • Bot accounts and API tokens
  • OAuth provider configuration
  • Slash command workflows
  • Client-side OAuth callbacks
Infrastructure & Reliability

Storage & Caching

Scale the data plane with proven components.

  • PostgreSQL for persistence
  • Redis caching and sessions
  • Configurable connection pools
  • External storage options

Telemetry & Health

Operational visibility for real deployments.

  • Health checks at /api/v1/health
  • Telemetry endpoints and stats
  • Admin logs and dashboards
  • Rate limit monitoring

Self-Test & Validation

Built-in verification for deployments and upgrades.

  • Self-test suite for core endpoints
  • Configuration validation on boot
  • Schema-driven request checks
  • Safe startup defaults
Deployment Paths

Manual Production Service

Run the API with Gunicorn + Uvicorn workers for production workloads.

  • Python 3.11+ runtime
  • PostgreSQL + Redis recommended for production
  • gunicorn -w 4 -k uvicorn.workers.UvicornWorker src.api.app:app --bind 0.0.0.0:8000

Reverse Proxy + Config

Use Nginx (or similar) with TLS and WebSocket upgrades enabled.

  • Proxy WebSocket upgrades with Upgrade/Connection headers
  • Health check endpoint: /api/v1/health
  • Primary config: ~/.plexichat/config/config.yaml