How manikanta2834/dbms-tutor works
DBMS Tutor is a QLoRA fine-tuning and tutoring application. Its main lifecycle validates and splits curated conversations, trains a LoRA adapter, evaluates baseline and adapted models, then serves tutoring through a terminal or browser. The README documents the benchmark and web curriculum features; sampled code confirms dataset handling, model loading, generation, and HTTP chat. Some internal web routes and training details were not sampled, so the graph shows only documented or source-supported connections.
Main entry points: train_qwen_ft.py QLoRA Trainer · outputs LoRA Adapter · evaluate_model.py DBMS Benchmark · prepare_dataset.py Dataset Splitter
Components 14
Data Preparation
- Curated Q&A
data/dbms_tutor.jsonl - Dataset Validator
scripts/validate_dataset.py - Dataset Splitter
scripts/prepare_dataset.py - Training Split
data/train.jsonl - Validation Split
data/validation.jsonl
Model Training
- QLoRA Trainer
train_qwen_ft.py - Qwen Base Model
- LoRA Adapter
outputs
Model Evaluation
- DBMS Benchmark
scripts/evaluate_model.py - Evaluation Report
outputs
Tutor Interfaces
- Terminal Tutor
inference.py - Web Chat Server
web_chat.py - Browser Chat UI
web_chat.py
Other components
- Learner / Operator
Connections 18
- Curated Q&A → Dataset Validator: validates
- Curated Q&A → Dataset Splitter: splits
- Dataset Splitter → Training Split: writes
- Dataset Splitter → Validation Split: writes
- Training Split → QLoRA Trainer: trains on
- Validation Split → QLoRA Trainer: validates with
- Qwen Base Model → QLoRA Trainer: adapts
- QLoRA Trainer → LoRA Adapter: saves
- DBMS Benchmark → Qwen Base Model: loads baseline
- DBMS Benchmark → LoRA Adapter: loads adapter
- DBMS Benchmark → Evaluation Report: writes
- Learner / Operator → Terminal Tutor: asks
- Terminal Tutor → LoRA Adapter: loads if available
- Terminal Tutor → Qwen Base Model: falls back to
- Learner / Operator → Browser Chat UI: asks
- Browser Chat UI → Web Chat Server: posts chat
- Web Chat Server → LoRA Adapter: loads if available
- Web Chat Server → Qwen Base Model: falls back to