Skip to content

Releases

ViT5 Quiz Generator v1.0.1

Choose a tag to compare

@github-actions github-actions released this 09 Nov 20:27

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ào outputs/, không cần key. --tiny dùng model 5 MB để kiểm tra
    code path trong ~10 giây; bỏ --tiny để chạy model thật.
  • Dọn repo: bỏ .coverage bị 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

Choose a tag to compare

@github-actions github-actions released this 09 Nov 20:05

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_BACKEND hoặ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 --cov trê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.py

Chi tiết: README.md · Thay đổi: CHANGELOG.md