Skip to content

loskiq/pywebchat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 

Repository files navigation

PyWebChat

A lightweight, real-time communication platform built with Python, designed for fast and ephemeral collaboration without persistent storage.


πŸš€ Overview

PyWebChat allows users to create temporary chat rooms and communicate instantly with others via a simple invite link.

  • Real-time messaging powered by WebSockets
  • Unlimited number of participants
  • File sharing support (any file type)
  • No data stored on disk β€” everything lives in RAM
  • Fully ephemeral rooms with automatic cleanup

✨ Features

  • πŸ§‘β€πŸ€β€πŸ§‘ Unlimited Participants
    No limits on the number of users in a room.

  • πŸ”— Invite Links
    Easily share access to a room via a unique link.

  • πŸ’¬ Real-Time Chat
    Low-latency communication using WebSockets.

  • πŸ“Ž File Sharing
    Upload and exchange any type of file directly in the chat.

  • 🧹 Room Management

    • Creator can clear chat history
    • Creator can delete the room at any time
  • πŸͺͺ Custom Nicknames
    Participants can change their display names freely.

  • ⏳ Ephemeral Rooms
    If all users leave, the room remains active for 5 minutes, then:

    • All messages are deleted
    • All files are removed
    • The room is destroyed
  • πŸ”’ Privacy First
    All data is stored in memory (RAM) only and never written to disk.

  • 🎨 Themes
    Switch between light and dark modes.


πŸ› οΈ How to Use

Start the Server

python pywebchat.py -l 0.0.0.0:5395

This starts the server on all interfaces at port 5395.


βš™οΈ Command-Line Arguments

Argument Description
-l Listening address in format host:port
-s Path to Unix socket
--cert Path to SSL/TLS certificate file
--key Path to SSL/TLS private key file

πŸ” Example: Run with TLS

python pywebchat.py -l 0.0.0.0:443 --cert cert.pem --key key.pem

Runs the server with HTTPS/WSS support on port 443.


πŸ“Œ Notes

  • Rooms are temporary and automatically cleaned up
  • No database is required
  • Ideal for quick, private, disposable communication

πŸ“„ License

MIT License

About

Temporary Web Chat

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages