How andreaspr/ai-travel-agent works
AI Travel Agent is a web-based, grounded trip-planning product. Users authenticate and submit conversational requests; the backend runs a bounded planning loop, invokes tools and retrieval, and returns itinerary responses for display. Its principal domain stages are planning, destination retrieval, inventory/tool queries, and itinerary persistence/versioning. The repository also includes model routing, authentication, safety, and observability layers. Some frontend and API wiring is unsampled, so those links are omitted or marked unverified rather than inferred.
Main entry points: loop.py Planning loop · main.py FastAPI app · models.py PostgreSQL models · runtime.py Tool runtime
Components 23
Web experience
- Chat interface
src/components/ChatApp.jsx - Trip displays
src/components/ItineraryCard.jsx - Auth forms
src/components/AuthForm.jsx
API and identity
- FastAPI app
backend/main.py - Auth endpoints
backend/auth/api.py - Auth service
backend/auth/service.py - Chat endpoints
backend/agent/api.py
Trip planning
- Planning loop
backend/agent/loop.py - Context builder
backend/agent/context.py - Planning policy
backend/agent/policy.py - Trip contracts
backend/agent/models.py - Itinerary versions
backend/agent/store.py
Knowledge and tools
- Tool runtime
backend/tools/runtime.py - Tool handlers
backend/tools/handlers.py - Tool contracts
backend/tools/models.py - Grounded search
backend/rag/search.py - Knowledge ingestion
backend/rag/ingest.py
Runtime services
- Model router
backend/llm/router.py - PostgreSQL models
backend/db/models.py - DB connection
backend/db/connect.py - Content safety
backend/security/content.py - Telemetry
backend/observability/telemetry.py
Other components
- Traveler
Connections 30
- Traveler → Chat interface: requests a trip
README.md - Traveler → Auth forms: authenticates
README.md - Chat interface → Chat endpoints: submits chat
- Chat endpoints → Planning loop: runs planning
- Planning loop → Context builder: builds context
backend/agent/loop.py - Planning loop → Planning policy: checks policy
backend/agent/loop.py - Planning loop → Trip contracts: uses contracts
backend/agent/loop.py - Planning loop → Model router: requests generation
backend/agent/loop.py - Planning loop → Tool runtime: dispatches tools
backend/agent/loop.py - Planning loop → Itinerary versions: persists versions
backend/agent/loop.py - Planning loop → Content safety: cleans content
backend/agent/loop.py - Tool runtime → Tool handlers: dispatches calls
backend/tools/runtime.py - Tool runtime → Tool contracts: validates results
backend/tools/runtime.py - Tool handlers → Tool contracts: uses contracts
backend/tools/handlers.py - Tool handlers → Grounded search: searches destinations
backend/tools/handlers.py - Grounded search → PostgreSQL models: queries chunks
backend/rag/search.py - Knowledge ingestion → PostgreSQL models: stores documents
backend/rag/ingest.py - Itinerary versions → PostgreSQL models: reads and writes
backend/agent/store.py - Tool runtime → PostgreSQL models: uses persistence
backend/tools/runtime.py - Auth endpoints → Auth service: calls service
backend/auth/api.py - Auth service → PostgreSQL models: reads and writes
backend/auth/service.py - FastAPI app → Chat endpoints: registers router
backend/main.py - FastAPI app → Auth endpoints: registers router
backend/main.py - FastAPI app → Grounded search: serves search
backend/main.py - FastAPI app → DB connection: uses sessions
backend/main.py - DB connection → PostgreSQL models: connects models
backend/db/connect.py - Model router → Telemetry: records model events
backend/llm/router.py - FastAPI app → Telemetry: instruments app
backend/main.py - Auth forms → Chat interface: provides login state
- Chat interface → Trip displays: renders itinerary