🗺️ TREVIA – Premium Tourism Intelligence Platform

TREVIA is an advanced, AI-powered Tourism Intelligence Platform designed to provide real-time safety analytics, intelligent travel itineraries, and location-specific guardian insights.

Built for modern travelers, it combines deep data analysis with generative AI to ensure every journey is safe, informed, and culturally enriched.

🔗 Live Application: https://trevia-zeta.vercel.app

---

🌟 Core Features

🛡️ Crime Analysis Engine

• Real-time visualization of incident hotspots
• 6-month crime trend analytics
• Regional dataset-driven risk assessment before travel

🤖 AI-Powered Itinerary Generator

• Personalized travel plans
• Safety-aware routing using local crime insights
• Powered by Gemini 2.0 Flash

🎴 State Guardian Cards

• Safety “Do’s & Don’ts”
• Emergency contacts
• Local cultural intelligence for Indian states

📊 Review Intelligence

• Sentiment analysis of Google Maps reviews
• Extracts objective “Best” and “Worst” user experiences
• Landmark-level intelligence insights

🗣️ Real-Time Translation & TTS

• Multi-language translation
• Text-To-Speech for instant communication bridging

🚗 Transport Route Intelligence

• Real-time comparison:

  • Driving
  • Transit
  • Walking
  • Cycling

• Deep-link integration with ride-sharing services (Uber/Ola)

---

🛠 Technology Stack

Frontend

• Framework: React 18 with Vite
• Styling: Tailwind CSS, Shadcn-UI
• Animations: Framer Motion
• Visualization: Leaflet (OpenStreetMap), Recharts
• Language: TypeScript

Backend

• Framework: FastAPI (Python 3.11)

• AI Orchestration: Google Generative AI (Gemini 2.0 Flash API)

• Data Science: Pandas, VADER Sentiment Analysis

• Third-Party APIs:

  • SerpAPI (Google Maps Intelligence)
  • Google Cloud Translation
  • Google Cloud Text-To-Speech

---

📁 Project Structure

Trevia/
├── app/                        # FastAPI Backend logic
│   ├── config/                 # Gemini & AI engine settings
│   ├── dataset/                # Regional Crime CSVs & Guardian text data
│   ├── models/                 # Pydantic Schemas for data validation
│   ├── routers/                # Modular API Endpoints (Itinerary, Transport, etc.)
│   └── services/               # Core business logic & AI integration layers
├── frontend/                   # React + TypeScript Web App
│   ├── src/
│   │   ├── components/         # Reusable UI (Bento Grids, Interactive Maps)
│   │   ├── pages/              # Module-specific views (Dashboard, Planner)
│   │   └── test/               # Vitest unit testing suite
└── city_pairs.json             # Pre-mapped route intelligence data

---

⚙️ Local Development Setup

1️⃣ Backend Setup

cd Trevia
pip install -r requirements.txt

Create a .env file in the root directory:

GEMINI_API_KEY=your_key_here
SERP_API_KEY=your_key_here

Run the backend server:

uvicorn app.main:app --reload

---

2️⃣ Frontend Setup

cd frontend
npm install
npm run dev

The application will be available at:

http://localhost:8080/

---

🎯 Hackathon Highlights

• ✅ Safety-Centric UX: Risk analysis integrated into the planning workflow
• ⚡ Edge Intelligence: Gemini 2.0 Flash for ultra-low latency AI reasoning
• 🌍 Cultural Context: Guardian Card system for respectful and informed travel

---

🚀 Vision

TREVIA redefines travel planning by merging:

• Preventive intelligence
• AI reasoning
• Cultural awareness
• Real-time analytics

Unlike traditional travel platforms, TREVIA prioritizes informed safety over passive discovery.