audAIence is an innovative AI-powered classroom engagement platform developed by Rishiraj Acharya & Piyush Thakur for the Gemini API Developer Competition. It modernizes and digitalizes the brilliant concept introduced by education expert Dylan Wiliam, enhancing real-time student-teacher interaction in both physical and virtual classrooms.
The project is based on Dylan Wiliam's ingenious idea of using colored cups to gauge student understanding in real-time. In his original concept, students use green, orange, and red cups to indicate their level of comprehension during a lesson. You can learn more about his idea here.
audAIence takes this concept to the next level by:
- Providing a digital interface for students to indicate their understanding level.
- Allowing students to ask questions in real-time.
- Utilizing AI to provide instant answers to student questions based on the lecture material.
- Giving teachers a comprehensive dashboard to monitor student engagement and address concerns promptly.
- Real-time student engagement tracking
- AI-powered question answering system
- Interactive teacher dashboard with data visualization
- Seamless integration of slide materials
- Support for both in-person and remote learning environments
- Python 3.7+
- pip
- virtualenv (recommended)
git clone https://github.com/yourusername/audAIence.git
cd audAIence
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
pip install -r requirements.txt
Create a .env
file in the project root and add your Gemini API key:
GEMINI_API_KEY=your_api_key_here
python main.py
The application will be available at http://localhost:5000
by default.
-
Teachers:
- Access the teacher interface at
http://yourdomain.com/<class_id>/teacher
- Upload lecture slides (PDF format)
- Monitor student engagement in real-time
- Address questions and concerns as they arise
- Access the teacher interface at
-
Students:
- Join a class by navigating to
http://yourdomain.com/<class_id>
- Indicate understanding using color-coded buttons
- Ask questions that get instant AI-powered responses
- View answers to their own and classmates' questions
- Join a class by navigating to
audAIence aims to revolutionize classroom dynamics by:
- Enhancing student engagement and participation
- Providing immediate feedback to teachers about student comprehension
- Offering instant, AI-powered answers to student questions
- Improving the learning experience for both in-person and remote students
- Helping teachers identify and address learning gaps more efficiently
By digitalizing and enhancing Dylan Wiliam's concept, audAIence makes continuous formative assessment more accessible and effective in modern educational settings.
- Integration with popular learning management systems
- Support for more file formats beyond PDF
- Advanced analytics for long-term student performance tracking
- Mobile app for easier access on smartphones and tablets
We welcome contributions to audAIence! Please feel free to submit pull requests or open issues to suggest improvements or report bugs.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
- Dylan Wiliam for the original concept that inspired this project
- The Gemini API team for providing the AI capabilities
- All the educators and students who provided feedback during the development process