Skip to content

Commit 7ad2e8d

Browse files
authored
Create README.md
1 parent 2fb2422 commit 7ad2e8d

1 file changed

Lines changed: 89 additions & 0 deletions

File tree

README.md

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
This project has been made for a hackathon
2+
# 📚 Virtual Study Environment 🧠
3+
4+
Welcome to the **Virtual Study Environment**! This innovative platform allows users to upload PDF files, analyzes the content, scans the user's mood, and provides personalized study tips based on that mood.
5+
6+
This project leverages **React**, **Node.js**, and **Flask** to create an intuitive and responsive study companion.
7+
8+
---
9+
10+
## ✨ Features
11+
12+
- **PDF Analysis**: Upload your PDF and receive a summarized version of the content.
13+
- **Mood Detection**: The system scans your mood using a webcam or manual input.
14+
- **Personalized Study Tips**: Based on your mood, receive customized study recommendations.
15+
- **Interactive UI**: Smooth and responsive user interface built with React.
16+
17+
## 🛠 Tech Stack
18+
19+
- **Frontend**: React.js
20+
- **Backend**: Node.js (for handling file uploads, user interaction)
21+
- **API**: Flask (for PDF analysis and mood detection)
22+
23+
## 🚀 Getting Started
24+
25+
### Prerequisites
26+
27+
Ensure you have the following installed:
28+
29+
- Node.js
30+
- Python 3.x
31+
- Flask
32+
33+
### Installation
34+
35+
1. **Clone the repository**
36+
37+
```bash
38+
git clone https://github.com/yourusername/virtual-study-environment.git
39+
cd virtual-study-environment
40+
Install dependencies for the frontend
41+
42+
bash
43+
Copy code
44+
cd client
45+
npm install
46+
Install dependencies for the backend
47+
48+
bash
49+
Copy code
50+
cd server
51+
npm install
52+
Install dependencies for Flask
53+
54+
bash
55+
Copy code
56+
cd flask-api
57+
pip install -r requirements.txt
58+
Running the Application
59+
Start the Flask server
60+
61+
bash
62+
Copy code
63+
cd flask-api
64+
flask run
65+
Start the Node.js server
66+
67+
bash
68+
Copy code
69+
cd server
70+
npm start
71+
Start the React client
72+
73+
bash
74+
Copy code
75+
cd client
76+
npm start
77+
Environment Variables
78+
Create a .env file in the root of each service and add the necessary environment variables:
79+
80+
Flask API: FLASK_ENV, MOOD_DETECTION_API_KEY
81+
Node.js: PORT, DATABASE_URL
82+
React: REACT_APP_API_URL
83+
📈 How it Works
84+
PDF Upload: Users can upload a PDF document to the system.
85+
Content Summarization: The Flask API analyzes the content of the PDF and returns a concise summary.
86+
Mood Detection: Using a webcam (or manually entering their mood), the system analyzes the user’s mood.
87+
Study Tips: Based on the detected mood, the system provides personalized study recommendations to enhance productivity.
88+
🤝 Contributing
89+
Contributions are welcome! Feel free to submit a pull request or open an issue.

0 commit comments

Comments
 (0)