Skip to content
@ICV-Team4

ICV-Team4

๐ŸŽ“ Uhm-azing Classroom

๐ŸŽ“ Uhm-azing Classroom

An all-in-one computer vision-based smart classroom platform

Automating Education with Computer Vision

License Python OpenCV PyTorch


๐Ÿš€ Overview

Uhm-azing Classroom (์—„์ฒญ๋‚œ ๊ฐ•์˜์‹ค) is a smart classroom platform that automates and assists repetitive tasks in lecture environments using cutting-edge computer vision technologies. Our system supports face-recognition attendance, real-time lecture material interaction, and random presenter selectionโ€”all in one seamless pipeline.

๐Ÿ’ก What Makes Us Special

  • ๐ŸŽฏ Automated Attendance: Face recognition-based attendance system
  • ๐Ÿ–๏ธ Interactive Lectures: Hand gesture-controlled pointer and slides
  • ๐ŸŽฒ Fair Selection: Random presenter selection from detected students
  • ๐Ÿš Flexible Input: Supports both drone and Raspberry Pi camera inputs

๐ŸŽจ Our Projects

๐ŸŽ“

Uhm-Tendance

Face Recognition Attendance

Automated attendance checking using PyTorch CNN models

๐Ÿ–๏ธ

Pow-Uhm Point

Interactive Lecture System

Hand gesture recognition for pointer and slide control

๐ŸŽฒ

Pick Me, Uhm!

Presenter Selection System

Random selection from crowd-detected students


๐Ÿ› ๏ธ Tech Stack

Core Technologies

Infrastructure

Frontend


๐Ÿ“Š System Architecture

graph LR
    A[๐Ÿš Drone/PiCam] -->|Video Stream| B[๐Ÿ“น ZMQ Server]
    B -->|Frames| C[๐Ÿค– CV Processing]
    C -->|Recognition Results| D[๐Ÿ“ก WebSocket Server]
    D -->|Real-time Data| E[๐Ÿ–ฅ๏ธ Web Dashboard]
    C -->|Attendance Data| F[๐Ÿ“Š CSV Reports]
Loading

How It Works

Component Input Processing Output
Uhm-Tendance Video frames PyTorch CNN + Face Recognition Attendance records
Pow-Uhm Point Video frames MediaPipe + Hand Tracking Pointer coordinates
Pick Me, Uhm! Video frames OpenCV + Object Detection Selected student

๐Ÿ‘ฅ Team Members


๊น€ํƒœํ™”

๐Ÿ“ Documentation

๊น€ํƒœ๋Ÿ‰

๐Ÿ–๏ธ Gesture Recognition

๋ฐ•ํ˜•๋นˆ

๐Ÿ–๏ธ Hand Tracking

์ด์ฐฌ

๐ŸŽ“ Attendance System

ํ™์„์ง„

๐ŸŽฒ Presenter Selection

์†์ฐฌ์ˆ˜

๐Ÿš Hardware Setup

์†์ธํ™”

๐ŸŽ“ Face Recognition

์ด๊ฐ€์€

๐Ÿ’ป Web Development

๐ŸŽฏ Key Features

๐ŸŽ“ Uhm-Tendance (Face Recognition Attendance)

# Real-time attendance tracking
- PyTorch-based CNN classification
- ZMQ video stream processing
- WebSocket broadcasting
- CSV report generation

Technologies: OpenCV, PyTorch, ZMQ, WebSocket

๐Ÿ–๏ธ Pow-Uhm Point (Interactive Lecture Material)

# Gesture-based slide control
- Hand keypoint detection
- Gesture classification
- Pointer coordinate mapping
- Slide navigation control

Technologies: OpenCV, MediaPipe, Hand Tracking

๐ŸŽฒ Pick Me, Uhm! (Random Presenter Selection)

# Fair student selection
- Crowd detection
- Student counting
- Random selection algorithm
- Visual feedback system

Technologies: OpenCV, Object Detection, DNN


๐Ÿš€ Quick Start

Prerequisites

# Python 3.8 or higher
python --version

# Install dependencies
pip install -r requirements.txt

Installation

# Clone the repository
git clone https://github.com/your-org/uhm-azing-classroom.git
cd uhm-azing-classroom

# Set up virtual environment
conda create -n icv python=3.8
conda activate icv

# Install packages
pip install opencv-python torch torchvision mediapipe websockets pyzmq

Running the System

# 1. Start AI Server
python 03_run_attendance_server.py

# 2. Start Camera Client (Drone/PiCam)
python zmq_client.py

# 3. Open Web Dashboard
# Navigate to ws://localhost:5556

๐Ÿ“š Documentation


๐ŸŽฌ Demo

๐ŸŽฅ Live Demonstration

์‹ค์ œ ๊ฐ•์˜์‹ค ํ™˜๊ฒฝ์—์„œ ํ…Œ์ŠคํŠธ๋œ ์‹ค์‹œ๊ฐ„ ์‹œ์Šคํ…œ

๐Ÿ“น Attendance System

Real-time face recognition

๐Ÿ‘‹ Gesture Control

Interactive slide navigation

๐ŸŽฒ Random Selection

Fair presenter picking


๐Ÿค Contributing

We welcome contributions! Please check out our Contributing Guidelines.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“ซ Contact


๐Ÿ“œ License

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


๐Ÿ™ Acknowledgments

  • Computer Vision Course, University
  • Professor Uhm and Teaching Assistants
  • All team members for their dedication
  • Open source community

๐ŸŒŸ Star us on GitHub โ€” it motivates us a lot!

Built with โค๏ธ by Team 4 | Computer Vision Term Project

โฌ†๏ธ Back to Top

Popular repositories Loading

  1. Uhm-Tendance Uhm-Tendance Public

    Python

  2. .github .github Public

Repositories

Showing 2 of 2 repositories

Top languages

Loadingโ€ฆ

Most used topics

Loadingโ€ฆ