Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Roaster05 authored Aug 18, 2024
1 parent 054f8f5 commit 9fd26ea
Showing 1 changed file with 42 additions and 14 deletions.
56 changes: 42 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,21 +12,43 @@ EduAid is one such project currently available in the form of a browser extensio
git clone https://github.com/AOSSIE-Org/EduAid.git
cd EduAid
```
### 2. Backend Setup
- Download the Sense2Vec model from [this link](https://github.com/explosion/sense2vec/releases/download/v1.0.0/s2v_reddit_2015_md.tar.gz) and extract the contents into the `backend` folder.
- Extract the contents of the downloaded compressed folder inside the backend folder.
## 2. Backend Setup

You can choose to set up the backend manually or use an automated shell script.

### Option 1: Manual Setup

1. **Download the Sense2Vec Model**:
- Download the Sense2Vec model from [this link](https://github.com/explosion/sense2vec/releases/download/v1.0.0/s2v_reddit_2015_md.tar.gz) and extract the contents into the `backend` folder.

2. **Install Python Dependencies**:
- Navigate to the root repository folder and run the following command to install the required Python dependencies:
```bash
pip install -r requirements.txt
```

3. **Run Flask App**:
- Navigate to the `backend` folder and start the Flask app:
```bash
python server.py
```
- This will activate the backend for the application.

### Option 2: Automated Setup with Shell Script

1. **Run the Setup Script**:
- Navigate to the `backend` folder and run the following shell script:
```bash
./script.sh
```
- This script will automatically download and extract the Sense2Vec model, install Python dependencies, and start the Flask app.

### Troubleshooting

- If the script fails to run, ensure that you have execution permissions:
```bash
chmod +x script.sh
- Install Python Dependencies
Navigate to the root repository folder and run the following command to install the required Python dependencies:
```bash
pip install -r requirements.txt
```
- Run Flask App
Navigate to the backend folder and start the Flask app:
```bash
python server.py
```
This will activate the backend for the application.
### 3. Configure Google APIs
Expand Down Expand Up @@ -94,6 +116,12 @@ npm run build
- **PDF Forms**: Generate editable PDF forms based on your quizzes.
- **Google Forms**: Create Google Forms for your quizzes, perfect for easy distribution and response collection.

## How to contribute

This is the second year of the project. While some may have their own ideas on how to contribute, for the newcomers to the repository, you may follow the following steps:

1. First get to know the organization and the project by visiting the [Official Website](https://github.com/AOSSIE-Org)

2. Visit the [Discord Channel](https://discord.com/channels/1022871757289422898/1073262393670504589) for interacting with the community!


0 comments on commit 9fd26ea

Please sign in to comment.