AloneChat - Project

ABOUT

AloneChat is a personal project born out of curiosity and a desire to learn more about
real-time communication systems. It's a simple chat application with WebSocket-based
messaging, JWT authentication, and a modular plugin architecture.

This project is far from perfect, but we're trying our best to improve it gradually.
Any feedback, suggestions, or contributions would be greatly appreciated.

Note: On Windows, this project is currently only compatible with Python 3.13 and below
due to windows-curses limitations. We apologize for any inconvenience.

FEATURES

Real-time Messaging

WebSocket-based communication with low latency

JWT Authentication

Secure token-based authentication system

Plugin System

Modular architecture with lifecycle hooks

Multiple UI Modes

Both GUI and TUI interfaces available

Unified Logging

Comprehensive logging with file rotation

Session Management

User presence tracking and cleanup

TECH STACK

Python WebSocket customtkinter PyJWT curses

QUICK START

                # Clone and setup

                git clone https://github.com/alonechat/AloneChat.git

                cd AloneChat

                pip install -r requirements.txt

                # Start server

                python -m AloneChat server --port 8765

                # Start client (GUI)

                python -m AloneChat client