Web platform for Physics Assigments System.
This is the README file for the Dr_R web application built using Django. The application is designed to provide different functionalities for students (Deimos), instructors (Phobos), and general users (Astros).
You must have installed python3 on your machine.
As of now, the system only supports 3.11 versions. Beyond that,
torch which is used for the search engine, won't be able to install.
- Clone the repository:
git clone https://github.com/arielfayol37/Dr_r- Change into the project directory:
cd Dr_r- Create virtual environment (optional):
python3 -m venv venv- Activate the virtual environment (skip if you skipped step 3) a. On macOS and Linux:
source venv/bin/activateb. On Windows:
venv\Scripts\activate- Install required packages:
pip install -r requirements.txt- Run migrations:
python manage.py makemigrations
python manage.py migrate- Run the development server:
python manage.py runserverThen copy and paste the url from the terminal to your browser.
- MAC users: I have not tested those instructions on MAC, so I recommend that you skip setting up a virtual environment if the command does not work (skip step 3 and 4).
- Window users: if the command at step 3 does not work for you, just skip it. Or use "python" instead of "python3."
In case you want to test without having to create accounts, courses, etc, don't worry. A copy of the site is running at https://mars-valpo.com. You can use the following credentials:
- Instructor test account: email - arielfayol1@gmail.com, password - ernestodelaCruz23789
- Student test account: email - fayol.ateufackzeudom@valpo.edu, password - ernestodelaCruz23789
CS50W, CS50AI, THANK YOU! Please Launch a real AI (computer vision preferably) and/or SOFTWARE DEV Course.
- Algebraic expressions symbolic comparisons
- Semantic search engine
- Ability to take Notes for any question and come back to the later
- Supports latex input for equations
- Randomized variables for both multiple choice and structural questions
- High precision calculator
- Supports images in question body and mcq input
- Coming soon: customized automated practice tests
- Students can access various courses.
- View course details, including name, description, subject, number of students, and difficulty level.
- Enroll in courses.
- View assignments and questions.
- Submit answers to questions.
- Receive hints for questions.
- View their progress and grades.
- Instructors can create and manage courses.
- Create assignments with different categories (quiz, homework, practice test).
- Add questions to assignments, with various answer types (float, variable float, expression, etc.).
- Set/extend due dates for assignments.
- Assign weights to questions for grading purposes.
- View student progress and grades.
- General users can browse courses and their details.
- No login is required to access these features.
Contributions are welcome! If you'd like to contribute to the project, please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Make your changes and commit them.
- Push your changes to your fork.
- Create a pull request to the main repository.
We appreciate your contributions and thank you for helping make this project better!
When contributing code, please adhere to the project's coding style and conventions. This ensures that the codebase remains consistent and easy to maintain.
If you encounter a bug in the application or have a feature request, please open an issue. We value your feedback and appreciate your input.
If you have any questions or need assistance, feel free to reach out to the project maintainers (317-720-7186, arielfayol1@gmail.com) or open a discussion in the repository.
This project is licensed under the Creative Commons Legal Code License. By contributing to this project, you agree to abide by the terms of this license. See the LICENSE file for details.