# nirbar1985/ai-travel-agent architecture

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

- Interactive diagram: https://gitdiagram.com/nirbar1985/ai-travel-agent
- Repository: https://github.com/nirbar1985/ai-travel-agent

## Overview

##### Main Components

a) User Interface Layer:
- Streamlit frontend application (from app.py)
- User input/output handling
- HTML email preview interface

b) Agent Core Layer:
- LangGraph-based agent system (in agents/agent.py)
- State management system
- LLM orchestration

c) Tools Layer:
- Flights finder module (agents/tools/flights_finder.py)
- Hotels finder module (agents/tools/hotels_finder.py)

d) External Services Layer:
- OpenAI API
- Google Flights API (via SERPAPI)
- Google Hotels API (via SERPAPI)
- SendGrid Email Service
- LangChain API (for observability)

**┌─────────────────────────────────────────────────┐**
- User Interface                   │
- (Streamlit Frontend)               │
- ┘
- ↕
**┌─────────────────────────────────────────────────┐**
- Agent Core System                  │
- ┌───────────────┐  ┌────────────────────────┐  │
- LangGraph   │←→│    State Management    │  │
- ┘  └────────────────────────┘  │
- ┌───────────────┐  ┌────────────────────────┐  │
- LLM Router   │←→│ Human-in-Loop Control  │  │
- ┘  └────────────────────────┘  │
- ┘
- ↕
**┌─────────────────────────────────────────────────┐**
- Tools Layer                     │
- ┌──────────────┐      ┌──────────────┐      │
- Flights Finder│      │Hotels Finder │      │
- ┘      └──────────────┘      │
- ┘
- ↕
**┌─────────────────────────────────────────────────┐**
- External Services                   │
- ┌────────┐ ┌───────┐ ┌────────┐ ┌─────────┐   │
- OpenAI │ │SERPAPI│ │SendGrid│ │LangChain│   │
- ┘ └───────┘ └────────┘ └─────────┘   │
- ┘

##### Important Elements to Highlight

- The stateful nature of the agent using LangGraph
- The human-in-the-loop decision points
- The multiple LLM usage pattern
- The email generation and preview workflow
- The integration points with external APIs

##### Key Interactions

- User input → Agent Core → Tools → External Services
- Agent Core ↔ State Management
- Human-in-Loop Control points
- Email preview and confirmation flow
- API integration points

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef core fill:#2ecc71,stroke:#27ae60,color:white
    classDef tools fill:#f1c40f,stroke:#f39c12,color:black
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white
    
    %% User Interface Layer
    subgraph UI[User Interface Layer]
        Frontend["Streamlit Frontend"]
        EmailPreview["HTML Email Preview"]
    end
    
    %% Agent Core Layer
    subgraph Core[Agent Core System]
        LangGraph["LangGraph Agent"]
        StateManagement["State Management"]
        LLMRouter["LLM Router"]
        HumanControl["Human-in-Loop Control"]
    end
    
    %% Tools Layer
    subgraph Tools[Tools Layer]
        FlightsFinder["Flights Finder"]
        HotelsFinder["Hotels Finder"]
    end
    
    %% External Services Layer
    subgraph External[External Services]
        OpenAI["OpenAI API"]
        SERPAPI["SERPAPI"]
        SendGrid["SendGrid"]
        LangChain["LangChain API"]
    end
    
    %% Connections
    Frontend <--> LangGraph
    Frontend <--> EmailPreview
    LangGraph <--> StateManagement
    LangGraph <--> LLMRouter
    LangGraph <--> HumanControl
    LLMRouter --> FlightsFinder
    LLMRouter --> HotelsFinder
    FlightsFinder --> SERPAPI
    HotelsFinder --> SERPAPI
    LLMRouter --> OpenAI
    EmailPreview --> SendGrid
    LangGraph --> LangChain
    
    %% Click Events
    click Frontend "https://github.com/nirbar1985/ai-travel-agent/blob/main/app.py"
    click LangGraph "https://github.com/nirbar1985/ai-travel-agent/blob/main/agents/agent.py"
    click Tools "https://github.com/nirbar1985/ai-travel-agent/tree/main/agents/tools/"
    click FlightsFinder "https://github.com/nirbar1985/ai-travel-agent/blob/main/agents/tools/flights_finder.py"
    click HotelsFinder "https://github.com/nirbar1985/ai-travel-agent/blob/main/agents/tools/hotels_finder.py"
    
    %% Style Applications
    class Frontend,EmailPreview ui
    class LangGraph,StateManagement,LLMRouter,HumanControl core
    class FlightsFinder,HotelsFinder tools
    class OpenAI,SERPAPI,SendGrid,LangChain external
```
