Trip Planner
A hierarchical multi-agent system where a manager agent coordinates four specialized sub-agents to produce a complete, budget-aware travel itinerary — with charts and a downloadable PDF — from a single prompt.
5
Agents — 1 Manager + 4 Sub-Agents
3
Output Formats
1
Prompt to Full Itinerary
The Problem
Planning a trip that respects a budget is hard, slow, and fragmented
A good trip plan requires several separate skills working in concert — researching what a destination actually offers, identifying the right activities for the traveler's preferences, allocating a finite budget across transport, accommodation, activities, and food without overspending, and finally writing a coherent day-by-day itinerary that ties it all together. Doing this manually takes hours of cross-referencing across search engines, booking platforms, and spreadsheets — and even then the result is rarely budget-optimal or well-structured.
The Solution
A manager agent that delegates, coordinates, and delivers
Trip Planner Agent is a five-agent hierarchical CrewAI system where a manager agent orchestrates four specialized sub-agents — a destination researcher, activity planner, budget optimizer, and itinerary writer — each owning one stage of the planning process. The user specifies destination, budget, duration, and preferences through a Gradio UI. The manager coordinates the sub-agents into a coherent plan and the system delivers three outputs: a structured day-by-day itinerary, interactive budget breakdown charts, and a downloadable PDF report — all from a single prompt.
Key Outcome
From a single prompt, the system produces a complete, budget-compliant travel itinerary — with interactive charts and a professionally formatted downloadable PDF — by delegating the full planning workflow to a coordinated team of specialized agents.
Technical Deep Dive
Architecture & Design
Agent Hierarchy
Manager Agent · Hierarchical Coordinator
Manager Agent
Coordinates sub-agents · Allocates tasks · Synthesises outputs into final plan
Sub-Agent 1
Destination Researcher
Real-time web search · Destination profile, highlights, travel tips
Sub-Agent 2
Activity Planner
Matches activities to preferences · Builds day-by-day schedule
Sub-Agent 3
Budget Optimizer
Allocates budget across transport, accommodation, activities, food
Sub-Agent 4
Itinerary Writer
Synthesises all outputs into a structured, readable trip plan
Outputs
Manager Agent
Hierarchical Coordinator
Orchestrates the full planning workflow by delegating tasks to sub-agents, monitoring their outputs, and synthesising the results into a coherent plan. The manager never executes research or writing directly — it coordinates and guides the specialist agents toward the final deliverable.
Sub-Agent 1
Destination Researcher
Uses real-time web search tools to build a structured destination profile — covering must-see highlights, local culture, transport options, best time to visit, and practical travel tips. Provides the factual foundation that all downstream agents build on.
Sub-Agent 2
Activity Planner
Matches destination offerings to the user's stated preferences and trip duration. Builds a day-by-day activity schedule that balances variety, pacing, and traveler interests — producing the structured activity backbone that the itinerary writer shapes into a final plan.
Sub-Agent 3
Budget Optimizer
Allocates the user's total budget across four categories — transport, accommodation, activities, and food — ensuring the plan stays within constraints. Produces a cost breakdown that feeds directly into the chart visualizations and PDF report.
Sub-Agent 4
Itinerary Writer
Synthesises all upstream outputs — destination research, activity schedule, and budget allocation — into a structured, readable day-by-day itinerary. Produces the final narrative that is rendered in the Gradio UI and exported to the downloadable PDF report.
Key Design Decisions
Hierarchical architecture separates coordination from execution
The manager agent never performs research, planning, or writing directly. Its sole responsibility is orchestration — deciding which sub-agent to engage, in what order, and how to synthesise their outputs. This clean separation keeps each agent focused on a single well-defined task and makes the system easier to extend with new specialist agents.
Budget constraint enforced at the agent level
Rather than applying budget limits as a post-processing filter, the Budget Optimizer agent actively allocates costs across all categories during the planning process. This means the activity schedule and itinerary are built around realistic cost constraints from the start — not retrofitted to a budget after the fact.
Three output formats serve different user needs
The system produces three distinct outputs from the same planning run — a structured itinerary for reading, interactive charts for budget visualization, and a downloadable PDF for sharing and offline use. Each format serves a different consumption pattern without requiring the user to run the pipeline multiple times.
Tech Stack
| Technology | Purpose |
|---|---|
| CrewAI | Hierarchical multi-agent orchestration with manager and sub-agents |
| OpenAI API | LLM backbone for agent reasoning, research, and content generation |
| Gradio | Web UI for trip parameter input and multi-format output display |
| matplotlib / plotly | Budget breakdown and itinerary timeline chart generation |
| ReportLab / FPDF | PDF report generation for downloadable trip plan |
| Web Search Tools | Real-time destination, activity, and pricing research by agents |
| Python | Core language and pipeline orchestration |
Results & Metrics
What the system delivers
5
Specialized Agents
1 manager coordinating 4 sub-agents — each owning one stage of the planning process
3
Output Formats
Structured itinerary, interactive budget charts, and downloadable PDF — all from one run
1
Prompt to Full Plan
Destination, budget, duration, and preferences — one input drives the entire pipeline
Budget-compliant itineraries
The Budget Optimizer agent allocates costs across all categories during planning — not as a post-processing filter. Every itinerary produced stays within the user's defined budget constraints from the first agent call to the final PDF.
Interactive budget visualization
Budget allocation across transport, accommodation, activities, and food is rendered as interactive charts in the Gradio UI — giving users an immediate visual breakdown of where their budget is going before downloading the full report.
Downloadable PDF report
The full trip plan — itinerary, budget details, and activity summaries — is exported as a professionally formatted PDF via ReportLab. The report is shareable and readable offline without requiring access to the Gradio interface.
Real-time destination research
The Destination Researcher agent uses live web search tools to pull current information on destinations, activities, and pricing — ensuring the plan reflects real-world conditions rather than relying on static training data.
Agent Roster
| Agent | Responsibility |
|---|---|
| Manager Agent | Orchestrates sub-agents, allocates tasks, synthesises final plan |
| Destination Researcher | Real-time web search for destination profile, highlights, and travel tips |
| Activity Planner | Matches activities to preferences and builds day-by-day schedule |
| Budget Optimizer | Allocates budget across transport, accommodation, activities, food |
| Itinerary Writer | Synthesises all outputs into a structured, readable day-by-day trip plan |