# ragook6/vacaton_planner architecture

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

- Interactive diagram: https://gitdiagram.com/ragook6/vacaton_planner
- Repository: https://github.com/ragook6/vacaton_planner

## Overview

VacationPlanner is a Streamlit vacation-planning app backed by a sequential CrewAI workflow. A traveler submits a destination through the UI, which invokes the crew; a CLI entry point can also start it with a default destination. The crew configures research and itinerary agents, uses web search for research, and writes its reporting task to report.md. The UI displays and offers that file for download. Agent/task YAML contents were not sampled, so detailed task assignments and domain-specific processing are not shown.

Main entry points: [`src/vacation_planner/crew.py`](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py) (Crew orchestration), [`streamlitui.py`](https://github.com/ragook6/vacaton_planner/blob/main/streamlitui.py) (Vacation UI), [`src/vacation_planner/main.py`](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/main.py) (CLI runner), [`report.md`](https://github.com/ragook6/vacaton_planner/blob/main/report.md) (Markdown report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_streamlit["Vacation UI<br/>[streamlitui.py]"]
  node_cli["CLI runner<br/>[main.py]"]
end

subgraph group_workflow["Planning workflow"]
  node_crew["Crew orchestration<br/>[crew.py]"]
  node_agent_config["Agent definitions<br/>[agents.yaml]"]
  node_task_config["Task definitions<br/>[tasks.yaml]"]
  node_researcher["Vacation researcher<br/>[crew.py]"]
  node_itinerary["Itinerary planner<br/>[crew.py]"]
  node_research_task["Destination research<br/>[crew.py]"]
  node_report_task["Plan reporting<br/>[crew.py]"]
end

subgraph group_integrations["External services"]
  node_serper{{"Serper search"}}
  node_bedrock{{"Bedrock LLM"}}
end

subgraph group_results["Plan results"]
  node_report["Markdown report<br/>[report.md]"]
end

node_traveler(("Traveler"))
node_cli_user(("CLI user"))

node_traveler -->|"submits destination"| node_streamlit
node_streamlit -->|"starts planning"| node_crew
node_cli_user -->|"runs planner"| node_cli
node_cli -->|"starts planning"| node_crew
node_crew -->|"loads definitions"| node_agent_config
node_crew -->|"loads definitions"| node_task_config
node_crew -->|"registers agent"| node_researcher
node_crew -->|"registers agent"| node_itinerary
node_crew -->|"registers task"| node_research_task
node_crew -->|"registers task"| node_report_task
node_researcher -->|"searches web"| node_serper
node_researcher -->|"uses model"| node_bedrock
node_itinerary -->|"uses model"| node_bedrock
node_report_task -->|"writes report"| node_report
node_streamlit -->|"reads report"| node_report

click node_streamlit "https://github.com/ragook6/vacaton_planner/blob/main/streamlitui.py"
click node_cli "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/main.py"
click node_crew "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py"
click node_agent_config "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/config/agents.yaml"
click node_task_config "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/config/tasks.yaml"
click node_researcher "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py"
click node_itinerary "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py"
click node_research_task "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py"
click node_report_task "https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py"
click node_report "https://github.com/ragook6/vacaton_planner/blob/main/report.md"

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_streamlit,node_cli,node_cli_user toneBlue
class node_crew,node_agent_config,node_task_config,node_researcher,node_itinerary,node_research_task,node_report_task toneAmber
class node_serper,node_bedrock toneMint
class node_report toneRose
class node_traveler toneIndigo
```

## Components

### User entry points

- [Vacation UI](https://github.com/ragook6/vacaton_planner/blob/main/streamlitui.py): `streamlitui.py`
- [CLI runner](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/main.py): `src/vacation_planner/main.py`

### Planning workflow

- [Crew orchestration](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py): `src/vacation_planner/crew.py`
- [Agent definitions](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/config/agents.yaml): `src/vacation_planner/config/agents.yaml`
- [Task definitions](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/config/tasks.yaml): `src/vacation_planner/config/tasks.yaml`
- [Vacation researcher](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py): `src/vacation_planner/crew.py`
- [Itinerary planner](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py): `src/vacation_planner/crew.py`
- [Destination research](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py): `src/vacation_planner/crew.py`
- [Plan reporting](https://github.com/ragook6/vacaton_planner/blob/main/src/vacation_planner/crew.py): `src/vacation_planner/crew.py`

### External services

- **Serper search**
- **Bedrock LLM**

### Plan results

- [Markdown report](https://github.com/ragook6/vacaton_planner/blob/main/report.md): `report.md`

### Other components

- **Traveler**
- **CLI user**

## Connections

- Traveler → Vacation UI: submits destination (evidence: `streamlitui.py`)
- Vacation UI → Crew orchestration: starts planning (evidence: `streamlitui.py`)
- CLI user → CLI runner: runs planner (evidence: `src/vacation_planner/main.py`)
- CLI runner → Crew orchestration: starts planning (evidence: `src/vacation_planner/main.py`)
- Crew orchestration → Agent definitions: loads definitions (evidence: `src/vacation_planner/crew.py`)
- Crew orchestration → Task definitions: loads definitions (evidence: `src/vacation_planner/crew.py`)
- Crew orchestration → Vacation researcher: registers agent (evidence: `src/vacation_planner/crew.py`)
- Crew orchestration → Itinerary planner: registers agent (evidence: `src/vacation_planner/crew.py`)
- Crew orchestration → Destination research: registers task (evidence: `src/vacation_planner/crew.py`)
- Crew orchestration → Plan reporting: registers task (evidence: `src/vacation_planner/crew.py`)
- Vacation researcher → Serper search: searches web (evidence: `src/vacation_planner/crew.py`)
- Vacation researcher → Bedrock LLM: uses model (evidence: `src/vacation_planner/crew.py`)
- Itinerary planner → Bedrock LLM: uses model (evidence: `src/vacation_planner/crew.py`)
- Plan reporting → Markdown report: writes report (evidence: `src/vacation_planner/crew.py`)
- Vacation UI → Markdown report: reads report (evidence: `streamlitui.py`)
