Skip to content

Repository files navigation

Neural Chat

A modern real-time desktop chat application built using Python and PySide6.

Neural Chat provides a WhatsApp-like messaging experience with real-time communication, private conversations, delivery status, seen status, and typing indicators.


Features

Authentication

  • User Registration
  • User Login
  • Password Hashing
  • Secure user verification

Real-Time Messaging

  • Multi-client chat
  • Global group messaging
  • Private one-to-one messaging
  • Real-time message delivery
  • JSON-based communication protocol

Message System

  • Unique message ID generation
  • Delivery acknowledgement (Single Tick)
  • Read acknowledgement (Double Tick)
  • Message timestamps
  • Message history loading

User System

  • Online users list
  • User join notifications
  • User leave notifications
  • Typing indicator

Interface

  • Modern dark UI
  • PySide6 desktop interface
  • Custom message bubbles
  • Chat status updates

Tech Stack

Backend

  • Python
  • Socket Programming
  • TCP Communication
  • JSON Protocol

Frontend

  • PySide6
  • Qt Widgets

Database

  • SQLite
  • Custom database layer

Development Tools

  • Git
  • GitHub
  • Virtual Environment

Architecture

                PySide6 Client
                     |
                     |
              TCP Socket Layer
                     |
                     |
              Python Chat Server
                     |
                     |
                 SQLite DB

Project Structure

NeuralChat
│
├── main.py
│
├── database
│   └── database.py
│
├── network
│   ├── server.py
│   ├── client.py
│   ├── protocol.py
│   ├── network_manager.py
│   └── network_worker.py
│
├── ui
│   ├── login_window.py
│   ├── register_window.py
│   ├── chat_window.py
│   ├── message_bubble.py
│   ├── conversation_manager.py
│   └── private_chat_window.py
│
└── services

Current Project Status

Version

Neural Chat v0.3


Completed

✅ User Authentication ✅ SQLite Database Integration ✅ Password Hashing ✅ TCP Socket Communication ✅ Multi Client Support ✅ Global Chat ✅ Private Chat ✅ Online User System ✅ Real-Time Messaging ✅ Delivery Status ✅ Seen Status ✅ Typing Indicator ✅ Message History ✅ Modern Dark UI


Development Progress

Authentication       ██████████ 100%

Networking           ██████████ 100%

Global Chat          ██████████ 100%

Private Chat         █████████░ 90%

Message Status       ██████████ 100%

Database             ████████░░ 80%

UI Improvements      ███████░░░ 70%

Upcoming Features

  • Emojis Support
  • File Sharing
  • Image Sharing
  • Voice Messages
  • Group Creation
  • Message Search
  • Notifications
  • End-to-End Encryption

How to Run

1. Clone Repository

git clone <repository-url>

2. Create Virtual Environment

python -m venv venv

3. Activate Environment

Windows:

venv\Scripts\activate

4. Install Requirements

pip install -r requirements.txt

5. Start Server

python -m network.server

6. Start Client

python main.py

Developer

Mohanraj

Neural Chat — Building real-time communication with Python 🚀

About

A modern desktop chat application built with Python, PySide6, SQLite, and Socket Programming. Supports secure authentication, real-time messaging, and online user management.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages