How saad-azi/crewai-trip-planner works
Project type and purpose
• This is a Python-based, command-line Trip Planning Assistant. It’s an open-source utility (packaged with Poetry) that orchestrates multiple “agents” to explore countries, explore cities, track expenses, and build a trip itinerary.
File structure
• Top-level files:
• pyproject.toml – Poetry configuration & dependencies
• README.md – project overview & usage
• tests/ – unit tests
• Package directory: trip_planner/
• main.py – entry point & CLI parsing
• agents.py – definitions of CountryExplorerAgent, CityExplorerAgent, ExpensesTrackerAgent, TripPlannerAgent
• tasks.py – orchestration logic / workflow controller
• tools.py – utility functions & API‐wrappers (e.g., HTTP clients, data processors)
Inspect the README for architecture hints
• The README enumerates four agent types and shows the expected input/output flow: a user issues a command → agents fetch or compute data → consolidated plan is returned.
• No database is listed; state is held in memory or serialized at runtime. External integrations (flight cost APIs, map services) live in tools.py.
Detail and coverage
• Every module (main.py, tasks.py, agents.py, tools.py).
• Tests folder as a separate validation layer.
• That new agents or tools can be dropped into the package folder and wired into the Orchestrator with minimal changes.