${\textsf{\color{#C25A7C}💬 Simple Student Chat Client (Frontend + Python Async Client)}}$

A dual-interface client for the real-time Student Chat system — combining a browser-based UI and a Python asyncio WebSocket client to simulate or enable student-like behavior during live sessions.

This project interacts with the FastAPI+Socket.IO backend to send prompts, receive model responses, and log structured chats for learning analysis.

${\textsf{\color{#C25A7C}Features}}$ 📋

• Clean, user-friendly chat interface (HTML + JavaScript)
• Alternative headless chat interface via Python asyncio client
• Token-based login and session tracking
• Real-time messaging powered by WebSocket (via Socket.IO)
• Seamless integration with backend logging
• End-session handling with UI redirect

${\textsf{\color{#C25A7C}Project Structure}}$ 🗂️

.
├── README.md
├── requirements.txt
├── src
│   ├── __init__.py
│   ├── asyncio_client.py
│   ├── create_dummy_secret_key.py
│   └── main.py
├── static
│   ├── css
│   │   ├── chat.css
│   │   └── login.css
│   ├── images
│   │   └── pink-girl-icon.png
│   └── js
│       └── chat.js
└── templates
    ├── chat.html
    └── login.html

${\textsf{\color{#C25A7C}Set Up}}$ 🛠️

${\textsf{\color{#FFC0CB}Clone the Repo}}$

git clone git@github.com:M-Nkirote/Simple-Text-to-SQL-Solution.git

cd Student-Chat-Python-websocket-client

${\textsf{\color{#FFC0CB}Set up virtual environment}}$

python -m venv venv

source venv/bin/activate

${\textsf{\color{#FFC0CB}Install dependencies}}$

pip install -r requirements.txt

${\textsf{\color{#FFC0CB}To run main.py}}$

cd /Student-Chat-Python-websocket-client/src

uvicorn main:app --reload --port 8000

Note! You should ensure that the backend server is already running (Refer to the server project: https://github.com/M-Nkirote/Student-Chat-Python-websocket-server, to set it up.)

${\textsf{\color{#C25A7C}Gallery}}$ 📷

${\textsf{\color{#FFC0CB}Login Page}}$

${\textsf{\color{#FFC0CB}Chat Page}}$

${\textsf{\color{#C25A7C}To create a JWT token}}$ 🔑

• Go to https://jwt.io/
• Select the option "JWT Encoder"
• Add your payload
• Add the secret key for encoding
• • To create the random key, after cloning this project, run the file src/create_dummy_secret_key.py, and copy the output.
  • Paste the created key in the section 'Sign JWT: Secret' at https://jwt.io/
• Copy your generated token and use it to log in 🎊 ☺️

${\textsf{\color{#FFC0CB}🙌 Contributions}}$

Feel free to fork the repo, suggest improvements, or file issues.