Otto — Travel Activity Planner

API-powered planner for things to do in your destination.
Choose dates + number of days, pick an Experience Mode (Foodie, Cultural, Adventurous...), set a budget, and get a realistic day-by-day itinerary backed by live data from Geoapify and Ticketmaster.

Everything in English. Follows karpathy.md.

Quick Start (Docker recommended)

cp .env.example .env
# Fill GEOAPIFY_API_KEY and TICKETMASTER_API_KEY (free tiers available)

docker compose -f docker-compose.dev.yml up --build

Open http://localhost:3000

Without Docker

npm install
npm run db:migrate   # requires a running Postgres (see .env)
npm run dev

Key Features (MVP)

• Explicit number of days (not just date math)
• 6 Experience Modes that bias the entire plan
• One-click adjustment buttons after generation
• Budget respected + cost estimates
• Real places + events from APIs
• Leaflet map
• Save & share by ID

See the detailed plan in the session plan.md for architecture and phases.

Environment

Required keys (free tiers):

• Geoapify
• Ticketmaster

LLM key for future full generation (currently stubbed).

Development

• Follow karpathy.md + AGENTS.md
• npm run lint
• npm run build

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.