Caution
Dear Contributors and Users, we would like to inform you that the repository for Jarvis has been officially archived. This means that no further updates, enhancements, or modifications will be added to this project in its current state. For those still interested in contributing or modifying Jarvis, we encourage you to fork the repository. This will allow you to create your own branch and continue development according to your own vision and requirements. Thank you for your understanding and for your contributions to Jarvis. We look forward to seeing how the community takes this project forward in their own unique ways. Best regards.
Jarvis is a tool made with Selenium and Python that has the ability to answer questions of a Quiz on the Moodle website. If there are any new questions, Jarvis is able to download them and store them for use in a new quiz.
- Installation
- Install everything that is required to run Jarvis.
- Usage
- Learn how to start and use Jarvis.
- How to use Jarvis on Unix
- How to use Jarvis on Windows
- Download new questions
- Learn how to download new questions from a Quiz.
- Contributing
- Want to update Jarvis? Find out how to contribute.
- Disclaimer
- Read the disclaimer.
Note Follow the steps below to install everything that is required to run Jarvis. Once you have installed everything you can skip to the Usage section to learn how to use Jarvis.
Once you have cloned the repository, you will need to follow the steps below to install everything that is required to run Jarvis.
You can use the requirements.txt file to install all the dependencies for this project. Run the following command:
pip install -r requirements.txtYou can download the ChromeDriver from the following link make sure to download the version that matches your Chrome browser version. Once you have downloaded the ChromeDriver, extract the file and move it to the Jarvis directory.
Note This part is divided into two sections. The first section is for Unix users and the second section is for Windows users. Follow the steps for your operating system to learn how to use Jarvis.
It's crucial that you set the Moodle page language to English. You can do this by clicking on the language button on the top right corner of the page and selecting English. If you don't do this, Jarvis will not work properly. Please do this before you start using Jarvis.
This part is only for Unix users (MacOS and Linux). If you are a Windows user, you can skip this part and go to the How to use Jarvis - Windows section.
Note In most cases you can skip this step by just running the chrome-macos.sh or chrome-linux.sh file inside the script directory (based on your OS). Before running one of the files, make sure to change the path to the user data directory inside the file. Create a directory called "chrome-data" in the Jarvis directory and change the path to the user data directory inside the file to the path of the "chrome-data" directory that you created.
Example of the chrome-linux.sh file, you will need to change "PATH_TO_USER_DATA_DIRECTORY" to the path of the "chrome-data" directory that you created:
#!/bin/bash
/usr/bin/google-chrome-stable --remote-debugging-port=9222 --user-data-dir="PATH_TO_USER_DATA_DIRECTORY"If you are not able to run the sh script, you will need to follow the steps below to find the path to the Google Chrome executable file and start Google Chrome in remote debugging mode.
You will need to start Google Chrome in remote debugging mode. To do this, you have to find the path to the Google Chrome executable file. You can do this by running the following command:
which google-chrome-stableOnce you have the path ("CHROME_EXECUTABLE_PATH") to the Google Chrome executable file, you will need to specify a user data directory. This is where Google Chrome will store all the data. You can create one wherever you want. For example, you can create a directory called "chrome-data" in the Jarvis directory. Once you have created the directory, you can run the following command to start Google Chrome in remote debugging mode:
CHROME_EXECUTABLE_PATH --remote-debugging-port=9222 --user-data-dir="PATH_TO_USER_DATA_DIRECTORY"After running the command, a Google Chrome window should open. This window will be used by Jarvis to perform the actions. Do not close this window. Now that you have started Google Chrome in remote debugging mode, you can run Jarvis, but first you have to do some configuration.
Open the config.py file and change the following variables:
# This variable is used to determine which operating system you are using.
OS = "UNIX"
# NOTE: We are using port 9222 because that is the port that we used to start Google Chrome in remote debugging mode. If you are using a different port, make sure to change it here as well.
LOCAL_HOST = 'localhost:9222'
# NOTE: You will need to change the path to the ChromeDriver that you downloaded in the installation section.
CHROME_DRIVER_PATH_UNIX = '/Users/person/Documents/driver/chromedriver'
# NOTE: Do not youch the CHROME_DRIVER_PATH_WINDOWS variable.Once you have changed the variables, Jarvis is suited for your system.
Now that you have configured Jarvis, you can start using it. Login to your Moodle account by using the Google Chrome window that you opened in step 1. Once you have logged in, you can choose a quiz that you want Jarvis to answer. Once you have chosen a quiz, you have to edit the main.py file. You will need to change the following variables:
# per il time.sleep() ovvero quanti secondi vuoi che aspetta tra un'operazione e l'altra
tempo_di_attesa = 0
# NOTE: You will need to change this variable base on the number of questions that are in the quiz. For example, if there are 50 questions in the quiz, you will need to change this variable to 50.
quante_domande = 50Once you have changed the variables, you can run the main.py file. By doing so, Jarvis will start answering the questions, make sure that after you run the main.py file, you jump back to the Google Chrome window that you opened in step 1. Jarvis will start downloading first the questions and then will proceed to answer them. Do not worry if it takes some seconds for Jarvis to start answering the questions, it is normal since the process to find all the answers may take some time.
Once Jarvis has finished answering the questions, and you want to use Jarvis to answer a new quiz, you will need to delete the questions that Jarvis downloaded. You can do this by manually deleting the Data directory that has been created or by running the following command:
./scripts/clean.shAfter you have deleted the previous questions, you can run the main.py file again and Jarvis will start answering the questions of the new quiz.
This part is only for Windows users. If you are a Unix user (MacOS and Linux), you can skip this part and go to the How to use Jarvis - Unix section.
You will need to start Google Chrome in remote debugging mode. To do this, you have to find the path to the Google Chrome executable file. You can do this by taking a look at this link.
Once you have the path ("CHROME_EXECUTABLE_PATH") to the Google Chrome executable file, you will need to specify a user data directory. This is where Google Chrome will store all the data. You can create one wherever you want. For example, you can create a directory called "chrome-data" in the Jarvis directory. Once you have created the directory, you can run the following command to start Google Chrome in remote debugging mode:
"CHROME_EXECUTABLE_PATH" --remote-debugging-port=9222 --user-data-dir="PATH_TO_USER_DATA_DIRECTORY"Note You can also use the bat file (chrome.bat) inside the scripts directory to start Google Chrome in remote debugging mode. You will need to change the path to the Google Chrome executable file and the path to the user data directory for it to work properly.
After running the command, a Google Chrome window should open. This window will be used by Jarvis to perform the actions. Do not close this window.
Now that you have started Google Chrome in remote debugging mode, you can run Jarvis, but first you have to do some configuration.
Open the config.py file and change the following variables:
# This variable is used to determine which operating system you are using.
OS = "WINDOWS"
# NOTE: We are using port 9222 because that is the port that we used to start Google Chrome in remote debugging mode. If you are using a different port, make sure to change it here as well.
LOCAL_HOST = 'localhost:9222'
# NOTE: You will need to change the path to the ChromeDriver that you downloaded in the installation section.
CHROME_DRIVER_PATH_WINDOWS = r"C:\chromedriver\chromedriver.exe"
# NOTE: Do not youch the CHROME_DRIVER_PATH_UNIX variable.Once you have changed the variables, Jarvis is suited for your system.
Now that you have configured Jarvis, you can start using it. Login to your Moodle account by using the Google Chrome window that you opened in step 1. Once you have logged in, you can choose a quiz that you want Jarvis to answer. Once you have chosen a quiz, you have to edit the main.py file. You will need to change the following variables:
# per il time.sleep() ovvero quanti secondi vuoi che aspetta tra un'operazione e l'altra
tempo_di_attesa = 0
# NOTE: You will need to change this variable base on the number of questions that are in the quiz. For example, if there are 50 questions in the quiz, you will need to change this variable to 50.
quante_domande = 50Once you have changed the variables, you can run the main.py file. By doing so, Jarvis will start answering the questions, make sure that after you run the main.py file, you jump back to the Google Chrome window that you opened in step 1. Jarvis will start downloading first the questions and then will proceed to answer them. Do not worry if it takes some seconds for Jarvis to start answering the questions, it is normal since the process to find all the answers may take some time.
Once Jarvis has finished answering the questions, and you want to use Jarvis to answer a new quiz, you will need to delete the questions that Jarvis downloaded. You can do this by manually deleting the Data directory that has been created or by running the following command:
./scripts/clean.batAfter you have deleted the previous questions, you can run the main.py file again and Jarvis will start answering the questions of the new quiz.
Note In this section you are going to learn how to download questions that Jarvis has not seen before. This is useful if you want to use update Jarvis with new questions.
You need to start a new Quiz on Moodle and start Jarvis on it. It will answer to all the questions that are present in the 'Esami' folder. If there are new questions, Jarvis will download them and store them in the 'Esami' folder.
Once Jarvis has finished answering the questions, if there are new questions that have been marked as wrong, you can download them by following the steps below.
Open the risposte_sbagliate.py file inside the download directory and follow the steps below.
- Place yourself on the first question of the quiz once the exam has finished.
- Run the risposte_sbagliate.py file.
- Jump back to the Chrome page once you started the risposte_sbagliate.py file.
- Jarvis will download only the questions that are marked as wrong (Red color).
- Once Jarvis has finished downloading the questions, you will see a new directory inside the 'Esami' directory. This directory will contain the new questions that Jarvis has downloaded.
Follow the steps above every time you want to download new questions that Jarvis has not seen before.
Warning This tool is made for educational purposes only. I am not responsible for how the tool is used. Jarvis is not intended to be used for cheating on exams, but rather used to learn how to use Selenium and Python for web scraping and automation.
This project is licensed under the MIT License - see the LICENSE.md file for details