Skip to content

A real-time audience interaction tool that allows presenters to create interactive polls, word clouds, and rating scales for audience engagement with instant visualised results

License

Notifications You must be signed in to change notification settings

michaelborck-education/class-pulse

Repository files navigation

ClassPulse

ClassPulse is a real-time audience engagement web application built with Flask. It allows presenters to create interactive sessions with different question types and receive instant feedback from their audience.

Features

  • Real-time Interaction: Engage with your audience in real-time using WebSockets
  • Multiple Question Types: Create multiple-choice questions, word clouds, and rating scales
  • QR Code Generation: Easy session joining with auto-generated QR codes
  • Results Visualization: See responses as they come in with instant updates
  • Data Export: Export results to CSV for further analysis
  • User Management: Admin panel for user verification and management
  • Session Archive: Keep your session history organized

Question Types

  • Multiple Choice: Present options and collect structured responses
  • Word Cloud: Generate word clouds from free-text responses
  • Rating: Collect numerical ratings on a defined scale

Setup

  1. Clone the repository
  2. Install dependencies:
    pip install -r requirements.txt
    
  3. Run the application:
    python app.py
    
  4. Access the application at http://localhost:5002

Default Admin Access

  • Username: admin
  • Password: admin123

⚠️ Important: Change the default admin password immediately after first login.

Requirements

  • Python 3.6+
  • Flask and extensions (Flask-SQLAlchemy, Flask-SocketIO)
  • Additional libraries: qrcode, Pillow

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

A real-time audience interaction tool that allows presenters to create interactive polls, word clouds, and rating scales for audience engagement with instant visualised results

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published