|
| 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