{"id":48577934,"url":"https://github.com/vlad1343/rest-quest","last_synced_at":"2026-04-08T16:03:51.007Z","repository":{"id":328870215,"uuid":"1111913173","full_name":"Vlad1343/Rest-Quest","owner":"Vlad1343","description":"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.","archived":false,"fork":false,"pushed_at":"2025-12-15T22:10:28.000Z","size":218,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-19T06:26:21.115Z","etag":null,"topics":["computer-vision","emotion-recognition","greatunihack","hackathon","llm","python","react","traveltech"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vlad1343.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-07T21:32:03.000Z","updated_at":"2025-12-15T22:10:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Vlad1343/Rest-Quest","commit_stats":null,"previous_names":["vlad1343/rest-quest"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Vlad1343/Rest-Quest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vlad1343%2FRest-Quest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vlad1343%2FRest-Quest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vlad1343%2FRest-Quest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vlad1343%2FRest-Quest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vlad1343","download_url":"https://codeload.github.com/Vlad1343/Rest-Quest/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vlad1343%2FRest-Quest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31562697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","emotion-recognition","greatunihack","hackathon","llm","python","react","traveltech"],"created_at":"2026-04-08T16:03:50.675Z","updated_at":"2026-04-08T16:03:50.992Z","avatar_url":"https://github.com/Vlad1343.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Rest Quest**\n\n\u003e **🥉 3rd Place** at the **GreatUniHack 2025** — **Booking.com Challenge**\n---\n\n## 🚀 Overview\n\n![Booking Summary](photos/photo4.png)  \n**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.\n\n---\n\n## 💡 Core Features\n\n### 🌊 Emotionally Intelligent Hero\n\n![Booking Summary](photos/photo3.jpg)  \n\n- FlowPattern ribbons, ParticleField fog, and an animated RestQuestLogo breathe with the guest.\n- AmbientCursor + CinematicJourney sync gradients, parallax focus, and SpiritBird trails as visitors scroll.\n\n### 🧠 Emotional Check-In \u0026 Analysis Lab\n\n![Booking Summary](photos/photo2.jpg)  \n\n- Glassmorphic journal chat with empathy typing, ambient soundscapes, and breathing overlay (press `Space`).\n- `mockEmotionAnalysis` transforms journal text into stress/energy/valence scores powering RadialProgress gauges, trigger bar charts (Recharts), and focus-tag recommendations.\n\n### 🎯 Conversational Preferences \u0026 Recommendation Deck\n\n![Booking Summary](photos/photo1.jpg)  \n\n- `PreferencesContext` stores travel moods, ritual pace, destination search, and intensity sliders with celebratory micro-interactions via Framer Motion.\n- Tinder-style swipe deck driven by `useCardSwipe`, @use-gesture/react, undo history, “Learn More” modals, and priority lists for premium retreats.\n\n### 🧘‍♀️ Celebration, Booking, and Ritual Wrap-Up\n\n- Booking Summary compares saved experiences, opens itinerary modals, and highlights priority tags.\n- CelebrationSection fires particle bursts, breathing cues, and CTA buttons once enough likes are tracked.\n\n### 🎥 Emotion \u0026 Voice Toolkit (Python)\n\n- `project/camera.py` mixes OpenCV, MediaPipe, DeepFace, and FER fallback to log emotion spectrums per answer.\n- ElevenLabs STT/TTS + Gemini prompts (via `elabs1.py` and `gemini_client1.py`) capture, transcribe, and narrate follow-up questions and travel suggestions in seconds.\n- Mock mode lets teams demo the flow without heavy ML dependencies or API keys.\n\n---\n\n## 🏗️ Tech Stack\n\n| Layer | Technologies |\n|:------|:-------------|\n| **Frontend Runtime** | React 18, Vite, JSX, Context API |\n| **Styling \u0026 Motion** | Tailwind CSS, custom globals, Framer Motion, @react-spring/web |\n| **Interaction** | @use-gesture/react, Lottie-react, Lucide-react, Recharts |\n| **State \u0026 Data** | EmotionalContext, PreferencesContext, ExperiencesContext, localStorage |\n| **Toolkit Runtime** | Python 3.10+, OpenCV, MediaPipe, DeepFace, FER, TensorFlow 2.15 |\n| **Speech \u0026 LLM** | ElevenLabs STT/TTS SDK, Google Gemini (Flash Lite), dotenv |\n| **Audio \u0026 I/O** | sounddevice, numpy, threading warmups, mock video fallbacks |\n\n---\n\n## 🧠 Why Rest Quest Stands Out\n\n✅ **Full-sensory UI** — cinematic gradients, particle fog, and SpiritBird trails respond to every section.  \n✅ **Emotion-first recommendations** — keyword analysis drives biometrics, triggers, and retreat focus tags.  \n✅ **Swipeable concierge** — likes, super-likes, undo, and saved-match overlays mirror best-in-class travel apps.  \n✅ **On-device privacy** — journaling stays local; Python toolkit runs camera + audio processing without cloud uploads.  \n✅ **LLM-guided empathy** — Gemini follow-ups adopt a calm, concierge tone powered by reproducible prompts.  \n✅ **Inclusive interactions** — reduced-motion support, keyboard controls, ambient sound toggles, and screen-reader friendly structure.  \n\n---\n\n## 🏅 Wellness Milestones\n\n| **Milestone** | **Criteria** |\n|---------------|--------------|\n| First Breath | Complete the Emotional Check-In journey |\n| Ritual Curator | Save 3+ experiences to the liked stack |\n| Priority Seeker | Mark at least two retreats as priority |\n| Breathing Master | Trigger the breathing overlay three times via `Space` |\n| Globe Collector | Explore five destination suggestions in Preferences |\n| Calm Analyst | Unlock the Analysis Lab after two journal submissions |\n| Celebration Spark | Reach CelebrationSection with ≥3 liked retreats |\n\n---\n\n## 🌐 Guest Journey\n\n1. **Landing Ritual** – FlowPattern hero, breathing orb, and CTA to “Begin Emotional Scan.”  \n2. **Emotional Check-In** – Guests journal or speak; AI echo responds with quantified stress + guidance.  \n3. **Preferences Dialogue** – Sliders, pills, and suggestions capture mood, pace, and desired rituals.  \n4. **Analysis Lab** – Concentric biometrics, trigger charts, and focus tags explain the AI diagnosis.  \n5. **Recommendation Deck** – Swipeable cards with gesture, keyboard, and modal controls capture intent.  \n6. **Booking \u0026 Celebration** – Saved stack becomes comparison tables, itinerary modals, and celebratory cues.  \n7. **Emotion CLI** – Optional live session logs facial cues + transcripts for concierge follow-up.  \n\n---\n\n## 🔮 Future Enhancements\n\n- 🩺 **Live sentiment fusion** — pipe ElevenLabs/Gemini transcripts directly into the SPA’s `EmotionalContext`.  \n- 📍 **Geo-personalized content** — integrate map previews and flight sourcing for each retreat card.  \n- 🎧 **Adaptive soundscapes** — sync AmbientSoundscape layers with real stress/energy telemetry.  \n- ☁️ **Persistent profiles** — push liked stacks and questionnaires to Supabase / Firestore for multi-device continuity.  \n- 📊 **Session analytics dashboard** — render `project/emotion_results.jsonl` inside the SPA for concierge review.  \n- 📱 **Companion mobile shell** — wrap the SPA in Capacitor/Expo for in-resort kiosks.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvlad1343%2Frest-quest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvlad1343%2Frest-quest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvlad1343%2Frest-quest/lists"}