Skip to content
/ HWGPT Public

HW-GPT is an AI-powered educational tool. It helps students solve homework from uploaded question papers across various subjects. Its easy-to-use interface, built with the Tkinter library, makes problem-solving simpler and efficient.

Notifications You must be signed in to change notification settings

baukk/HWGPT

Repository files navigation

HW-GPT

HW-GPT is a powerful educational tool that uses cutting-edge AI technologies to solve your homework assignments from uploaded question papers. The application is designed to understand and solve questions from a range of subjects, providing an excellent solution for students looking to check their work or understand how to approach a problem. It utilizes the Tkinter library for the graphical user interface, making it intuitive and easy-to-use.

Demo

hwgpt.sample.mp4

Features

  • Supports PDF file upload: HW-GPT allows users to upload the PDF files of their question papers.
  • Text extraction: The app scans and extracts all the text from the uploaded PDF files.
  • Editable questions: After scanning, users have the option to edit the questions before the solution process begins.
  • Solutions file: The application solves all the questions and generates a text file containing the solutions.

Installation and Setup

The application is easy to install and set up, even for beginners.

Step 1: Clone the Repository

First, clone the repository to your local system. Open your command prompt (Windows) or terminal (Mac/Linux), navigate to the directory where you want the project to be saved, and run the following command:

git clone https://github.com/baukk/HWGPT.git

Step 2: Install Dependencies

Navigate into the cloned HW-GPT directory and install the necessary libraries listed in the requirements.txt file with the following commands:

cd HW-GPT
pip install -r requirements.txt

Ensure you have Python 3 and pip installed on your system before running these commands. If you encounter any issues during the installation, consider upgrading pip or using a virtual environment.

Enter your chat-GPT API key

Edit the gpt_funs.py file at LINE 10. Add your API key there

How to get free OpenAI API secret key

Step 3: Run the Application

Once all the dependencies are installed, you can start the application by running the root.py script:

python root.py

How to Use HW-GPT

  1. After starting the application, click on the "Upload" button to upload your PDF file containing the questions.
  2. The application will scan the PDF and display the extracted text. Review the text and edit it if necessary.
  3. Click on the "Load" button. The application will process the questions and generate the solutions.
  4. The solutions will be displayed in the next frame, and a text file containing the solutions will be created.

Contributions

We welcome contributions from the community. If you'd like to improve the HW-GPT project, feel free to create a fork and submit a pull request! We would love any kind of suggestions on issues with the project and would work on them.

Future Plans

We are working on a web app for the same project which will make using it on a mobile/PC for everyone.

Contact

Mail: gaurtanay6@gmail.com

Linkedin: Tanay Gaur

About

HW-GPT is an AI-powered educational tool. It helps students solve homework from uploaded question papers across various subjects. Its easy-to-use interface, built with the Tkinter library, makes problem-solving simpler and efficient.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages