Inspiration
I had a dream once of fish reaching the size of dinosaurs—large shining fish that rose from the skies and sailed across the stars, covering galaxies with watery worlds. I woke up, found my dream hilarious and wondered: if our minds can dream big like a movie, shouldn’t AI help us understand them? The moment “What just happened?” popped into our minds gave rise to Dreamscape Navigator—an app that turns our wild mid-dream antics into stories, poems or simple illustrations.
What it does
- Interpretation: Transforms bits of dreams you don’t understand into straightforward, easy-to-follow explanations.
- Poem: Turns your nighttime ideas into fun, bite-sized verses.
- Imagery: Conjures AI-generated dreamlike scenes—think you sleeping on fluffy clouds in the sky.
- Presentation: Displays everything in animated “cloud” bubbles, complete with scrollbars for the longest tales.
How we built it
- Frontend: React + Vite + Tailwind CSS for a snappy, minimalist UI; Framer Motion brings each chat bubble to life with smooth, playful animations.
- Backend: FastAPI (with Uvicorn) orchestrates streaming calls to Perplexity’s Sonar API for text interpretations and the Replicate API for optional dream art.
- Local Development & Testing: Runs entirely on your machine—Vite’s dev server on port 3000 and Uvicorn on port 8000—with
.env-protected API keys so you can iterate and debug instantly without deployment overhead.
Challenges we ran into
- Wall-of-Text Overload: Our charming chat bubbles couldn’t keep up when you shared those epic, multi-paragraph dreams—they just spilled out and cluttered the screen.
- Fix: We added a gentle scrollbar so you can dive into long dream tales or collapse them with a click, no layout drama.
- Abstract Inputs: When your dreams turned poetic—like “I was a whisper in a crowded room”—the AI got tangled up and gave confusing responses.
- Fix: We built a tiny pre-processor that drops in context hints (“I felt…,” “I saw…”) so Sonar always has a clear place to start.
- Image Latency: Waiting 8–10 seconds for a full-color dreamscape felt like watching paint dry when you just wanted to see the art.
- Fix: We turned visuals into an optional “bonus round” button—interpretations pop up instantly, and the images load only if you choose to savor them.
Accomplishments that we're proud of
- A Friendly Chat Feel: Beta testers told us it feels “as cozy as texting a friend” and jumped right in without a tutorial.
- Prompt Engineering Magic: After dozens of tweaks, our “context booster” snippets help Sonar nail the meaning—even in the most surreal dream fragments.
- Seamless Art Surprise: Dreamscapes render quietly in the background, so you get the visuals without ever staring at a loading spinner.
- Rock-Solid Testing: Our pytest suite covers everything from empty inputs to marathon-length dreams, so we catch bugs before they ever reach you.
What we learned
- Prompt engineering is an art
We discovered that sometimes tacking on a simple phrase—like “In my dream I felt…”—can turn a vague AI response into something remarkably clear and relatable. - Balancing speed and flair
Keeping text interpretations nearly instant while offering AI-generated images as a fun “bonus round” lets the experience stay snappy without sacrificing the visual wow factor. - Delight in subtle animations
Tiny bubble bounces and gentle fade-ins added just the right sprinkle of magic, making the interface feel alive without ever stealing the spotlight from your dream.
What’s Next for Dreamscape Navigator
Dream Journal Mode : Keep track of all your dream sessions in one place—save, revisit, and reflect whenever inspiration (or curiosity) strikes. Social Sharing : One-click export of your dream interpretations and AI-generated art, so you can wow friends (or your followers) on social. Custom Themes : Pick your dreamscape vibe—switch bubble colors, tweak animations, and make the interface truly yours. Multilingual Dreams :Decode dreams in more languages, from Spanish siestas to Japanese onsen reveries—because the subconscious speaks every tongue. Mobile App :Slip Dreamscape Navigator into your pocket for on-the-go decoding—capture that 4 AM epiphany wherever you are.
Contribuions
Deepak Mallampati – Project Lead and Backend Devolpment Venkata Suma Priya Kankipati – Frontend Devlopment and Integration
Built With
- fastapi
- javascript
- node.js
- npm
- perplexitysonarapi
- pip
- pytest
- python
- react
- replicateapi
- tailwind
- typescript
- uvicorn
- vite
Log in or sign up for Devpost to join the conversation.