Skip to main content

AI Exam Preparation System with TUI, GUI, and Streamlit

Project description

🎓 PrepForge

PrepForge is an AI-powered exam preparation system with multiple interfaces and support for base LLMs and LoRA adapters.


📦 Installation

Install directly from PyPI:

pip install prepforge

PyPI: https://pypi.org/project/prepforge/0.1.0/


✨ Features

  • 🖥 Terminal UI (TUI)
  • 🪟 Desktop GUI (PyQt6)
  • 🌐 Web interface (Streamlit)
  • 🧠 Supports base models and LoRA adapters
  • 🏋️ Built-in training pipeline (QLoRA / Unsloth)
  • ⚡ Offline inference support

🚀 Usage

Terminal Interface (TUI)

prepforge run tui

Desktop GUI

prepforge run gui

Web Interface

prepforge run streamlit

⚙️ Configuration

Set default model:

prepforge config --model <model_name_or_path>

Set LoRA adapter:

prepforge config --lora <adapter_path>

🏋️ Training

prepforge train \
  --dataset dataset.jsonl \
  --epochs 3 \
  --output trained_model

📊 Dataset Format

{
  "instruction": "Explain Newton's laws",
  "input": "",
  "output": "Newton's laws describe motion..."
}

📂 Project Structure

major_project/
├── core/
│   ├── model.py
│   ├── train.py
│   └── utils.py
├── tui_app.py
├── gui_app.py
├── streamlit_app.py
├── cli.py
├── config.py

⚠️ Notes

  • Models are not bundled with the package
  • Users must download base models separately
  • GPU (CUDA) is recommended for best performance

🧑‍💻 Author

Himanshu Arora


📜 License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

prepforge-0.1.0.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

prepforge-0.1.0-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file prepforge-0.1.0.tar.gz.

File metadata

  • Download URL: prepforge-0.1.0.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for prepforge-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b70625fd6519b572eee20a0821d273a8ac853418a26de8008c44edb36165a8d7
MD5 fc1b5e28e6b1ccde1c671d0156456000
BLAKE2b-256 284eebbb2cc07994f6987b7589088612918ac86f5421dc82319074c9edc5955d

See more details on using hashes here.

File details

Details for the file prepforge-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: prepforge-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 16.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for prepforge-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0158a56d9e47f710db2fd2f321a81974819b601ff2f83be8223a3e6a5241a694
MD5 429392df5ccdb9fb498f09f76e1cec64
BLAKE2b-256 af750d3c2b5344f997a6604ddf2ba6001b1610bd3d230299356cbcbf3c58148c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page