How ryancjc/altas_hackathon works
This repository contains travel-planning components rather than one clearly integrated application: an LLM itinerary agent, a separate detailed itinerary planner, flight and place search tools, and several lodging/travel API clients. The clearest user-to-result flow is the agent: it receives a travel request, invokes flight and place tools, then parses the response into a typed itinerary. The detailed planner documents its own multi-stage itinerary workflow. The README is empty, and the excerpts do not establish how the standalone clients are wired together, so those integrations are left unconnected.
Main entry points: itineraryPlanner.py Detailed planner · agent.py Itinerary agent · tools.py Agent tools · nearbySearch.py Nearby places
Components 26
Agent and output
- Itinerary agent
agent.py - Itinerary schema
schemas.py
Itinerary planning
- Detailed planner
itineraryPlanner.py - Day classification
itineraryPlanner.py - Candidate discovery
itineraryPlanner.py - Place selection
itineraryPlanner.py - Daily schedule
itineraryPlanner.py - Route matrix
computeRouteMatrix.py
Flight and place discovery
- Agent tools
tools.py - Nearby places
nearbySearch.py - Text places
textSearch.py - Atlas flights
atlas_flight_api.py - Optimized routes
routeAPI_opt_multiple.py - Place type logic
placeTypeLogic.py - Place pricing
getPlacePrice.py
Lodging and travel data
- Duffel stays
duffel_hotel.py - StayAPI hotels
stayapi_hotel.py - Hotel search API
stayAPI.py - Hotel search API
stayAPI2.py
Other components
- Traveler
- Google Places
- Atlas flight service
- Google Routes
- Tripadvisor
- Duffel service
- StayAPI service
Connections 17
- Traveler → Itinerary agent: requests plan
agent.py - Itinerary agent → Agent tools: invokes tools
agent.py - Itinerary agent → Itinerary schema: structures output
agent.py - Detailed planner → Day classification: classifies days
itineraryPlanner.py - Detailed planner → Candidate discovery: discovers candidates
itineraryPlanner.py - Detailed planner → Place selection: selects places
itineraryPlanner.py - Detailed planner → Daily schedule: builds schedule
itineraryPlanner.py - Detailed planner → Route matrix: computes routes
itineraryPlanner.py - Agent tools → Google Places: searches places
tools.py - Agent tools → Atlas flight service: searches flights
tools.py - Nearby places → Google Places: nearby query
nearbySearch.py - Text places → Google Places: text query
textSearch.py - Atlas flights → Atlas flight service: requests flights
atlas_flight_api.py - Optimized routes → Google Routes: optimizes route
routeAPI_opt_multiple.py - Place pricing → Tripadvisor: fetches place data
getPlacePrice.py - Duffel stays → Duffel service: searches and books
duffel_hotel.py - StayAPI hotels → StayAPI service: requests hotel data
stayapi_hotel.py