JoetheSmith/qna-queue

Q&A Queue – Streamlit App

A lightweight Python/Streamlit app to run your last-hour Q&A smoothly for large classes (200+).

Features

• —Student self-sign-up (name + optional question)
• —Instructor console with Start Next, Mark Done, Skip
• —Projector-friendly Display mode showing Now Speaking and Up Next
• —SQLite backend (no external services required)

Quick Start

1. 1.Ensure you have Python 3.9+ installed.
2. 2.Create a virtual environment (recommended) and install requirements:

   pip install -r requirements.txt

1. 1.Run the app:

   streamlit run app.py

1. 1.Use the sidebar to switch between Student, Instructor, and Display modes.
2. 2.Open Display mode in a separate browser window for projection.
3. 3.Keep Instructor mode on your laptop to control the flow.

Tips

• —Share the Student mode URL/QR to the class so they can join the queue from their phones.
• —The app stores data in a local SQLite database file qna_queue.db created alongside the app.
• —For a shared network deployment (e.g., on a classroom PC), run it on a machine reachable by students on the same network and share the host IP.
• —For cloud deployment, you can use Streamlit Community Cloud, Hugging Face Spaces, or any VM/server.

Optional

• —To reset the queue between classes, use Clear All Submissions in the Instructor console or delete qna_queue.db.

Security/Privacy

• —This demo app is intentionally simple. If you need authentication, rate limits, or audit logs, let me know and I can add them.