README.md

QuestionIA

Summary

• Program Explanation
• Getting to Know the Program
  • Interface
    • Question Settings
    • Gemini Settings
    • Output Window
  • App Themes
    • Darkly (default)
    • Superhero
    • Solar
    • Cyborg
    • Vapor
  • App Fonts
    • Meera (default)
    • Purisa
    • Chilanka
  • Program Tests
    • Test 1
    • Test 2
    • Test 3
    • Test 4
    • Test 5
  • Demonstration (video)

Program Explanation

QuestionIA is a GUI program built in Python that uses the Tkinter library with Ttkbootstrap (providing a modern interface) and also makes use of the Gemini API. This program provides question templates for various subjects (Mathematics, Portuguese, Science, ...) depending on the school year selected (1st, 2nd, 3rd, ..., 9th grade of elementary school, 1st, 2nd, and 3rd year of high school). It aims to assist teachers in creating exercise lists.

Getting to Know the Program

Interface

Question Settings

This section of the program allows the user to configure the following options:

• YEAR: Refers to the students' school year (1st, 2nd, 3rd, ..., 9th grade of elementary school, 1st, 2nd, and 3rd year of high school)

• SUBJECT: The subjects from which the AI will generate questions (Portuguese, English, Spanish, ...)

• TOPIC: Refers to the topic of a given subject that will be used to generate content (e.g., subject=Mathematics, topic=fractions)

• NUMBER OF QUESTIONS: The number of questions the AI will generate (minimum limit = 1, maximum limit = 20)

  NOTE: The search buttons next to the subject and topic fields are used to assist in filling out the fields, with help provided by Gemini.

Gemini Settings

In the Gemini settings (in the GUI), only the place to enter the API KEY for communicating with Gemini has been added. The input widget is configured to display only "*", regardless of the input, to visually hide the API KEY.

While the settings in the Backend are:

Output Window

The output window has a button to generate the content and display the output (Gemini's responses) in a text widget.

App Themes

The application has built-in themes to customize the app to your liking. Check out the following styles!

Darkly (default)

Superhero

Solar

Cyborg

Vapor

App Fonts

The application offers fonts provided by the Tkinter library to customize the app to your liking. Check out the following styles!

Meera (default)

Purisa

Chilanka

Program Tests

Test 1

Input

For test 1, the following configurations were entered:

• YEAR: 6th year of elementary school
• SUBJECT: Portuguese
• SUBJECT: Grammar
• NUMBER OF QUESTIONS: 10

Output

Test 2

Input

For test 2, the following configurations were entered:

• YEAR: 3rd of high school
• SUBJECT: Spanish
• SUBJECT: Complete the correct conjugation of verbs
• NUMBER OF QUESTIONS: 20

Output

Test 3

Input

For test 3, the following configurations were entered:

• YEAR: 1st of high school
• SUBJECT: English
• SUBJECT: Grammar
• NUMBER OF QUESTIONS: 10

Output

Test 4

Input

For test 4, the following configurations were entered:

• YEAR: 3rd of high school
• SUBJECT: Mathematics
• SUBJECT: Algebra
• NUMBER OF QUESTIONS: 10

Output

Test 5

Input

For test 5, the following configurations were entered:

• YEAR: 3rd of high school
• SUBJECT: Philosophy
• SUBJECT: Philosophy of science
• NUMBER OF QUESTIONS: 10

Output

Demonstration (video)

Here you can see how the program works in practice through the provided video.

QuestionIA.mp4

NOTE: Don't worry, the key was deleted at the end of the video!