# ntt-dkiku/ai-tour-meeting architecture

> Architecture diagram of the GitHub repository ntt-dkiku/ai-tour-meeting, 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/ntt-dkiku/ai-tour-meeting
- Repository: https://github.com/ntt-dkiku/ai-tour-meeting

## Overview

AI Tour Meeting is a multi-agent group travel-planning system, usable through a browser GUI or Python API. Users configure a meeting, participants, goals, and constraints; agents discuss and develop route proposals, which the meeting workflow records and presents. The backend also provides analytics and local-model integrations. The graph follows documented capabilities and SOURCE INDEX references; where the excerpts do not show runtime wiring, uncertain links are omitted.

Main entry points: [`tour_meeting/tour_meeting.py`](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/tour_meeting.py) (Meeting workflow), [`tour_meeting/frontend/src/App.tsx`](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/App.tsx) (Meeting GUI), [`tour_meeting/participant.py`](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/participant.py) (Agent participant), [`tour_meeting/search_engine.py`](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/search_engine.py) (Web search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Meeting experience"]
  node_gui["Meeting GUI<br/>[App.tsx]"]
  node_settings["Meeting settings<br/>[SettingsView.tsx]"]
  node_meetingview["Meeting view<br/>[MeetingView.tsx]"]
  node_chat["Discussion and routes<br/>[ChatMessages.tsx]"]
  node_context["Meeting state<br/>[MeetingContext.tsx]"]
end

subgraph group_service["Meeting service"]
  node_api["Backend API<br/>[api.py]"]
  node_pythonapi["Python meeting API<br/>[cli.py]"]
  node_engine["Meeting workflow<br/>[tour_meeting.py]"]
end

subgraph group_agents["Agent planning"]
  node_participant["Agent participant<br/>[participant.py]"]
  node_turns["Turn selection<br/>[turn_selector.py]"]
  node_search["Web search<br/>[search_engine.py]"]
  node_messages["Agent messages<br/>[messages.py]"]
end

subgraph group_support["Model and analysis"]
  node_llm["LLM access<br/>[llm.py]"]
  node_integrations["Model integrations<br/>[integration.py]"]
  node_analytics["Meeting analytics<br/>[analytics.py]"]
  node_deadlock["Deadlock handling<br/>[deadlock.py]"]
end

node_user(("Planner"))
node_llmservice{{"LLM providers"}}
node_websearch{{"Web search service"}}

node_user -->|"configures"| node_gui
node_gui -->|"opens"| node_settings
node_gui -->|"opens"| node_meetingview
node_meetingview -->|"renders"| node_chat
node_settings -->|"uses state"| node_context
node_gui -->|"uses backend"| node_api
node_user -->|"configures"| node_pythonapi
node_pythonapi -.->|"builds meeting"| node_engine
node_api -->|"manages meeting"| node_engine
node_engine -->|"coordinates agents"| node_participant
node_engine -->|"selects turns"| node_turns
node_engine -->|"records analytics"| node_analytics
node_engine -->|"handles deadlocks"| node_deadlock
node_participant -->|"requests completions"| node_llm
node_participant -->|"requests search"| node_search
node_participant -->|"uses messages"| node_messages
node_search -->|"uses configuration"| node_llm
node_llm -.->|"calls models"| node_llmservice
node_search -.->|"searches web"| node_websearch
node_engine -->|"uses integrations"| node_integrations

click node_gui "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/App.tsx"
click node_settings "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/components/views/SettingsView.tsx"
click node_meetingview "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/components/views/MeetingView.tsx"
click node_chat "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/components/meeting/ChatMessages.tsx"
click node_context "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/context/MeetingContext.tsx"
click node_api "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/backend/api.py"
click node_pythonapi "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/cli.py"
click node_engine "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/tour_meeting.py"
click node_participant "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/participant.py"
click node_turns "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/turn_selector.py"
click node_search "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/search_engine.py"
click node_messages "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/messages.py"
click node_llm "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/llm.py"
click node_integrations "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/integration.py"
click node_analytics "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/analytics.py"
click node_deadlock "https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/deadlock.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_gui,node_settings,node_meetingview,node_chat,node_context toneBlue
class node_api,node_pythonapi,node_engine toneAmber
class node_participant,node_turns,node_search,node_messages toneMint
class node_llm,node_integrations,node_analytics,node_deadlock toneRose
class node_user,node_llmservice,node_websearch toneIndigo
```

## Components

### Meeting experience

- [Meeting GUI](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/App.tsx): `tour_meeting/frontend/src/App.tsx`
- [Meeting settings](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/components/views/SettingsView.tsx): `tour_meeting/frontend/src/components/views/SettingsView.tsx`
- [Meeting view](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/components/views/MeetingView.tsx): `tour_meeting/frontend/src/components/views/MeetingView.tsx`
- [Discussion and routes](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/components/meeting/ChatMessages.tsx): `tour_meeting/frontend/src/components/meeting/ChatMessages.tsx`
- [Meeting state](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/frontend/src/context/MeetingContext.tsx): `tour_meeting/frontend/src/context/MeetingContext.tsx`

### Meeting service

- [Backend API](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/backend/api.py): `tour_meeting/backend/api.py`
- [Python meeting API](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/cli.py): `tour_meeting/cli.py`
- [Meeting workflow](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/tour_meeting.py): `tour_meeting/tour_meeting.py`

### Agent planning

- [Agent participant](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/participant.py): `tour_meeting/participant.py`
- [Turn selection](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/turn_selector.py): `tour_meeting/turn_selector.py`
- [Web search](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/search_engine.py): `tour_meeting/search_engine.py`
- [Agent messages](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/messages.py): `tour_meeting/messages.py`

### Model and analysis

- [LLM access](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/llm.py): `tour_meeting/llm.py`
- [Model integrations](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/integration.py): `tour_meeting/integration.py`
- [Meeting analytics](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/analytics.py): `tour_meeting/analytics.py`
- [Deadlock handling](https://github.com/ntt-dkiku/ai-tour-meeting/blob/main/tour_meeting/deadlock.py): `tour_meeting/deadlock.py`

### Other components

- **Planner**
- **LLM providers**
- **Web search service**

## Connections

- Planner → Meeting GUI: configures (evidence: `README.md`)
- Meeting GUI → Meeting settings: opens (evidence: `tour_meeting/frontend/src/App.tsx`)
- Meeting GUI → Meeting view: opens (evidence: `tour_meeting/frontend/src/App.tsx`)
- Meeting view → Discussion and routes: renders (evidence: `tour_meeting/frontend/src/components/views/MeetingView.tsx`)
- Meeting settings → Meeting state: uses state (evidence: `tour_meeting/frontend/src/components/views/SettingsView.tsx`)
- Meeting GUI → Backend API: uses backend (evidence: `README.md`)
- Planner → Python meeting API: configures (evidence: `README.md`)
- Python meeting API → Meeting workflow: builds meeting
- Backend API → Meeting workflow: manages meeting (evidence: `tour_meeting/backend/api.py`)
- Meeting workflow → Agent participant: coordinates agents (evidence: `tour_meeting/tour_meeting.py`)
- Meeting workflow → Turn selection: selects turns (evidence: `tour_meeting/tour_meeting.py`)
- Meeting workflow → Meeting analytics: records analytics (evidence: `tour_meeting/tour_meeting.py`)
- Meeting workflow → Deadlock handling: handles deadlocks (evidence: `tour_meeting/tour_meeting.py`)
- Agent participant → LLM access: requests completions (evidence: `tour_meeting/participant.py`)
- Agent participant → Web search: requests search (evidence: `tour_meeting/participant.py`)
- Agent participant → Agent messages: uses messages (evidence: `tour_meeting/participant.py`)
- Web search → LLM access: uses configuration (evidence: `tour_meeting/search_engine.py`)
- LLM access → LLM providers: calls models
- Web search → Web search service: searches web
- Meeting workflow → Model integrations: uses integrations (evidence: `tour_meeting/tour_meeting.py`)
