How 25pradnyesh/travel-ai- works
Travel AI turns public Instagram Reel URLs into verified destination recommendations and travel dossiers, primarily through its mobile app and Python intelligence engine. The documented flow combines speech, OCR, and caption evidence; resolves and verifies places; adds travel guidance and nearby points of interest; then presents results on maps and supports offline saves. The README also describes Explore and place-detail surfaces. Source excerpts and index references establish key engine ownership; mobile links largely follow explicit README flow because several screens were not sampled.
Main entry points: location_pipeline.py Location pipeline · location_resolver.py Place resolution · results.tsx Results dossier · evidence_builder.py Evidence builder
Components 22
Mobile app
- Reel submission
mobile/app/(tabs)/index.tsx - Results dossier
mobile/app/analyze/results.tsx - Interactive map
mobile/app/analyze/map.tsx - Offline saved places
mobile/lib/storage/saved-places.ts - Explore feed
mobile/app/(tabs)/explore.tsx - Place detail
mobile/app/place/[id].tsx
Intelligence engine
- Analyze API
engine/app/api/analyze.py - Location pipeline
engine/app/pipelines/location_pipeline.py - Instagram provider
engine/providers/manager.py
Evidence extraction
- Evidence builder
engine/app/services/extraction/evidence_builder.py - Frame extraction
engine/app/services/extraction/frame_extractor.py - OCR service
engine/app/services/ocr/ocr_service.py
Place intelligence
- Candidate generation
engine/app/services/location/candidate_service.py - Place resolution
engine/app/services/location/location_resolver.py - Candidate scoring
engine/app/services/scoring/scoring_service.py - Nearby search
engine/app/services/maps/nearby_search_service.py - Gemini verification
engine/app/services/gemini/gemini_verifier.py
Travel presentation
- Travel intelligence
engine/app/services/travel/travel_intelligence_service.py - Response builder
engine/app/services/response/response_builder.py
Other components
- Traveler
- Google Places
- Gemini service
Connections 23
- Traveler → Reel submission: submits Reel
README.md - Reel submission → Analyze API: POSTs URL
README.md - Analyze API → Location pipeline: invokes analysis
engine/app/api/analyze.py - Location pipeline → Instagram provider: requests media
README.md - Instagram provider → Evidence builder: supplies media
- Location pipeline → Evidence builder: builds evidence
engine/app/pipelines/location_pipeline.py - Evidence builder → Frame extraction: extracts frames
engine/app/services/extraction/evidence_builder.py - Frame extraction → OCR service: reads frame text
engine/app/services/extraction/frame_extractor.py - Location pipeline → Place resolution: resolves evidence
engine/app/pipelines/location_pipeline.py - Place resolution → Candidate generation: generates candidates
engine/app/services/location/location_resolver.py - Candidate generation → Candidate scoring: scores candidates
engine/app/services/location/candidate_service.py - Place resolution → Nearby search: finds nearby places
engine/app/services/location/location_resolver.py - Nearby search → Google Places: searches places
engine/app/services/maps/nearby_search_service.py - Location pipeline → Gemini verification: verifies destination
engine/app/pipelines/location_pipeline.py - Gemini verification → Gemini service: requests vision analysis
- Place resolution → Travel intelligence: enriches destination
engine/app/services/location/location_resolver.py - Travel intelligence → Response builder: provides enrichment
engine/app/services/response/response_builder.py - Location pipeline → Response builder: builds result
engine/app/pipelines/location_pipeline.py - Response builder → Results dossier: returns dossier
README.md - Results dossier → Interactive map: opens map
README.md - Interactive map → Place detail: opens place detail
README.md - Results dossier → Offline saved places: saves places
README.md - Explore feed → Place detail: opens place detail