🧭 CuriousTrip - Traveler API v2.0

High-Performance Asynchronous Travel Data Aggregator

CuriousTrip is a modular CLI application designed to generate comprehensive travel profiles ("Travel Cheat Sheets") in real-time. By orchestrating 9 distinct RESTful APIs, it aggregates demographic, meteorological, financial, and cultural data into a single, cohesive report.

What's New in v2.0: This version introduces a complete architectural overhaul, moving from synchronous requests to a fully asynchronous model using asyncio and aiohttp. This allows for concurrent data fetching, drastically reducing wait times compared to sequential execution.

• ⚡ Asynchronous Core: Utilizes asyncio.gather to fetch data from multiple endpoints simultaneously.
• 🛡️ Fault Tolerance: Implements robust error handling; if one API fails or times out, the application gracefully skips that section without crashing.
• Modular Architecture: Clean separation between API logic (/api), data processing, and CLI interaction.
• Persistence: Automatically saves generated travel profiles to local .txt files for offline viewing.

See the application in action: login, destination selection, and profile generation.

The project follows a modular design pattern to ensure maintainability and scalability.

.
├── app/
│   ├── api/             # Async API integration modules (aiohttp)
│   ├── data/            # Local storage for generated travel profiles (.txt)
│   ├── tools/           # Utility scripts (file I/O, persistence)
│   ├── info_fetcher.py  # Central orchestrator (Async logic)
│   └── main.py          # Entry point & CLI Interface
├── .gitignore           # Version control exclusions
├── README.md            # Documentation
└── requirements.txt     # Dependencies

Clone the repository and install the required packages:

git clone https://github.com/GiZano/traveler-api.git
cd traveler-api
pip install -r requirements.txt

cd app
python main.py

If run from the root directory, the application may fail to locate the /data folder.

The "Swindle Sheet" is built by aggregating data from the following services:

The space_api module uses a generic DEMO_KEY. If you see an "Oops..." message in the Space section, the hourly demo limit has been reached. To fix this, generate a free API Key at api.nasa.gov and update the configuration file.

The info_fetcher.py orchestrator is designed to be resilient. Network operations are wrapped in try-except blocks. In the event of:

• API Timeouts
• Rate Limiting (HTTP 429)
• Service Downtime (HTTP 500)

The application will log the error internally and proceed to compile the rest of the report, ensuring the user always receives a partial result rather than a program crash.