1. Home

Welcome to ChatCLI

ChatCLI is a self-hosted, cross-platform desktop chat application built with Electron and Python. It provides real-time messaging, group chats, and VoIP calling — all without relying on a third-party cloud service.

Live instance: chat.puam.be
Current version: 0.4.1-beta
License: GNU General Public License v3.0
Author: FrostMantis

---

What is ChatCLI?

ChatCLI is designed for users who want control over their own messaging infrastructure. You can use the public instance at chat.puam.be, or self-host the backend on your own server.

The app ships as a standalone installer for Windows and Linux. No account with a third-party service is required — just install the client and connect.

---

Architecture at a glance

Part	Technology	Role
Client	Electron (Node.js)	Desktop app — Windows and Linux
HTTP API	Python · Flask · Waitress	REST API on port 5123
WebSocket server	Python · FastAPI · uvicorn	Real-time messaging on port 8765
Database	MariaDB	Persistent storage
VoIP	LiveKit	Peer-to-peer voice calls

---

Pages in this wiki

• Current Features — what the app can do right now
• Public API — HTTP and WebSocket endpoint reference
• Requirements — software prerequisites for self-hosting
• Privacy Policy
• Terms of Service