https://github.com/vlad1343/rest-quest

Rest Quest is an emotion-aware wellness travel concierge that transforms how users feel into personalized retreat recommendations, combining a cinematic React experience with on-device emotion and voice analysis for a human-like, privacy-first planning flow.
https://github.com/vlad1343/rest-quest

computer-vision emotion-recognition greatunihack hackathon llm python react traveltech

Last synced: 3 months ago
JSON representation

Rest Quest is an emotion-aware wellness travel concierge that transforms how users feel into personalized retreat recommendations, combining a cinematic React experience with on-device emotion and voice analysis for a human-like, privacy-first planning flow.

• Host: GitHub
• URL: https://github.com/vlad1343/rest-quest
• Owner: Vlad1343
• Created: 2025-12-07T21:32:03.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-12-15T22:10:28.000Z (7 months ago)
• Last Synced: 2025-12-19T06:26:21.115Z (7 months ago)
• Topics: computer-vision, emotion-recognition, greatunihack, hackathon, llm, python, react, traveltech
• Language: Python
• Homepage:
• Size: 213 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# **Rest Quest**

> **🥉 3rd Place** at the **GreatUniHack 2025** — **Booking.com Challenge**

---

## 🚀 Overview

![Booking Summary](photos/photo4.png)  

**Rest Quest** is a dual-surface, emotion-aware concierge that closes the gap between how travelers feel and how they plan wellness escapes. The React SPA delivers a cinematic, tactile journey from emotional check-in to curated retreat decks, while the Python toolkit captures facial cues, transcribes live audio with ElevenLabs, and asks Gemini-powered follow-ups that feel like a human concierge. Together they reduce decision fatigue, surface hyper-personal rituals, and keep every interaction privacy-aware on-device.

---

## 💡 Core Features

### 🌊 Emotionally Intelligent Hero

![Booking Summary](photos/photo3.jpg)  

- FlowPattern ribbons, ParticleField fog, and an animated RestQuestLogo breathe with the guest.

- AmbientCursor + CinematicJourney sync gradients, parallax focus, and SpiritBird trails as visitors scroll.

### 🧠 Emotional Check-In & Analysis Lab

![Booking Summary](photos/photo2.jpg)  

- Glassmorphic journal chat with empathy typing, ambient soundscapes, and breathing overlay (press `Space`).

- `mockEmotionAnalysis` transforms journal text into stress/energy/valence scores powering RadialProgress gauges, trigger bar charts (Recharts), and focus-tag recommendations.

### 🎯 Conversational Preferences & Recommendation Deck

![Booking Summary](photos/photo1.jpg)  

- `PreferencesContext` stores travel moods, ritual pace, destination search, and intensity sliders with celebratory micro-interactions via Framer Motion.

- Tinder-style swipe deck driven by `useCardSwipe`, @use-gesture/react, undo history, “Learn More” modals, and priority lists for premium retreats.

### 🧘‍♀️ Celebration, Booking, and Ritual Wrap-Up

- Booking Summary compares saved experiences, opens itinerary modals, and highlights priority tags.

- CelebrationSection fires particle bursts, breathing cues, and CTA buttons once enough likes are tracked.

### 🎥 Emotion & Voice Toolkit (Python)

- `project/camera.py` mixes OpenCV, MediaPipe, DeepFace, and FER fallback to log emotion spectrums per answer.

- ElevenLabs STT/TTS + Gemini prompts (via `elabs1.py` and `gemini_client1.py`) capture, transcribe, and narrate follow-up questions and travel suggestions in seconds.

- Mock mode lets teams demo the flow without heavy ML dependencies or API keys.

---

## 🏗️ Tech Stack

| Layer | Technologies |

|:------|:-------------|

| **Frontend Runtime** | React 18, Vite, JSX, Context API |

| **Styling & Motion** | Tailwind CSS, custom globals, Framer Motion, @react-spring/web |

| **Interaction** | @use-gesture/react, Lottie-react, Lucide-react, Recharts |

| **State & Data** | EmotionalContext, PreferencesContext, ExperiencesContext, localStorage |

| **Toolkit Runtime** | Python 3.10+, OpenCV, MediaPipe, DeepFace, FER, TensorFlow 2.15 |

| **Speech & LLM** | ElevenLabs STT/TTS SDK, Google Gemini (Flash Lite), dotenv |

| **Audio & I/O** | sounddevice, numpy, threading warmups, mock video fallbacks |

---

## 🧠 Why Rest Quest Stands Out

✅ **Full-sensory UI** — cinematic gradients, particle fog, and SpiritBird trails respond to every section.  

✅ **Emotion-first recommendations** — keyword analysis drives biometrics, triggers, and retreat focus tags.  

✅ **Swipeable concierge** — likes, super-likes, undo, and saved-match overlays mirror best-in-class travel apps.  

✅ **On-device privacy** — journaling stays local; Python toolkit runs camera + audio processing without cloud uploads.  

✅ **LLM-guided empathy** — Gemini follow-ups adopt a calm, concierge tone powered by reproducible prompts.  

✅ **Inclusive interactions** — reduced-motion support, keyboard controls, ambient sound toggles, and screen-reader friendly structure.  

---

## 🏅 Wellness Milestones

| **Milestone** | **Criteria** |

|---------------|--------------|

| First Breath | Complete the Emotional Check-In journey |

| Ritual Curator | Save 3+ experiences to the liked stack |

| Priority Seeker | Mark at least two retreats as priority |

| Breathing Master | Trigger the breathing overlay three times via `Space` |

| Globe Collector | Explore five destination suggestions in Preferences |

| Calm Analyst | Unlock the Analysis Lab after two journal submissions |

| Celebration Spark | Reach CelebrationSection with ≥3 liked retreats |

---

## 🌐 Guest Journey

1. **Landing Ritual** – FlowPattern hero, breathing orb, and CTA to “Begin Emotional Scan.”  

2. **Emotional Check-In** – Guests journal or speak; AI echo responds with quantified stress + guidance.  

3. **Preferences Dialogue** – Sliders, pills, and suggestions capture mood, pace, and desired rituals.  

4. **Analysis Lab** – Concentric biometrics, trigger charts, and focus tags explain the AI diagnosis.  

5. **Recommendation Deck** – Swipeable cards with gesture, keyboard, and modal controls capture intent.  

6. **Booking & Celebration** – Saved stack becomes comparison tables, itinerary modals, and celebratory cues.  

7. **Emotion CLI** – Optional live session logs facial cues + transcripts for concierge follow-up.  

---

## 🔮 Future Enhancements

- 🩺 **Live sentiment fusion** — pipe ElevenLabs/Gemini transcripts directly into the SPA’s `EmotionalContext`.  

- 📍 **Geo-personalized content** — integrate map previews and flight sourcing for each retreat card.  

- 🎧 **Adaptive soundscapes** — sync AmbientSoundscape layers with real stress/energy telemetry.  

- ☁️ **Persistent profiles** — push liked stacks and questionnaires to Supabase / Firestore for multi-device continuity.  

- 📊 **Session analytics dashboard** — render `project/emotion_results.jsonl` inside the SPA for concierge review.  

- 📱 **Companion mobile shell** — wrap the SPA in Capacitor/Expo for in-resort kiosks.