简体中文

AMI System (UWM Capstone Project)

Air Monitoring Interface System is a sensor data monitoring platform used by a team for the UWM Capstone Project. It is a Django-based web application used to receive, store, visualize, and export data from various environmental sensors.

Key Features

• Data Reception: Provides API endpoints to receive data from sensors (Temperature, Humidity, CO2, PM1.0, PM2.5, PM10.0).
• Data Query: Provides a RESTful API to query stored sensor data (requires user login), supporting filtering by time range.
• Data Export: Allows logged-in users to export data for specified time ranges and sensor types as CSV or JSON files.
• User Authentication: Includes user registration, login, and logout functionalities.
• Gmail Notifications: Sends notifications when thresholds are exceeded.
• Data Visualization: Provides charts or other forms to display sensor data trends.
• Chatbot: Integrates multiple chatbots, offering free or paid features.

Technology Stack

• Backend: Python, Django, Django REST Framework
• Database: SQLite
• Frontend: HTML, CSS, JavaScript
• AI Features: MCP (Model Context Protocol technology, used for DeepSeek AI), Hybrid Strategy Answering technology (used for basic AI)

Guide

YouTube AMI Guide

Installation and Running

1. Clone the repository:

   git clone https://github.com/panhyer36/sensor_monitor.git
   cd sensor_monitor
   

2. Create and Activate Virtual Environment:

   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`
   

3. Install Dependencies:

   pip install -r requirements.txt
   

4. Set up environment variables: Create a .env file in the project root directory (same level as manage.py) and add the following variables:

   EMAIL_HOST_USER=your_email@gmail.com
   EMAIL_HOST_PASSWORD=your_app_password
   

   • Replace your_email@gmail.com with your Gmail address.
   • Replace your_app_password with your Gmail App Password. See Google's documentation for how to create an App Password. Important: Ensure the .env file is added to your .gitignore to prevent committing sensitive credentials.

5. Create Admin User and migration the database: You can use the provided script:

   python create_admin.py
   

   Or use the Django command:

   python manage.py createsuperuser
   

   python manage.py makemigrations
   python manage.py migrate
   

6. Run the development server:

   # Terminal 1: Run Django development server
   python manage.py runserver
   

   # Terminal 2: Run MCP server
   mcpo --host 127.0.0.1 --port 8002 -- python MCP_server/mcp_server.py
   

Team

• This project was used by a team for the Capstone Project at the University of Wisconsin-Milwaukee.
• AMI Team
  • Member 1: YU-ERH, PAN
  • Member 2: Yen-Lin, Chang
  • Member 3: Carson K Lisowe
  • Member 4: Taiwo Boluwaji Abe
  • Member 5: Collin Brey
  • Member 6: Matthew Scott Maijala

Acknowledgements

Special thanks to the following open-source projects:

• MCPO: https://github.com/open-webui/mcpo
• MCP: https://github.com/modelcontextprotocol
• Comitup: https://github.com/davesteele/comitup (Not directly related to this project, used for the network connection process on Raspberry Pi to send sensor data, and installed as a core component. We have not modified or disclosed any of its code. Due to its GPL-2.0 license, we hereby acknowledge it and express our thanks.)