AOSSIE-Org/EduAid

[GOOD FIRST ISSUE]: main.py too large and hard to maintain

Open

#603 opened on Mar 18, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)JavaScript (427 forks)auto 404
good first issue

Repository metrics

Stars
 (172 stars)
PR merge metrics
 (PR metrics pending)

Description

Context

The main.py file has grown to ~800 lines with multiple responsibilities.

Problems

  • Difficult to navigate and maintain
  • Multiple unrelated classes in a single file
  • Hard to test and extend

Affected Files

  • backend/Generator/main.py

What Needs to Be Done

  • Split large main.py into focused modules:
    • question_generators.py
    • answer_predictor.py
    • utilities.py
    • advanced_qa.py
  • Updated server.py imports to use new structure
  • Preserved all existing logic and functionality

Resources

Getting Started

  • I have joined the Discord server and will post updates there
  • I have read the Contribution Guide
  • I understand this issue is assigned on a first-come, first-served basis

Contributor guide

Research direction
Examine the existing main.py to identify logical groups of functions and classes, then split into separate modules as listed, ensuring all imports and server.py references are updated.
Tech stack
python
Domain
backend
Issue type
Refactor
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
PythonGit
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80