Skip to content

Commit

Permalink
editing readme
Browse files Browse the repository at this point in the history
  • Loading branch information
KeiOshima committed Dec 4, 2023
1 parent 8a15432 commit d879c90
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 7 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/ml-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -39,5 +39,5 @@ jobs:

- name: Run tests
run: |
pipenv run pytest --cov=machine_learning_client.py ml_tests.py
pipenv run pytest --cov=machine_learning_client ml_tests.py
working-directory: machine-learning-client/tests
49 changes: 43 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,26 @@
# Interview Review WebApp
![WebApp Machine Learning build test](https://https://github.com/software-students-fall2023/4-containerized-app-exercise-rizzballs/blob/main/.github/workflows/event-logger.yml/badge.svg)
![WebApp Subsystems build test](https://https://github.com/software-students-fall2023/4-containerized-app-exercise-rizzballs/blob/main/.github/workflows/lint.yml/badge.svg)


## What is our WebApp?

Our WebApp is designed to help users practice and improve their interview skills. When prompted, users will speak into the microphhone and answer a generic interview question. Utilizing [SpeechRecogntion](https://pypi.org/project/SpeechRecognition/), the app will record the interview and breakdown the answer given, giving a rating based on specified critera and words used. Then, it is compared to other user attempts to give a comparison and return statistics of the prompted user.

## Installation and Usage

### Prerequisites
1. ensure you have python 3.11 or higher installed
2. ensure you have have Docker installed and running on your computer.
3. optionally have docker Desktop
### Method 1: Cloning the Github Repository
1. Clone the directory through Git Bash with the command:

```
https://github.com/software-students-fall2023/4-containerized-app-exercise-rizzballs.git
git clone https://github.com/software-students-fall2023/4-containerized-app-exercise-rizzballs.git
```

2. Open Docker Desktop
2. Open Docker Desktop or a new terminal

3. In your command prompt, access the directory where you cloned the repository:
3. In your command prompt/terminal, access the directory where you cloned the repository:
```
cd "path_to_directory"
```
Expand All @@ -27,9 +30,36 @@ cd "path_to_directory"
docker-compose build
docker-compose up
```

5. Now, access the http://127.0.0.1:5000/ in your browser of choice.

6. to end the session
```
docker-compose stop
```
or
```
docker-compose down
```

### Note for MacOS Users:
1. after doing docker-compose build and then running docker-compose up leads you to this error:
```
Error response from daemon: Ports are not available: listen tcp 0.0.0.0:5000: bind: address already in use.
```
2. to trouble shoot thisin your terminal run:
```
lsof -i tcp:5000
```
3. and kill that process by doing
```
kill -9 <ProcessID>
```
4. if however, two processes appear when you run the above command then "Airplay" should be turned off
5. to do so go to system settings -> search up air drop and click on "AirDrop and Handoff" -> from there turn off "AirPlay receiver".
6. and then try docker-compose up again.


### Install ffmpeg (Windows)
1. Go to the official ffmpeg website, hover over the windows icon, and click Windows builds from gyan.dev
2. Download ffmpeg-git-full.7z under "latest git master branch build
Expand All @@ -38,6 +68,13 @@ docker-compose up

This should allow you to use ffmpeg while using our program. Make sure to use a clean shell to make sure it is up to date

### Install ffmpeg (Windows)
1. in your terminal type in
```
brew install ffmpeg
```
This should allow you to use ffmpeg while using our program

## Contributors

- [Andrew Huang](https://github.com/andrew0022)
Expand Down

0 comments on commit d879c90

Please sign in to comment.