Kuma AI Travel Agent
Last updated
Was this helpful?
Last updated
Was this helpful?
An AI-powered travel agent that generates personalized travel itineraries using Google's Gemini model.
Generates two distinct travel options based on your preferences
Customizable model parameters (temperature, top_p, etc.)
Rich terminal output with Markdown formatting
Easy-to-use command-line interface
Python 3.8+
Google Gemini API key
Clone this repository:
git clone https://github.com/yourusername/kuma-ai-travel-agent.git
cd kuma-ai-travel-agent
Install the required packages:
pip install -r requirements.txt
Set up your Gemini API key:
Get an API key from
Copy .env.example
to .env
Add your API key to the .env
file
Run the travel agent:
python travel_agent.py
Follow the prompts to:
Enter your departure location
Enter your destination
Specify the number of days for your trip
(Optional) Adjust the creativity level (0.0-1.0)
The agent will generate two distinct travel itineraries in Markdown format.
You can customize the model's behavior by modifying the default_config
in the TravelAgent
class in travel_agent.py
. Available parameters include:
model
: The Gemini model to use (default: "gemini-pro")
temperature
: Controls randomness (0.0-1.0, default: 0.8)
top_p
: Nucleus sampling parameter (default: 0.9)
top_k
: Top-k sampling parameter (default: 40)
max_output_tokens
: Maximum length of the response (default: 2000)
## Option 1: Cultural Immersion in Paris
A deep dive into Parisian art, history, and cuisine...
### Day 1: Arrival & Montmartre
- **Morning**: Arrive in Paris, check into your hotel in Montmartre...
- **Afternoon**: Explore Sacré-Cœur and Place du Tertre...
- **Evening**: Dinner at a traditional Parisian bistro...
## Option 2: Romantic Getaway in Paris
A more relaxed, romantic experience of the City of Light...
...
python travel_agent.py --from "SFO" --to "Japan" --days 5
🌍 Welcome to Kuma AI Travel Agent!
Generating your 5-day trip from SFO to Japan...
Creativity level: 0.4
Option 1: "Samurai Spirit & Neon Nights: A Tokyo & Hakone Adventure"
This itinerary focuses on experiencing both the vibrant, modern energy of Tokyo and the serene
beauty of Hakone's natural landscapes. It blends cultural immersion with exciting sightseeing,
offering a well-rounded introduction to Japan. This trip is designed for travelers who want to be
active and explore a variety of experiences.
Day 1: Arrival in Tokyo - Shinjuku Exploration
• Morning: Arrive at Narita (NRT) or Haneda (HND) airport. Take the Narita Express or Limousine
Bus to your hotel in Shinjuku.
• Afternoon: Check in and explore Shinjuku Gyoen National Garden, a tranquil oasis amidst the
skyscrapers.
• Evening: Ascend the Tokyo Metropolitan Government Building for panoramic city views (free!).
Enjoy dinner at Omoide Yokocho (Memory Lane) for a nostalgic yakitori experience.
• Recommended Dining:
• Budget: Omoide Yokocho (Yakitori)
• Mid-Range: Han no Daidokoro Bettei (Yakiniku)
• Luxury: New York Grill (Park Hyatt Tokyo - Lost in Translation fame)
Day 2: Tokyo - Culture & Pop Culture
• Morning: Visit the Tsukiji Outer Market for a delicious seafood breakfast and explore the
bustling stalls.
• Afternoon: Immerse yourself in the colorful and trendy Harajuku district, visiting Meiji Jingu
Shrine and Takeshita Street.
• Evening: Experience the electric atmosphere of Shibuya, witness the famous scramble crossing,
and enjoy dinner at a themed restaurant (Robot Restaurant in Shinjuku is a wild option).
• Recommended Dining:
• Budget: Ichiran Ramen (Shibuya)
• Mid-Range: Kawaii Monster Cafe (Harajuku - for the experience)
• Luxury: Ukai Tei (Ginza - Teppanyaki)
Day 3: Hakone - Mountain Scenery & Art
• Morning: Take a scenic bullet train (Shinkansen) to Odawara, the gateway to Hakone. Purchase a
Hakone Free Pass.
• Afternoon: Cruise across Lake Ashi, surrounded by stunning views of Mount Fuji (weather
permitting). Ride the Hakone Ropeway, offering volcanic hot spring views.
• Evening: Check into your Ryokan (traditional Japanese Inn) in Hakone. Enjoy a Kaiseki dinner
(multi-course Japanese meal) and relax in the onsen (hot spring bath).
• Recommended Dining: (Typically included with Ryokan stay)
• Budget: Local Soba shop near Odawara Station
• Mid-Range: Kaiseki dinner at your Ryokan
• Luxury: Tenzan Tohji-kyo (Onsen with gourmet dining options)
Day 4: Hakone - Art & Return to Tokyo
• Morning: Visit the Hakone Open-Air Museum, showcasing contemporary sculptures against the
backdrop of nature.
• Afternoon: Explore the Pola Museum of Art or the Hakone Venetian Glass Museum.
• Evening: Return to Tokyo by bullet train. Enjoy dinner in the Ginza district, known for its
upscale restaurants and shopping.
• Recommended Dining:
• Budget: Ginza Bairin (Tonkatsu)
• Mid-Range: Kyubey (Sushi - requires reservation)
• Luxury: Sukiyabashi Jiro (Sushi - extremely difficult to book)
Day 5: Departure
• Morning: Depending on your flight time, enjoy a final Japanese breakfast or do some last-minute
souvenir shopping in Tokyo.
• Afternoon: Take the Narita Express or Limousine Bus to Narita (NRT) or Haneda (HND) airport for
your flight back to SFO.
Estimated Costs:
• Budget: $1500 - $2500 (Hostels, budget hotels, local transportation, affordable meals)
• Mid-Range: $2500 - $4000 (Business hotels, Ryokan stay, Shinkansen travel, mid-range
restaurants)
• Luxury: $4000+ (Luxury hotels, private transportation, high-end dining, premium experiences)
Packing Suggestions:
• Comfortable walking shoes
• Layers of clothing (weather can vary)
• Japan Rail Pass (if planning extensive travel beyond this itinerary)
• Pocket Wi-Fi router or SIM card
• Universal adapter
• Phrasebook or translation app
• Small gifts for Ryokan staff (optional)
Special Considerations:
• Visa: US citizens can enter Japan for tourism purposes for up to 90 days without a visa.
• Vaccinations: Consult your doctor for recommended vaccinations.
• Japan Rail Pass: Consider purchasing a Japan Rail Pass if you plan to travel extensively by
train.
• Suica/Pasmo Card: Purchase a rechargeable travel card for easy access to public transportation.
• Cash: While credit cards are becoming more widely accepted, it's still a good idea to carry
cash, especially for smaller establishments.
Option 2: "Kyoto's Ancient Soul: A Cultural Immersion Journey"
This itinerary prioritizes cultural immersion in Kyoto, the ancient capital of Japan. It focuses
on exploring temples, gardens, and traditional arts, offering a deeper understanding of Japanese
history and culture. This trip is perfect for travelers seeking a more relaxed and contemplative
experience.
Day 1: Arrival in Kyoto - Gion Exploration
• Morning: Arrive at Kansai International Airport (KIX). Take the Haruka Express train to Kyoto
Station.
• Afternoon: Check into your hotel or Ryokan in Kyoto. Explore Gion, Kyoto's geisha district, and
try to spot a geiko or maiko.
• Evening: Enjoy a traditional Kaiseki dinner in Gion or Pontocho, a narrow alley along the
Kamogawa River.
• Recommended Dining:
• Budget: Nishiki Market street food
• Mid-Range: Gion Karyo (Kaiseki)
• Luxury: Kikunoi (Kaiseki - Michelin-starred)
Day 2: Kyoto - Temples & Gardens
• Morning: Visit Fushimi Inari Shrine, famous for its thousands of vibrant red torii gates
winding up a mountainside.
• Afternoon: Explore Kiyomizu-dera Temple, offering stunning views of Kyoto. Wander through the
charming streets of Higashiyama district.
• Evening: Attend a traditional tea ceremony (chado) to learn about the art and etiquette of tea
preparation. Enjoy dinner near Kyoto Station.
• Recommended Dining:
• Budget: Ramen near Kyoto Station
• Mid-Range: Okonomiyaki at Teppanyaki Manryu
• Luxury: Nakamura (Kaiseki)
Day 3: Kyoto - Zen Gardens & Bamboo Forest
• Morning: Visit Ryoan-ji Temple, famous for its enigmatic Zen rock garden.
• Afternoon: Explore Arashiyama Bamboo Grove, a magical and serene pathway through towering
bamboo stalks. Visit Tenryu-ji Temple, a beautiful Zen temple with stunning gardens.
• Evening: Enjoy a vegetarian Shojin Ryori dinner at Shigetsu, a restaurant within Tenryu-ji
Temple.
• Recommended Dining:
• Budget: Arashiyama street food (dango, croquettes)
• Mid-Range: Shigetsu (Shojin Ryori - vegetarian)
• Luxury: Hirokawa (Unagi - requires reservation)
Day 4: Nara - Deer & Temples
• Morning: Take a short train ride to Nara, famous for its friendly wild deer roaming freely in
Nara Park.
• Afternoon: Visit Todai-ji Temple, housing a giant bronze Buddha statue. Explore Kasuga Taisha
Shrine, known for its thousands of lanterns.
• Evening: Return to Kyoto. Enjoy dinner at Nishiki Market, Kyoto's bustling kitchen.
• Recommended Dining:
• Budget: Mochi at Nakatanidou (Nara)
• Mid-Range: Izasa (Sushi wrapped in persimmon leaves - Nara)
• Luxury: Hyotei (Kaiseki - requires reservation)
Day 5: Departure
• Morning: Visit Kinkaku-ji (Golden Pavilion), a stunning Zen temple covered in gold leaf.
• Afternoon: Depending on your flight time, explore Nishiki Market for last-minute souvenirs or
enjoy a final matcha latte.
• Evening: Take the Haruka Express train from Kyoto Station to Kansai International Airport (KIX)
for your flight back to SFO.
Estimated Costs:
• Budget: $1800 - $2800 (Hostels, budget hotels, local transportation, affordable meals)
• Mid-Range: $2
✨ Happy travels! ✨
MIT License