# PyChatRoomDemo

**Repository Path**: gaojc/py-chat-room-demo

## Basic Information

- **Project Name**: PyChatRoomDemo
- **Description**: 一个基于 Flask 和 Flask-SocketIO 实现的简单聊天室应用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-11
- **Last Updated**: 2025-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

ChatRoomDemo 一个基于 Flask 和 Flask-SocketIO 实现的简单聊天室应用。

📦 项目简介 ChatRoomDemo 是一个简单的实时聊天应用，使用 Python 的 Flask 框架与
Flask-SocketIO 扩展实现 WebSocket 实时通信。前端采用 HTML + JavaScript（Socket.IO 客户端）进行页面渲染和消息交互。 

🧰 技术栈 

后端：Flask、Flask-SocketIO
前端：HTML、JavaScript (Socket.IO)
实时通信：WebSocket 

📁 项目结构

```
ChatRoomDemo/
├── app.py              # Flask 主程序，包含 SocketIO 逻辑
├── static/             # 静态文件目录
│   └── index.js        # 前端 JavaScript 脚本，处理用户输入和接收消息
├── templates/          # 模板目录
│   └── index.html      # 聊天界面
└── Readme.md           # 项目说明文档
```

🔧 运行方式

1. 安装依赖 确保已安装 Python 3.x，并运行以下命令安装依赖：

```
pip install flask flask-socketio eventlet

```

2. 启动服务 运行主程序：

```
python app.py
```

3. 访问应用 浏览器访问 http://localhost:5000/

🛠️ 部署建议（生产环境） 如需部署到生产环境，推荐使用支持 WebSocket 的服务器，例如配合 eventlet 或 gevent 使用 Nginx + Gunicorn 等反向代理方案。 示例启动命令（使用 eventlet）：

```
pip install eventlet
python -m eventlet.wsgi_server -f app:app

```

💬 功能说明 支持多用户同时在线聊天 实时消息推送（基于 WebSocket） 简洁的 HTML 页面设计 

📌 注意事项 若在运行过程中遇到 Flask-SocketIO 的 Werkzeug
安全警告，请确认是否为生产部署并参考修复建议。 如需扩展功能（如昵称、私聊、历史记录等），请自行修改前端与后端逻辑。

🤝 贡献指南 欢迎提交 Issue 和 Pull Request！如果你有新的功能想法或优化建议，欢迎参与开发。