# Project export: Auto Trip

This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small.

## Project metadata

- Hackathon: UC Berkeley AI Hackathon 2025
- Tagline: Plan your perfect trip with just your voice — AI-powered travel itineraries and bookings made effortless.
- Devpost: https://devpost.com/software/auto-trip
- GitHub: https://github.com/aadityad12/AutoTrip
- Team: 3 GitHub contributor(s) — Akiko0210 (3 commits), aadityad12 (3 commits), Claude (1 commits)

## Devpost submission (written by the team)

### Overview

✈️ About the Project “Your AI Travel Agent” is a voice-powered mobile application that plans and books your perfect trip — all through simple spoken prompts. Whether you're organizing a quick weekend escape or an elaborate multi-city vacation, the app delivers a fully personalized itinerary that you can freely modify — and when you're ready, book your entire trip all at once with just one click. 💡

### Inspiration

The idea was born out of the hassle of traditional trip planning — searching endlessly for flights, hotels, and activities, or relying on expensive travel agencies. We wanted to transform that process into a simple voice conversation. Instead of filling out forms or clicking through pages, imagine just saying, “Plan a 3-day trip from San Francisco to Vegas with a $3000 budget,” and getting a complete itinerary in seconds — that’s the future we’re building. 🛠️ How We Built It Our system is made up of several intelligent components that work together: 🎙 Vapi to capture the user’s voice, transcribe it into text, and handle all audio interactions. 🧠 Gemini (Google’s LLM) to generate a detailed, day-by-day travel itinerary based on the voice prompt. 🤖 Agentic AI / Micro-APIs to fetch real-time data — including hotel prices, flight availability, and attractions — tailored to the user’s preferences. 🧩 Backend API to coordinate all services: receiving the voice input, managing AI prompts, querying external APIs, and returning a coherent response. 📱 Mobile App Frontend to deliver both a spoken and visual summary of the trip, complete with editable options and one-tap booking. 🧠 What We Learned How to chain multiple AI systems (Vapi → Gemini → custom agents) to produce dynamic, real-world travel experiences from just a single spoken prompt. The importance of designing flexible, schema-driven prompts for consistent LLM outputs. Building a backend that is modular, fast, and capable of orchestrating several services in real-time. Handling latency and rate-limiting issues when working with multiple external APIs — especially when fetching live data. 🚧 Challenges We Faced Getting bots to fetch live booking information reliably was challenging due to API access limits and anti-scraping protections. Integrating multiple distinct technologies (voice input, LLMs, booking APIs, and frontend UI) into one smooth pipeline took careful engineering. Ensuring the voice-to-response experience felt natural, fast, and cohesive, especially when calling several APIs behind the scenes. 🌟 Final Thoughts This isn’t just a travel planner — it’s your AI-powered, voice-based travel concierge. With just your voice, you can plan, tweak, and book your next trip in a matter of seconds. It’s highly customizable, intuitive, and designed to eliminate the friction from travel planning. The future of trips starts with a conversation — and ends with a single tap to book it all.

## README (from the GitHub repository)

No README available.

## Detected evidence (automated analysis)

Indexed codebase: 26 recognized source files, 111 KB.
- FastAPI (technology) — detected in the code
- JavaScript (language) — detected in the code
- Python (language) — detected in the code
- React (technology) — detected in the code
- TypeScript (language) — detected in the code
- Google Gemini (technology) — claimed on Devpost, not found in the code
- AI coding agent: Claude Code — evidence: commit authorship or trailers

## Codebase structure (from repository index)

### Files (33 of 33)

```
.DS_Store
AUDIO_FORMAT.md
backend/.gitignore
backend/start.sh
backend/test_voice_upload.py
backend/travel_planner_api/main.py
backend/travel_planner_api/requirements.txt
DEVICE_TROUBLESHOOTING.md
HERMES_FIX.md
mobile/.gitignore
mobile/app.json
mobile/App.tsx
mobile/babel.config.js
mobile/fix-navigation.sh
mobile/index.ts
mobile/metro.config.js
mobile/package.json
mobile/src/components/DebugInfo.tsx
mobile/src/components/ErrorBoundary.tsx
mobile/src/context/TripContext.tsx
mobile/src/screens/ConfirmationScreen.tsx
mobile/src/screens/HomeScreen.tsx
mobile/src/screens/PaymentScreen.tsx
mobile/src/screens/ResultsScreen.tsx
mobile/src/services/api.ts
mobile/start-clean.sh
mobile/start-dev.sh
mobile/start-fixed.sh
mobile/TestApp.tsx
mobile/tsconfig.json
README.md
SETUP_DEVICE.md
SYNTAX_ERRORS_FIXED.md
```

### Dependencies

- backend/travel_planner_api/requirements.txt: fastapi, python-multipart, uvicorn[standard]
- mobile/package.json: @babel/core@^7.25.2, @expo/vector-icons@^14.1.0, @react-navigation/native@^7.1.14, @react-navigation/stack@^7.4.0, @types/react@~19.0.10, expo@~53.0.12, expo-av@^15.1.6, expo-constants@^17.1.6, expo-status-bar@~2.2.3, react@19.0.0, react-native@0.79.4, react-native-gesture-handler@~2.24.0, react-native-reanimated@~3.17.4, react-native-safe-area-context@5.4.0, react-native-screens@^4.11.1, react-native-svg@15.11.2, react-native-vector-icons@^10.2.0, typescript@~5.8.3

### Recent commits (newest first)

- working version
- feat: Complete mobile app with backend integration and device support
- mobile
- feat: add initial backend API
- Update README.md
- Initial commit

## Key source files (fetched from GitHub, selected and truncated for size)

Source contents could not be fetched from GitHub right now.

[27 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]