How mrfrazer25/homework-tracker works
Project type and purpose
• This is a standalone desktop “full-stack” application (Python) with a graphical UI for tracking homework plus a locally-hosted chatbot assistant.
• Its purpose is to let students manage assignments (CRUD, calendar view, statistics) and interact with an NLU-powered assistant for study tips and scheduling help.
File structure
• Top-level
• main.py – application entry point
• requirements.txt, README.md, LICENSE
• src/
• core/ – business logic:
– assignment_manager.py (CRUD & query over assignments)
– data_handler.py (persistence to JSON files)
– chatbot.py (wrapping the NLU pipeline & memory)
– study_tips.py (encapsulates static tip logic)
• gui/ – UI layer:
– app.py (initializes window & tabs)
– *\_tab.py (Dashboard, Assignments, Calendar, Statistics, Chatbot)
– chat_history_dialog.py (view stored conversations)
• utils/ – cross-cutting helpers:
– helpers.py (date formatting, generic helpers)
– settings_manager.py (load/save user preferences)
README for additional insights
• GUI has five main views (dashboard, assignments, calendar, statistics, chat assistant).
• Chatbot uses Hugging Face transformers for intent/emotion detection, Langchain memory for conversation context, all on-device.
• Data (assignments.json, settings.json, chat_history.json) lives in a local data/ directory (gitignored).
Final reminders
• Every module that has distinct responsibility—even Helpers or SettingsManager.
• How the Chatbot Tab interacts with the Chatbot Engine and then with the model/memory.
• Entry point (main.py) is visible, illustrating app initialization and wiring of components.