Essential Relaxation 🧘

The Problem Worth Solving

Stress is invisible — until it shows up on your face. Dark circles, eye bags, tension lines, dryness, redness, loss of firmness, faded radiance. Most people notice these signs but have no idea what to do with them beyond skincare products that treat the surface.

Essential Relaxation treats the cause — stress itself.

The app uses Perfect Corp's YouCam AI Skin Analysis API to read the stress signals on your face and translates them into a personalized relaxation experience. Not generic wellness advice. A response calibrated to what your face is actually showing. There's no other app that does this — reads your stress biometrically and responds with a matched nature experience, an artwork, a guided audio passage, essential oils matched to your stress, and a relaxation ring you can try on your hand (with Perfect Corp's YouCam AI Ring Virtual Try-On API) before you buy it, all in one flow.

I built it for my wife. I think anyone who needs a moment of calm will get something from it.


Who It's For

Anyone who needs to decompress but doesn't know where to start. You don't need to know you're stressed — your face already does. The app reads it for you and gives you exactly what you need in that moment: a landscape that speaks to your specific stress, an artwork made from it, a passage read aloud to you, the essential oils that will help, and a relaxation ring — matched to your stress and virtually tried on your hand — that you can keep spinning long after the session ends.


What It Does

  1. Upload a selfie — AI skin analysis scans 7 stress indicators (fatigue, tension, dryness, dark circles, flushing, weariness, faded glow) and scores each by severity.
  2. See your Stress Profile — each concern is mapped to a relatable label with severity (e.g. eye bag: fatigue (high), moisture: dryness (mild)).
  3. Choose from 3 landscapes — an LLM translates your stress profile into a therapeutic landscape description, matched against a vector database of 100s of landscape photos. The 3 closest matches are shown — or browse further with next 3.
  4. Experience relaxation — the app generates an abstract artwork from your chosen landscape, writes a calming 80-100 word passage, and reads it aloud via text-to-speech. Hit replay or loop it for a full meditation session.
  5. Enhance with essential oils — optionally match 3 or more essential oils to your specific stress indicators, with aromatherapy justification for each. Get a custom diffuser blend recipe showing exactly how to combine them. Order them on Instacart without leaving the app — no store, no hunting, no checkout line.
  6. Find & try on a relaxation ring — spinner and rolling rings give your hands a quiet, rhythmic motion to unwind with. The app finds real, in-stock rings and biases the style to your stress — a fast spin to discharge tension, a slow roll to ease tiredness, or any style to browse. Pick one and try it on your hand with YouCam's AI Ring Virtual Try-On — upload or snap a photo of the back of your hand, choose the finger and position, and see the ring rendered onto your hand with realistic lighting and shadow. Like it? Buy it from the merchant in one tap.
  7. Save your session — create a collage of your landscape, its abstract artwork, and the other recommended landscapes. Download it and keep it as something to come back to when you need calm again.

How It Works

The Pipeline

Selfie
  → YouCam Skin Analysis API → stress scores (7 indicators)
      → Gemini 2.5 Flash Lite (skin_to_landscape prompt) → landscape description
          → Gemini Embedding 2 (image + text in shared vector space) → cosine similarity search
              → top 3 landscape matches from pre-computed image embedding index
                  → user selects landscape
                      ┌───────────────────────────────────────────────────┐
                      │ parallel                                          │
                      │  Gemini Vision → landscape description            │
                      │    → YouCam Image to Image v2 → abstract artwork  │
                      │    → Nemotron 3.5 Lightning → relaxation passage  │
                      └───────────────────────────────────────────────────┘
                          → Browser TTS reads passage aloud
                              → optional: Gemini → essential oils list
                                  ├── Nemotron 3.5 Lightning → relaxation recipe
                                  └── Gemini + Google Search → UPC codes
                                          → Instacart Products Link API → shopping list

Find relaxation rings (stress-biased style)
  → Channel3 Search API (agentic, 'rings' category, in-stock, price-capped) → ring products
      → Gemini 2.5 Flash Lite vision screen → keep only clean single-ring product shots
          → ring gallery
              → user picks a ring + uploads/snaps a hand photo
                  → Perfect Corp YouCam AI Ring Virtual Try-On API (2d-vto/ring)
                      → ring rendered onto the hand (finger + position controllable)
                          → optional: one-tap buy at the merchant

The Semantic Landscape Matching — the Core Idea

The most technically interesting piece is how landscapes are matched to stress profiles without any labeled training data.

Offline: Each landscape .jpg is embedded by Gemini Embedding 2 into a 3072-dimensional vector. Gemini's multimodal embedding model places images and text in the same semantic space — so an image of a misty lake and the words "misty lake" land near each other.

At runtime: The stress profile is fed to Gemini with a mapping guide that translates each stress indicator into concrete visual elements:

fatigue → peaceful stillness: undisturbed lakes, sleeping valleys, sheltered coves
dryness → water-rich scenes: rivers, misty forests, dewy meadows, waterfalls
tension → smooth, flowing elements: calm water, gentle rolling hills, soft clouds

This produces a landscape description which is embedded into the same space as the images. Cosine similarity finds the 3 closest matches. No fine-tuning, no labeling — just a shared semantic space and a well-designed prompt.

The Ring Virtual Try-On — Seeing It On Your Hand

A relaxation ring is one part of the experience you take with you — a spinner or rolling band gives your hands a slow, soothing motion to return to, any time stress creeps back. But a ring you can't picture on your hand is just another product listing. Perfect Corp's YouCam AI Ring Virtual Try-On API closes that gap: you see the ring on your hand before you commit.

Stress-biased discovery. The ring search is personalized the same way everything else is — from your stress profile. A high tension reading defaults the style to a fast spin (fast, continuous motion to discharge restless energy); fatigue or weariness defaults to a slow roll (a slow, grounding glide). You can override to any style and browse. The rings themselves come from the Channel3 Search API in agentic mode, constrained to the rings category, in-stock, and price-capped so the results stay in a sensible, calming consumer range — not fine jewelry.

Only try-on-able rings reach you. Channel3 serves many product photos that aren't suited to a virtual try-on — multiple rings in one shot, or a ring already worn on a hand in a lifestyle scene. The try-on works beautifully on a clean, single-ring product shot, so the app screens each product's image with a Gemini 2.5 Flash Lite vision pass first and keeps only those. By the time you see the gallery, every ring in it is one the try-on can render cleanly.

The try-on itself. Pick a ring, then give the app a hand: upload a photo, snap one with your webcam, or paste from the clipboard (same flexible capture as the face selfie). The ring image is fetched, converted to a YouCam-compatible format, and sent with your hand to the YouCam 2d-vto/ring endpoint along with the finger (thumb → little) and position (base knuckle → mid-finger) you choose. YouCam detects the hand, places the ring with realistic shadow and ambient lighting matched to your photo, and returns a composite that genuinely looks like you're wearing it. The hand persists, so you can try ring after ring without re-uploading.

Then you can actually buy it. Each ring carries a real merchant buy link, so the loop closes — try it on, then purchase in one tap — without the try-on ever being buried under a storefront. The try-on is the focus; buying is a quiet afterthought, because for this app the point is the calm the ring brings, not the transaction.

Model Selection

Different tasks use different AI models, chosen deliberately:

  • Gemini 2.5 Flash Lite for structured mapping (stress → landscape, stress → oils, oils → UPCs) — fast and sufficient for instruction-following tasks with explicit guides
  • Gemini Vision for landscape photo analysis — describes the selected landscape in sensory detail, feeding both the artwork generator and Nemotron
  • Nemotron 3.5 Lightning for the relaxation passage and recipe — chosen for its warm, flowing prose quality that makes meditative text feel genuinely calming
  • Perfect Corp youcam-image-v2 for artwork — produces richer, more dreamlike abstract imagery than alternatives tested

Eight Prompts

The app's intelligence runs on 8 carefully engineered prompts:

  1. Stress-to-landscape mapping — translates 7 stress indicators into a concrete 2-3 sentence visual description, constrained to searchable language (no metaphors, no poetry) because it feeds directly into the embedding search
  2. Landscape vision — describes a landscape photo in sensory-rich detail, feeding both the artwork generator and Nemotron
  3. Abstract artwork generation — instructs the image model to create a fully non-representational pattern, explicitly prohibiting literal depictions
  4. Relaxation passage — 80-100 word calm passage designed for TTS, avoiding poetic flourishes that feel performative when spoken aloud
  5. Essential oils recommendation — maps stress indicators to 3-5 single essential oils with aromatherapy justification, outputs structured JSON
  6. Relaxation recipe — given the recommended oils and their benefits, generates a custom diffuser blend with drop counts, blend name, and aromatherapy rationale for each ingredient
  7. UPC lookup — uses Gemini with Google Search grounding to find real UPC codes for 0.5 oz bottles, enabling accurate Instacart product matching
  8. Ring try-on screening — judges whether a ring product photo is a clean single-ring shot suitable for the virtual try-on, so only try-on-ready rings reach the gallery

Infrastructure

  • Gradio — async UI with streaming so results appear progressively without blocking
  • NumPy — in-memory vector store; full embedding index loads once at startup, cosine similarity is a single matrix multiply
  • LangChain — LLM chaining and prompt templating
  • Pillow — converts ring product images to the format the ring try-on requires
  • Tenacity — retry with exponential backoff for all external API calls
  • Google Cloud Run — fully managed serverless platform

The Experience

The app is designed to never make you wait in silence. Results appear as they're ready — the landscape matches show immediately, the artwork loads while the passage is being written, and the passage starts reading aloud as soon as it's done. You can replay it, loop it, or mute it. The pacing is intentional: a relaxation app that feels rushed or broken defeats its own purpose. The whole flow from selfie to relaxation takes about 30 seconds and requires nothing from you except choosing a landscape.


The Product Decisions That Matter

Why landscapes? Nature has the most robust evidence base for stress reduction — attention restoration theory, stress recovery theory. It's not a gimmick. The app picks the right kind of nature for your specific stress, not a random peaceful image.

Why abstract artwork? Looking at representational landscape photos keeps your mind active identifying things. Abstract artwork lets you drift. The prompt explicitly prohibits literal depictions for this reason.

Why Nemotron 3.5 Lightning for the passage? Tested multiple models. Nemotron's prose has a distinctive warmth and natural rhythm that makes the meditative text feel genuinely calming when read aloud. Other models produce text that sounds like instructions.

Why essential oils + Instacart? The app name isn't accidental — aromatherapy is a natural complement to the visual and audio relaxation experience. Each oil is matched to your specific stress indicators, not a generic recommendation. And oils are only useful if you actually have them — ordering from within the app using UPC codes for accurate product matching removes the friction of a separate shopping trip. One less thing to think about is itself a form of stress reduction.

Why the relaxation recipe? A list of oils is information. A recipe is something you can actually do. The recipe prompt takes the same oils and their stress-specific benefits and turns them into a named diffuser blend with drop counts and rationale — so you know not just which oils to buy but exactly how to use them together. It closes the loop between the recommendation and the practice.

Why a relaxation ring — and why try it on? The oils engage smell; the landscape and artwork engage sight; the passage engages hearing. A spinner or rolling ring engages touch — a quiet, repeatable motion for your hands that you can carry anywhere, long after the session ends. It rounds out the senses. But a ring only becomes real when you can see it on your hand, which is exactly what YouCam's AI Ring Virtual Try-On makes possible — matched to your stress, rendered on your hand, before you spend a cent. The try-on is the experience; buying is deliberately a one-tap afterthought.

Why screen ring images with a vision model? A virtual try-on is only as good as the product photo it's given. Marketplace listings are full of multi-ring shots and on-hand lifestyle photos that aren't the right input for a single-ring try-on. Rather than let a user pick one of those, a Gemini vision pass pre-filters the catalog so every ring in the gallery is a clean single-ring shot the try-on renders beautifully. The best way to ensure a great try-on is to feed it a great photo.

Why TTS in the browser? No API call, no latency, no key. The Web Speech API runs client-side. For a relaxation app, removing any delay between selecting a landscape and hearing the passage matters.

Why the collage? The session should leave something tangible. A downloaded collage gives you a visual reminder of that moment of calm — something to come back to.


Challenges Solved

  • Stress-to-landscape prompt conflicts — early versions produced contradictory visual signals (e.g. tired eyes → dim scenes conflicted with faded glow → bright scenes). The final guide resolves conflicts by prioritizing severity and finding elements that satisfy multiple concerns simultaneously.
  • Embedding quality — solved by using the Kaggle landscape dataset which provides 100s of varied photos, giving the vector search enough coverage to return meaningfully different results for different stress profiles.
  • Instacart product matching — their Products Link API is grocery-optimized. UPC-based matching via Gemini + Google Search grounding significantly improves essential oil resolution compared to name-only search.
  • Ring photos not suited to a try-on — the ring try-on shines on clean, single-ring product shots, but marketplace listings also include multi-ring and on-hand lifestyle photos that aren't the right input. Solved by screening each ring image with a Gemini vision pass before it reaches the gallery, keeping only clean single-ring shots — so the try-on always gets the input it needs.
  • WebP to the try-on format — Channel3 serves product images as WebP, which the YouCam ring try-on rejects. Pillow converts each selected ring to PNG (and downsizes if needed) on the way to the try-on.
  • A gallery that always looks right — after filtering sets, duplicates, and vision-rejected images, a search can come up short of a full grid. The service over-fetches, de-duplicates by title, and backfills any remaining gaps so the ring gallery is always full and never shows a hole.
  • Progressive UI — async generators stream intermediate states (show landscape immediately, then artwork, then passage) without breaking the calm pacing of the experience.

Essential Relaxation

I built this for my wife but I think anyone who needs a moment of calm will get something from it. You upload a selfie, the app reads your stress and finds you a landscape, turns it into an abstract artwork just for you, reads you a passage, matches you the oils that help, and lets you try on a ring you can keep spinning. That's it — and you're somewhere soothing for a while.

Built With

  • channel3-product-search
  • gemini-flash
  • gemini-vector-search
  • gemini-vision
  • google-cloud-run
  • google-embedding
  • gradio
  • grounding-with-google-search
  • instacart
  • kaggle-dataset
  • langchain
  • nebius
  • nvidia-nemotron
  • pillow
  • python
  • tenacity
  • youcam-ai-image-to-image-api
  • youcam-ai-ring-virtual-try-on-api
  • youcam-ai-skin-analysis-api
Share this project:

Updates

Submission history