Skip to content

pnsw123/iris

Repository files navigation

WNDR Vivid Eye System

Description

WNDR Vivid Eye System is an immersive 3D web experience that creates an infinite cloud of watching eyes. The application uses AI-powered webcam detection to capture your iris pattern and transforms it into anatomically-accurate 3D eyes that follow you through a dark void. You can also upload iris images directly.

Navigate through thousands of eyes using first-person flight controls, watching as they track your movement with organic, sentient-like behavior. Each eye has its own personality - some react quickly while others drift lazily.

If you would like to run the project locally, please see the Installation section below. If you would like to view the live demo, please see the Usage section below.

Installation

To run this project locally:

  1. Clone the repository:

    git clone https://github.com/pnsw123/iris.git
    cd iris
  2. Start a local server (required for webcam access and ES modules). You can use any of these methods:

    Using Python 3:

    python3 -m http.server 8000

    Using Node.js (npx):

    npx serve

    Using VS Code: Install the "Live Server" extension and click "Go Live"

  3. Open your browser and navigate to http://localhost:8000 (or the port shown by your server)

  4. For AI iris scanning, allow camera access when prompted (requires HTTPS or localhost)

Usage

Controls

Key Action
W / Arrow Up Fly forward
S / Arrow Down Fly backward
A / Arrow Left Strafe left
D / Arrow Right Strafe right
Space / Q Fly up
Shift / E Fly down
Mouse Drag Look around
H Hide/Show UI

Features

  • Upload Iris: Click to upload an iris image (JPG, PNG) which will be processed and added to the eye cloud
  • Scan Eye (AI): Uses your webcam with MediaPipe AI to detect and capture your iris in real-time
  • Speed Control: Adjust movement speed from 0.5x to 5x using the slider or preset buttons

Visuals

Main Experience

The infinite eye cloud environment with thousands of eyes tracking your movement through the void.

Scanner Interface

AI-powered iris detection with cyan reticle overlay showing "IRIS LOCKED" when ready to capture.

Controls Guide

On-screen keyboard hints with visual feedback showing which keys are currently pressed.

Authors and Acknowledgment

This project was created as part of CS460 - Computer Graphics at the University of Massachusetts Boston.

Course website: CS460.org

Technologies Used

  • Three.js - WebGL 3D rendering engine by Ricardo Cabello (mrdoob)
  • MediaPipe Face Mesh - Google's ML solution for facial landmark detection
  • WebGL 2.0 - Hardware-accelerated 3D graphics

Built with vanilla JavaScript, WebGL, and AI - no frameworks, just web standards.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages