# puneethkumarms/ai-powered-travel-planner-for-students architecture

> Architecture diagram of the GitHub repository puneethkumarms/ai-powered-travel-planner-for-students, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/puneethkumarms/ai-powered-travel-planner-for-students
- Repository: https://github.com/puneethkumarms/ai-powered-travel-planner-for-students

## Overview

This is a Streamlit travel-planning app for students. A user enters trip details and requests an itinerary; the app sends those preferences to Gemini, geocodes the origin and destination, and displays a Folium map and the generated itinerary. Budget, dates, and interests shape the itinerary prompt, while the map is built from available coordinates. The runtime is concentrated in app.py, so its distinct responsibilities are shown as separate components sharing that path. Relationships are based on the app.py excerpt; the map and geocoding depend on external services and libraries.

Main entry points: [`app.py`](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py) (Streamlit app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Trip experience"]
  node_app["Streamlit app<br/>[app.py]"]
  node_trip_inputs["Trip inputs<br/>[app.py]"]
end

subgraph group_planning["Itinerary planning"]
  node_itinerary_generation["Itinerary generation<br/>[app.py]"]
  node_gemini["Gemini API"]
  node_itinerary_display["Itinerary display<br/>[app.py]"]
end

subgraph group_mapping["Location and map"]
  node_geocoding["Location geocoding<br/>[app.py]"]
  node_nominatim["Nominatim service"]
  node_map_display["Map display<br/>[app.py]"]
end

node_traveler(("Traveler"))

node_traveler -->|"enters trip details"| node_trip_inputs
node_traveler -->|"uses app"| node_app
node_app -->|"renders inputs"| node_trip_inputs
node_app -->|"calls generator"| node_itinerary_generation
node_itinerary_generation -->|"requests itinerary"| node_gemini
node_app -->|"geocodes locations"| node_geocoding
node_geocoding -->|"queries locations"| node_nominatim
node_app -->|"renders map"| node_map_display
node_app -->|"displays itinerary"| node_itinerary_display
node_itinerary_generation -->|"returns text"| node_itinerary_display
node_geocoding -->|"provides coordinates"| node_map_display

click node_app "https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py"
click node_trip_inputs "https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py"
click node_itinerary_generation "https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py"
click node_itinerary_display "https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py"
click node_geocoding "https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py"
click node_map_display "https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/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_app,node_trip_inputs toneBlue
class node_itinerary_generation,node_gemini,node_itinerary_display toneAmber
class node_geocoding,node_nominatim,node_map_display toneMint
class node_traveler toneIndigo
```

## Components

### Trip experience

- [Streamlit app](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py): `app.py`
- [Trip inputs](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py): `app.py`

### Itinerary planning

- [Itinerary generation](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py): `app.py`
- **Gemini API**
- [Itinerary display](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py): `app.py`

### Location and map

- [Location geocoding](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py): `app.py`
- **Nominatim service**
- [Map display](https://github.com/puneethkumarms/ai-powered-travel-planner-for-students/blob/main/app.py): `app.py`

### Other components

- **Traveler**

## Connections

- Traveler → Trip inputs: enters trip details (evidence: `app.py`)
- Traveler → Streamlit app: uses app (evidence: `README.md`)
- Streamlit app → Trip inputs: renders inputs (evidence: `app.py`)
- Streamlit app → Itinerary generation: calls generator (evidence: `app.py`)
- Itinerary generation → Gemini API: requests itinerary (evidence: `app.py`)
- Streamlit app → Location geocoding: geocodes locations (evidence: `app.py`)
- Location geocoding → Nominatim service: queries locations (evidence: `app.py`)
- Streamlit app → Map display: renders map (evidence: `app.py`)
- Streamlit app → Itinerary display: displays itinerary (evidence: `app.py`)
- Itinerary generation → Itinerary display: returns text (evidence: `app.py`)
- Location geocoding → Map display: provides coordinates (evidence: `app.py`)
