Skip to content

Real-time audience engagement web app with interactive polls, word clouds, and QR code joining.

License

Notifications You must be signed in to change notification settings

michael-borck/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.