Reisplanner Agent

Agent-ready travel planning toolkit for producing source-backed trip plans and local HTML travel portals.

This repository is local-first. You do not need to host anything online. If you attach a Vercel project, the generated static HTML can be shared more easily, but hosting is optional.

Quick start

make check
make render-demo

Open dist/weekend-leiden.html in your browser.

Agent usage

Use SKILL.md as the agent-facing contract. A complete plan should include route data, map markers, weather evidence, activities, accommodation candidates with photo URLs, costs, and sources.

PYTHONPATH=src python -m reisplanner_agent.cli validate examples/weekend-leiden.yaml
PYTHONPATH=src python -m reisplanner_agent.cli render examples/weekend-leiden.yaml --out dist/weekend-leiden.html

Local-first output

The default workflow writes a standalone HTML file under dist/. No online hosting is required.

Optional Vercel

If you attach a Vercel project, use the included vercel.json as a simple static export setup. See docs/DEPLOYMENT.md. Keep real trips private unless the generated page is intentionally share-safe.

Safety boundary

• No booking, payment, scraping private accounts, or pretending stale availability is current.
• Keep real private itineraries out of public git history.
• Demo fixtures must be sanitized and source-backed.
• Online hosting is a convenience, not access control.

Repository map

• SKILL.md — agent contract.
• schema/ — trip-plan schema.
• examples/ — sanitized fixtures.
• src/reisplanner_agent/ — CLI and renderer.
• docs/ — architecture, deployment, privacy, package, roadmap, and maintainer docs.
• scripts/validate_repository.py — repo-complete and safety guard.

Contributing

Read CONTRIBUTING.md, SUPPORT.md, and docs/PRIVACY.md. Run make check before shipping.