# chyavanrao7/ai_tripplanner_agent architecture

> Architecture diagram of the GitHub repository chyavanrao7/ai_tripplanner_agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chyavanrao7/ai_tripplanner_agent
- Repository: https://github.com/chyavanrao7/ai_tripplanner_agent

## Overview

##### Main Backend Components
- FastAPI Server (main.py)
- Chat Session Manager (redis_chat_manager.py)
- Trip Planner Logic (trip_planner.py)
- Caching Utilities (caching_utils.py)
- Firecrawl Scraper Wrapper (tools_firecrawl.py)
- Requirements/runtime files (requirements.txt, runtime.txt)
- External Services:
– Google Gemini 2.0 AI API
– Redis (session store & cache)
– Firecrawl service (for web scraping)
– Upstream travel data APIs (Skyscanner, Booking.com)

##### Relationships and Data Flows
- Client → FastAPI endpoints
– Incoming HTTP requests from frontend or API clients
- FastAPI routes → Session Manager
– redis_chat_manager handles user context, conversation history in Redis
- FastAPI routes → Trip Planner
– trip_planner processes intents, preferences, builds itineraries
- Trip Planner ↔ Caching Utils
– caching_utils reads/writes API call results in Redis (to avoid repeated calls)
- Trip Planner → External Travel APIs
– Via tools_firecrawl, fetches real-time flight & hotel data
- Trip Planner → Google Gemini API
– Submits user prompts & context, receives AI-generated itinerary text
- Firecrawl Wrapper → Firecrawl Service
– Scraper sidecar or HTTP client to Firecrawl for web-scraping endpoints
- Redis
– Central store for session state, cache of API results, conversation memory

##### Architectural Patterns
- Modular service layer under FastAPI (separate files for chat management, planning, caching, scraping)
- Cache-aside pattern with Redis for external data
- Stateless HTTP API layer with Redis for state persistence
- Dependency injection of modules in FastAPI (via import in main.py)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors and API Layer
    Client["Client/App"]:::external
    Client -->|"HTTP Request"| FastAPI["FastAPI Server"]:::module

    %% Backend Application Modules
    subgraph "Backend Application"
        direction TB
        ChatManager["Chat Session Manager"]:::module
        TripPlanner["Trip Planner Logic"]:::module
        CachingUtils["Caching Utilities"]:::module
        FirecrawlWrapper["Firecrawl Scraper Wrapper"]:::module
    end

    %% Data Store
    Redis[(Redis)]:::datastore

    %% External Services
    GoogleGemini["Google Gemini 2.0 AI API"]:::external
    FirecrawlService["Firecrawl Service"]:::external
    Skyscanner["Skyscanner API"]:::external
    Booking["Booking.com API"]:::external

    %% Deployment Files
    subgraph "Project Files"
        Requirements["requirements.txt"]:::infra
        Runtime["runtime.txt"]:::infra
        Gitignore[".gitignore"]:::infra
    end

    %% Connections
    FastAPI -->|"invoke session"| ChatManager
    FastAPI -->|"invoke planning"| TripPlanner

    ChatManager -->|"GET/SET session"| Redis
    Redis -->|"session data"| ChatManager

    TripPlanner -->|"CACHE read/write"| CachingUtils
    CachingUtils -->|"GET/SET cache"| Redis
    Redis -->|"cache data"| CachingUtils

    TripPlanner -->|"AI prompt"| GoogleGemini
    TripPlanner -->|"scrape request"| FirecrawlService

    FirecrawlService -->|"HTTP scrape"| Skyscanner
    FirecrawlService -->|"HTTP scrape"| Booking

    ChatManager -->|"session data"| FastAPI
    TripPlanner -->|"itinerary"| FastAPI
    FastAPI -->|"HTTP Response"| Client

    %% Click Events
    click FastAPI "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/main.py"
    click ChatManager "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/redis_chat_manager.py"
    click TripPlanner "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/trip_planner.py"
    click CachingUtils "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/caching_utils.py"
    click FirecrawlWrapper "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/tools_firecrawl.py"
    click Requirements "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/requirements.txt"
    click Runtime "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/runtime.txt"
    click Gitignore "https://github.com/chyavanrao7/ai_tripplanner_agent/blob/main/Backend/.gitignore"

    %% Styles
    classDef module fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef external fill:#87CEEB,stroke:#333,stroke-width:1px;
    classDef datastore fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef infra fill:#D3D3D3,stroke:#333,stroke-width:1px;
```
