Merge pull request #1 from MSU-AI/project-structure

.gitignore

@@ -0,0 +1,8 @@
+# files meant to exist locally only
+env/
+scratch/
+*.egg-info/*
+
+# python related files
+*.pyc
+**/__pycache__/

README.md

@@ -0,0 +1,61 @@
+# Safety Cam
+Safety Cam is a project developed by the Artificial Intelligence Club (AI Club) at Michigan State University (MSU). The goal of this project is to develop a camera capable of detecting dangers using camera visuals and sound detection.
+
+## How it Works
+The Safety Cam uses a combination of computer vision and sound detection algorithms to identify potentially dangerous situations.
+The camera captures live footage and processes it in real-time using various computer vision techniques such as object detection and tracking.
+At the same time, the camera also analyzes the sound in the environment and identifies sounds and speeches that potentially signify dangers.
+If the camera detects a dangerous situation, it alerts the user through a mobile app and sends an emergency alert to predefined contacts.
+ 
+## Getting Started
+To get started with the Safety Cam, you will need the following:
+- A computer with a camera and microphone
+- Python 3.10 or later installed
+- Git
+
+To set up the Safety Cam, follow the steps below:
+1. Clone the Safety Cam repository to your computer using the following command:
+```
+git clone https://github.com/MSU-AI/safety-camera.git
+```
+2. Install the required dependencies by running the following command in the Safety Cam directory:
+```
+pip install -r requirements.txt
+```
+3. Start the Safety Cam by running:
+```
+cd app/
+streamlit run main.py
+```
+4. The Safety Cam web app will open in your default web browser.
+5. Click on the "Start" button to start the camera stream.
+6. The camera will start capturing footage and processing it in real-time.
+7. If the Safety Cam detects a potentially dangerous situation, it will display an alert on the screen.
+8. To stop the camera stream, click on the "Stop Stream" button.
+
+## Contributing
+We welcome contributions to the Safety Cam project. If you would like to contribute, please follow the steps below:
+1. Set up a virtual environment named `env`:
+```
+python -m venv env
+```
+2. Activate the virtual environment. On Windows, run:
+```
+env\Scripts\activate
+```
+On Linux or macOS, run:
+```
+source env/bin/activate
+```
+3. Install the required dependencies by running the following command in the Safety Cam directory:
+```
+pip install -r requirements.txt
+```
+4. Install `safetycam` as a local editable package:
+```
+pip install -e .
+```
+
+## License
+The Safety Cam project is licensed under the MIT License.
+See the [LICENSE](LICENSE) file for more information.

app/main.py

@@ -0,0 +1,48 @@
+import streamlit as st
+from streamlit_webrtc import webrtc_streamer
+import speech_recognition as sr
+import time
+
+def speech_to_text_microphone():
+    # initialize recognizer class (for recognizing the speech)
+    r = sr.Recognizer()
+    
+    # Reading Microphone as source
+    # listening the speech and store in audio_text variable
+    with sr.Microphone() as source:
+        audio_text = r.listen(source)
+    # recoginize_() method will throw a request error if the API is unreachable, hence using exception handling
+    try:
+        # using google speech recognition
+        return r.recognize_google(audio_text)
+    except:
+        return ""
+    
+
+audio = ""
+st.title("SafetyCam")
+
+webrtc_streamer(key="video")
+def live_caption():
+    text = ""
+    # Initialize recognizer and microphone objects
+    r = sr.Recognizer()
+    mic = sr.Microphone()
+
+    # Set minimum energy threshold to account for ambient noise
+    with mic as source:
+        r.adjust_for_ambient_noise(source)
+
+    # Continuously listen to microphone input and print live caption
+    with mic as source:
+        while True:
+            try:
+                audio = r.listen(source)
+                text = r.recognize_google(audio)
+                print(text)
+                st.write(text)
+            except sr.UnknownValueError:
+                # Handle unrecognized speech
+                pass
+if st.button("Start Live Caption"):
+    live_caption()

requirements.txt

@@ -0,0 +1,9 @@
+ipykernel>=6.21.3,<=6.22
+mediapipe>=0.9.1.0,<=0.10
+numpy>=1.24.2,<=1.25
+pandas>=1.5.3,<=1.6
+PyAudio>=0.2.13,<=0.3
+pydub>=0.25.1,<=0.26
+SpeechRecognition>=3.10.0,<=3.11
+streamlit>=1.20.0,<=1.21
+streamlit-webrtc>=0.45.0,<=0.46

safetycam/sentiment.py

@@ -0,0 +1,4 @@
+#!/usr/bin/env python
+
+def dummy(msg):
+    return msg.upper()

setup.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python
+from distutils.core import setup
+
+setup(
+    name='Safety Cam',
+    version='0.1',
+    author='MSU AI Club (Spring 2023)',
+    packages=[
+        'safetycam',
+    ]
+)