Repository navigation
Releases
Releases · haibadguy/ViT5
ViT5 Quiz Generator v1.0.1
ViT5 Quiz Generator v1.0.1
Bản vá nhỏ: thêm script tự kiểm tra Stage 1 (không cần API key) và dọn repo.
Thay đổi
scripts/smoke_stage1.py: chạy Stage 1 (ViT5 local) → ghép MCQ → validate →
export Word/PDF vàooutputs/, không cần key.--tinydùng model 5 MB để kiểm tra
code path trong ~10 giây; bỏ--tinyđể chạy model thật.- Dọn repo: bỏ
.coveragebị commit nhầm, ignore.idea/+.vscode/+
coverage.xml+htmlcov/, xoá file hướng dẫn quay GIF (không dùng). requirements*.txt: giữ range thay vì ghim version. (Đã thử ghim và CI đỏ ở
bước install vì bản ghim không có trên PyPI của runner — ghi lại để không lặp lại.)
Kiểm thử
- 49 test offline; CI xanh trên Python 3.10 và 3.12.
scripts/smoke_stage1.py --tinyđã chạy thật: load model → sinh Q-A → validate →
export 2 trang, dấu tiếng Việt giữ nguyên (đọc lại bằng pypdf).
Cài đặt và giới hạn: xem README.
ViT5 Quiz Generator v1.0.0
ViT5 Quiz Generator v1.0.0
Sinh câu hỏi trắc nghiệm tiếng Việt từ văn bản, dùng ViT5 cho câu hỏi/đáp án đúng
và LLM cho đáp án nhiễu.
Tính năng
- Pipeline 2 stage: ViT5 (
shnl/vit5-vinewsqa-qg-ae) sinh câu hỏi + đáp án
đúng, LLM sinh đáp án nhiễu, sau đó chuẩn hoá thành MCQ A/B/C/D. - 4 backend LLM: Gemini, OpenAI, Groq, Ollama (chọn qua
LLM_BACKENDhoặc UI). - Validate câu hỏi: câu thiếu/trùng lựa chọn, sai vị trí đáp án bị loại kèm lý do
(Sinh 10 câu, giữ 8 câu hợp lệ…). - Export: Word / PDF (font Unicode nhúng, đáp án ở trang riêng) / TXT / JSON /
CSV (Quizizz, Google Forms) — giữ nguyên dấu tiếng Việt. - Bảo mật: API key không in ra UI/log; lỗi 401/429/timeout được diễn giải thân thiện.
Kiểm thử
- 49 test, chạy offline (mock model, không gọi API).
- CI:
ruff check .+pytest --covtrên Python 3.10 và 3.12.
Chạy thử
pip install -r demo_mcq/requirements.txt
copy demo_mcq\.env.example demo_mcq\.env # điền 1 API key
streamlit run demo_mcq/app.pyChi tiết: README.md · Thay đổi: CHANGELOG.md