Real-time monitoring and correction dashboard for LabQuiz (and HTML exam export).

quiz_dash is a Streamlit-based instructor dashboard that connects to a LabQuiz backend (Google Sheets) and provides live tracking, integrity verification, and automated correction.

It is designed for lab sessions, continuous assessment, and secure evaluation.

Why quiz_dash?

When using LabQuiz in connected mode, all student interactions are logged.

Based on the Google Sheet URL specification, the associated read password, and the YAML file containing the answers, quiz_dash allows instructors to:

• track over time, with an adjustable refresh rate, the submissions made by each participant, with the labels of the relevant quizzes,
• check integrity, i.e., verify that the parameters (number of attempts allowed, mode, etc.) have not been modified, verify the hash of the sources, the object in memory, and its dependencies,
• view, over time, the progress of each participant (filterable) and of the entire group,
• correct and retrieve the results table,
• with the possibility of adjusting the weight matrix (for multiple-choice questions) and the scoring scale per question,
• export structured results,
• export individual or whole class graduated scripts.

Installation

From PyPI

pip install quiz-dash

From source

pip install git+https://github.com/jfbercher/labquiz.git#subdirectory=quiz_dash

Launch

An entry-point is provided that allows to simply use

quiz_dash

at the command line.

Or use the hosted version:

👉 https://jfb-quizdash.streamlit.app/

Main Features

📈 Live Monitoring

• Track submissions over time
• View student-by-student activity
• Monitor class progress
• Adjustable refresh rate

🔐 Integrity Verification

Detect:

• Mode changes (exam/test/learning)
• Modified retry limits
• Source hash changes
• Machine sharing
• Kernel restarts

Designed to support controlled exam conditions.

⚖ Flexible Correction

• Automatic correction
• Adjustable weight matrix
• Per-question grading scale
• Recalculation on demand
• Threshold control (negative scores allowed or not)

📥 Export

• Download corrected results as CSV
• Recompute scores with updated parameters
• Export individual PDF or HTML reports

Some screenshots of actual monitoring:

quiz_dash -- Dash parameters

quiz_dash -- Integrity monitoring

quiz_dash -- Monitoring of quizzes taken by students and the group. Automatic refresh possible and adjustable (student names have been hidden)

quiz_dash -- Automated correction, with the option to adjust the scoring system (automatic recalculation); (student names have been hidden). Of course, the results table can be downloaded.

quiz_dash -- quiz_dash -- Individual correction can be generated for a student.

quiz_dash -- Individual reports can be downloaded so that you can distribute them to the students.

Typical Workflow

1. Students run quizzes in Jupyter notebooks (LabQuiz)
2. Results are logged to Google Sheets
3. Instructor opens quiz_dash
4. Monitor activity in real time
5. Run correction
6. Export final grades

Integration

quiz_dash works with:

• labquiz — quiz engine
• quiz_editor — question preparation tool

Intended Use Cases

• Lab session monitoring
• Continuous assessment
• Exam supervision
• Integrity auditing
• Post-session grade recalculation

📜 License

GNU GPL-3.0 license