Skip to content

pilot-j/sonar_hack

Repository files navigation

🌍 Ramble – Your AI Travel Companion

Submission for the Perplexity Global Hackathon

Travel smarter with Ramble: Real-time cultural intelligence, voice-guided checkpoints, and itinerary-aware AI — powered by Perplexity SONAR.


🎥 Watch the Demo

Watch the video


🧭 What is Ramble?

amble is an AI-powered travel app that offers context-aware voice navigation, cultural guidance, and personalized itineraries tailored to India's vast diversity. Whether you're wandering through the spiritual lanes of Amritsar, exploring tribal art in Madhya Pradesh, or savoring coastal traditions in Kerala, Ramble acts as your hyperlocal, always-on guide, delivering step-by-step directions enriched with regional customs, history, and storytelling.

Unlike traditional travel apps, Ramble doesn’t just tell you where to go — it helps you understand the "why", "how", and cultural context that makes each destination in India unique.


❓ Why Ramble?

Travelers today rely on a mix of outdated blogs, YouTube videos, and generic travel apps. Ramble bridges this gap by delivering real-time, trusted, and regionally relevant guidance using AI.

  • 🧳 No more Googling "what to do in Amritsar" — ask Ramble and get updated, cited information.
  • 🙏 No more cultural missteps — Ramble explains customs, rituals, and local etiquette.
  • 📍 No more static itineraries — Ramble adapts to your plans and guides you in real time.

🧠 Powered by SONAR

Ramble is built using Perplexity’s SONAR API (Search + Reasoning + Deep Research) to:

  • Fetch real-time answers with citations
  • Deliver region-specific and culturally accurate content
  • Support multi-turn reasoning and follow-up questions
  • Use LLM augmentation to expand SONAR’s short-form responses with rich detail

🗺️ Key Features

  • 🎙️ Voice-first AI Chat
    Hands-free travel assistant that understands and replies through speech

  • 🧭 Checkpoint-Based Flow
    Stepwise navigation with cultural/historic context — e.g., Golden Temple: remove shoes → token counter → gate significance → Sarovar → Darbar Sahib

  • 🛕 Dynamic “Explore India” Section
    Explore Food Trails, Local Crafts, Hidden Gems, and Cultural Moments per state

  • 📅 Itinerary-Aware Assistant
    Paste your plan — Ramble reads your trip and prepares guidance for each spot

  • 🧠 Hybrid SONAR + LLM Engine
    Fixes short answers using reasoning-aware chains of thought and fallback models

  • 📱 Responsive UI, Mobile-First
    Region-personalized, clean design with friendly avatar and animations


📐 Flow Diagram

flow_diag


🛠️ Tech Stack

  • Frontend: React (Vite), TypeScript, Tailwind CSS, shadcn-ui, Framer Motion
  • Voice & Chat: Custom agent with Perplexity SONAR API + LLM fallback
  • Other Tools: Lucide, Embla Carousel, Tailwind Merge, Resizable Panels

🧪 How to Run Locally

# Clone the repo
git clone https://github.com/pilot-j/sonar_hack
cd ramble

# Install dependencies
npm install

# Start development server
npm run dev

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •