项目简介
本项目名为MosqueEase,旨在借助物联网技术与机器学习算法,为用户提供轻松查找附近清真寺位置的服务,同时具备实时的清真寺监控与数据分析功能。项目运用FastAPI搭建后端API服务,结合YOLO模型开展图像处理与目标检测,采用Supabase作为数据库与后端服务。通过ESP-System设备(如ESP32微控制器搭配摄像头)采集现场图像数据,目前系统仍在开发并持续增加新功能。
项目的主要特性和功能
主要特性
- 实时视频监控:支持用户实时查看清真寺现场视频流。
- 头部计数:利用YOLO模型分析图像,实时统计清真寺内人数。
- 数据可视化:以图表形式展示清真寺使用情况和访问模式。
- 开源集成:与开源数据库Supabase集成,保障数据安全与可访问性。
- 跨平台支持:支持多种操作系统和设备,涵盖移动设备、桌面及物联网设备。
功能模块
- 用户交互模块:提供友好界面与交互体验,用户可查看清真寺信息、实时视频流和头部计数等。
- 图像处理和目标检测模块:运用YOLO模型分析图像,识别清真寺内人数及其他关键信息。
- 数据传输模块:通过物联网设备将现场数据(视频流、头部计数等)上传至后端服务器处理分析。
- 数据存储和分析模块:使用Supabase数据库存储和处理数据,提供数据分析与可视化功能。
- 后端服务模块:借助FastAPI构建强大后端服务,处理用户请求和API调用。
安装使用步骤
假设用户已下载本项目的源码文件,可按以下步骤操作:
1. 复制仓库:
bash
cd MosquEase-IoT
2. 创建并激活虚拟环境:
bash
python -m venv mosquease_venv
mosquease_venv\Scripts\activate
source mosquease_venv/bin/activate
3. 安装依赖:
bash
cd fastapi-yolo-app
pip install -r requirements.txt
4. 上传Arduino文件:使用Arduino IDE或其他IDE将Arduino文件上传到微控制器。
5. 配置网络和URL:确保物联网设备与笔记本电脑在同一网络,编辑main.py
中的IoT网络服务器URL。
6. 运行项目:
bash
uvicorn main:app --reload
7. 环境配置:确保拥有正确的环境变量(如API密钥)。
技术栈
- FastAPI:构建后端API服务。
- YOLOv8:图像处理和目标检测。
- Supabase:数据存储和提供API服务。
- ESP32 - CAM:图像和数据捕捉。
许可证
本项目采用GNU General Public License version 3 (GPLv3)许可证。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】