Chat WebSocket is a simple yet powerful real-time bi-directional chat application powered by Flask and Flask-Sock. It allows devices within the same local network (LAN) to communicate instantly.
- Real-time Communication – Instant messaging via WebSockets.
- Typing Indicators – "User is typing..." real-time notifications.
- System Messaging – Broadcast messages directly from the server terminal to all clients.
- User Identity – Simple nickname-based identification system.
- Cross-Platform – Runs seamlessly on Linux, Windows, and macOS.
- No Database Required – Lightweight and ephemeral session-based chat.
- Python 3.8 or newer.
- Modern Web Browser (Chrome, Edge, Firefox, etc.).
git clone [https://github.com/pangeran-droid/Chat-WebSocket.git](https://github.com/pangeran-droid/Chat-WebSocket.git)
cd Chat-WebSocketWindows:
python -m venv venv
venv\Scripts\activateLinux/macOS:
python3 -m venv venv
source venv/bin/activatepip install -r requirements.txtStart the server by running:
python server_websocket.pyUpon success, you will see:
[SERVER] Aktif di port 8080 (HTTPS otomatis)The access level depends on the host configuration in server_websocket.py:
app.run(host="0.0.0.0", port=8080, debug=False)| Mode | Host | Access URL | Visibility |
|---|---|---|---|
| 🔒 Local Only | 127.0.0.1 | http://127.0.0.1:8080 | Only this computer |
| 📶 Local Network (LAN) | 192.168.x.x | http://[Your-IP]:8080 | All devices on the same Wi-Fi |
| 🌍 Public Access | 0.0.0.0 | Depends on Port Forwarding | Accessible from the internet (Use with caution) |
Important
Note on 0.0.0.0: Setting the host to 0.0.0.0 means the server listens to all available network interfaces on your computer. It is perfectly safe for local development, provided that port 8080 is not exposed to the public internet through router port forwarding or tunneling services like ngrok.
- Ensure your phone and server are connected to the same Wi-Fi network.
- Find your computer's local IP address:
- Linux/Mac: Run ifconfig or ip addr.
- Windows: Run ipconfig.
- Locate an IP address like 192.168.1.10.
- On your mobile browser, enter:
http://192.168.1.10:8080
- No Authentication: This version is intended for educational purposes. Do not expose it to the public internet without implementing security layers.
- Private Use: Use host="127.0.0.1" for isolated development.
- Trusted Networks: Use host="0.0.0.0" only within trusted local networks.
Chat-WebSocket/
│
├── server_websocket.py
├── index.html
├── requirements.txt
└── README.md