# ravidasawar2024-bot/tripgenie-ai architecture

> Architecture diagram of the GitHub repository ravidasawar2024-bot/tripgenie-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ravidasawar2024-bot/tripgenie-ai
- Repository: https://github.com/ravidasawar2024-bot/tripgenie-ai

## Overview

TripGenie AI is a Streamlit travel-planning application. A traveler enters destination and trip preferences, then submits them for Gemini to generate a personalized itinerary with budget guidance, experiences, packing advice, tips, and alternatives. The app extracts suggested attractions, searches Wikimedia Commons for destination images, and displays a paginated gallery alongside the plan. The repository is a single-file application; the graph separates its visible runtime responsibilities. Source excerpts are partial, so unshown internal details are not expanded.

Main entry points: [`app.py`](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py) (Plan Request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Trip Planning"]
  node_trip_form["Trip Details Form<br/>[app.py]"]
  node_plan_display["Plan and Profile<br/>[app.py]"]
end

subgraph group_generation["AI Generation"]
  node_plan_request["Plan Request<br/>[app.py]"]
  node_gemini{{"Google Gemini"}}
  node_attraction_parser["Attraction Extractor<br/>[app.py]"]
end

subgraph group_media["Destination Media"]
  node_image_search["Image Search<br/>[app.py]"]
  node_wikimedia{{"Wikimedia Commons"}}
  node_image_gallery["Paginated Gallery<br/>[app.py]"]
end

node_traveler(("Traveler"))

node_traveler -->|"enters preferences"| node_trip_form
node_trip_form -->|"submits details"| node_plan_request
node_plan_request -->|"requests generation"| node_gemini
node_gemini -->|"returns plan"| node_plan_request
node_plan_request -->|"displays results"| node_plan_display
node_plan_request -->|"extracts attractions"| node_attraction_parser
node_plan_request -->|"searches images"| node_image_search
node_image_search -.->|"queries images"| node_wikimedia
node_image_search -->|"provides images"| node_image_gallery
node_image_gallery -->|"loads more"| node_image_search

click node_trip_form "https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py"
click node_plan_request "https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py"
click node_plan_display "https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py"
click node_attraction_parser "https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py"
click node_image_search "https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py"
click node_image_gallery "https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_trip_form,node_plan_display toneBlue
class node_plan_request,node_gemini,node_attraction_parser toneAmber
class node_image_search,node_wikimedia,node_image_gallery toneMint
class node_traveler toneIndigo
```

## Components

### Trip Planning

- [Trip Details Form](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py): `app.py`
- [Plan and Profile](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py): `app.py`

### AI Generation

- [Plan Request](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py): `app.py`
- **Google Gemini**
- [Attraction Extractor](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py): `app.py`

### Destination Media

- [Image Search](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py): `app.py`
- **Wikimedia Commons**
- [Paginated Gallery](https://github.com/ravidasawar2024-bot/tripgenie-ai/blob/main/app.py): `app.py`

### Other components

- **Traveler**

## Connections

- Traveler → Trip Details Form: enters preferences (evidence: `app.py`)
- Trip Details Form → Plan Request: submits details (evidence: `app.py`)
- Plan Request → Google Gemini: requests generation (evidence: `app.py`)
- Google Gemini → Plan Request: returns plan (evidence: `app.py`)
- Plan Request → Plan and Profile: displays results (evidence: `app.py`)
- Plan Request → Attraction Extractor: extracts attractions (evidence: `app.py`)
- Plan Request → Image Search: searches images (evidence: `app.py`)
- Image Search → Wikimedia Commons: queries images
- Image Search → Paginated Gallery: provides images (evidence: `app.py`)
- Paginated Gallery → Image Search: loads more (evidence: `app.py`)
