How stealbird/voyara_travel_assistant works
Voyara is a travel-planning web app: travelers enter trip preferences, the page requests a route-and-stay plan and day itineraries, then presents the trip with weather, nearby-place information, images, and an interactive map. The Next.js page orchestrates this workflow through a small HTTP client; a FastAPI service supplies planning and enrichment endpoints. The backend excerpt is partial, so some endpoint internals and wiring are not shown; the map’s external tile sources are visible in its source.
Main entry points: main.py Voyara API · page.tsx Trip planner UI · trip-map.tsx Interactive map · api.ts API client
Components 11
Trip experience
- Trip planner UI
app/page.tsx - Interactive map
components/trip-map.tsx - UI button
components/ui/button.tsx
API client
- API client
lib/api.ts
Planning service
- Voyara API
backend/main.py
External data
- Groq LLM
- OpenWeatherMap
- Overpass API
- Wikipedia / Commons
- Map tile services
Other components
- Traveler
Connections 10
- Traveler → Trip planner UI: enters preferences
app/page.tsx - Trip planner UI → UI button: renders controls
app/page.tsx - Trip planner UI → API client: requests trip data
app/page.tsx - Trip planner UI → Interactive map: renders map
app/page.tsx - API client → Voyara API: HTTP requests
lib/api.ts - Voyara API → Groq LLM: generates plans
backend/main.py - Voyara API → OpenWeatherMap: fetches weather
backend/main.py - Voyara API → Overpass API: queries nearby places
backend/main.py - Voyara API → Wikipedia / Commons: looks up photos
backend/main.py - Interactive map → Map tile services: loads map tiles
components/trip-map.tsx