Adventure Planner

Adventure Planner is an OpenHome community ability that builds personalised travel itineraries from a single sentence. Say where you want to go and it handles the full planning workflow — day-by-day or week-by-week plans, accommodation suggestions, local activity ideas, live events, travel tips, and Google Calendar export. Plans can be saved and recalled across sessions.

​

What It Does

• Generates day-by-day plans for trips up to 7 days, and week-by-week plans for trips up to 31 days
• Fetches real weather forecasts for dated trips (up to 14 days ahead) using Open-Meteo
• Suggests accommodation options matched to the destination and budget
• Finds upcoming concerts, shows, and events using the Ticketmaster API
• Provides travel tips including packing advice, budget notes, and local etiquette
• Exports the current plan to Google Calendar — one event per day or per week
• Saves plans and recalls them across sessions (up to 10 stored plans)
• Auto-detects the user’s home city from their connection — no manual setup required

​

Supported Requests

​

How Duration Works

For dated trips, the ability fetches the actual forecast for those specific dates from Open-Meteo. For undated short trips, current conditions are used. For week-long or longer plans, weather is omitted to avoid misleading forecasts.

​

Example Conversation

User: Plan a weekend in Murree. Ability: Great choice. Let me put together your two-day plan for Murree — this’ll just take a moment. Ability: Here’s your two-day plan for Murree. Expect partly cloudy, around 18 degrees Celsius. Ability: Day 1: Start with breakfast at a local dhaba on Mall Road, then hike up to Pindi Point for panoramic views. In the afternoon, browse the local bazaar. End the evening with a cosy dinner at Lintott’s Restaurant. Ability: Day 2: Take the chairlift to Kashmir Point for valley views, then visit Patriata for a forest walk. Grab a late lunch at Monal Restaurant before heading back. Ability: Is there anything else I can help with? I can refine this plan, dive deeper into any day, save it, or recommend where to stay. User: Where should I stay? Ability: (speaks three budget-matched accommodation options)

​

Trigger Phrases

• plan a trip
• plan an outing
• weekend planner
• plan an adventure

​

Setup

Most features work with no configuration. One optional API key unlocks live events:

1. Get a free Ticketmaster API key at developer.ticketmaster.com.
2. Open OpenHome and go to Settings → API Keys.
3. Add a new key with:
   • Name: ticketmaster_api_key
   • Value: your Ticketmaster Consumer Key

The calendar export feature uses your existing OpenHome Google connection. Connect it under Settings → Linked Accounts. See Reading Linked Account Tokens with get_token() for the full reference and a fallback pattern when the account is not linked.

​

APIs Used

​

Voice Flow

1. User triggers the ability.
2. If no home city is stored, the ability silently resolves one from the connection IP and saves it.
3. Obvious exit phrases are caught before any model call for instant, reliable exits.
4. Each remaining turn is classified by a single LLM call with the active plan and recent conversation as context.
5. The destination is geocoded, weather is fetched if appropriate, and the LLM generates the plan.
6. The plan is saved as the current plan. The user can refine it, save it, request accommodation, look up events, export to calendar, or plan something new.
7. When the user says stop, the ability speaks a farewell and hands control back to OpenHome.

​

Intents

​

Failure Handling

• If Google is not linked, the ability gives account-linking guidance and continues the session.
• If the Ticketmaster key is missing, the ability notifies the user and skips the events lookup.
• All API failures are logged with the [OutingTrip] prefix and the session continues without spoken error noise.
• Trips longer than 31 days are politely declined without making any API or LLM calls.

​

Developer Credit

Developed by @megz2020.