Skip to content

Date Planner Template #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: dev
Choose a base branch
from
Open

Date Planner Template #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 60 additions & 0 deletions python/date-planner/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# Stagehand + Browserbase: AI-Powered Date Planner

## AT A GLANCE
- Goal: Find personalized restaurant recommendations and plan the perfect date using AI-powered search and scoring.
- AI Integration: Uses OpenAI to generate search queries and score restaurants based on user preferences.
- Concurrent Sessions: Runs multiple browser sessions simultaneously to search different restaurant sites in parallel.
- Web Automation: Automates restaurant discovery, availability checking, and reservation attempts.

## GLOSSARY
- act: perform UI actions from a prompt (search, click, type)
Docs → https://docs.stagehand.dev/basics/act
- extract: pull structured data from pages using schemas
Docs → https://docs.stagehand.dev/basics/extract
- concurrent sessions: run multiple browser sessions simultaneously for faster searching
Docs → https://docs.browserbase.com/guides/concurrency-rate-limits

## QUICKSTART
1) cd python/date-planner
2) python -m venv venv
3) source venv/bin/activate # On Windows: venv\Scripts\activate
4) pip install -r requirements.txt
5) cp .env.example .env
6) Add your Browserbase API key, Project ID, and OpenAI API key to .env
7) python main.py

## EXPECTED OUTPUT
- Prompts user for date preferences, cuisine, location, budget, and special requirements
- Generates search queries using OpenAI based on user input
- Runs concurrent browser sessions to search restaurant sites (OpenTable, Yelp, etc.)
- Extracts restaurant data using structured schemas
- AI-scores restaurants based on user preferences
- Attempts to check availability and make reservations
- Suggests nearby activities to extend the date
- Displays comprehensive date plan with primary restaurant, backups, and activities

## COMMON PITFALLS
- "ModuleNotFoundError": ensure all dependencies are installed via pip
- Missing credentials: verify .env contains all required API keys
- Search failures: check internet connection and website accessibility
- Import errors: activate your virtual environment if you created one
- Reservation failures: some restaurants may require manual booking

## USE CASES
• Date planning: Find restaurants based on preferences, check availability, and suggest activities
• Restaurant discovery: AI-powered search across multiple platforms with intelligent scoring
• Event planning: Extend functionality for group dining, special occasions, and venue booking
• Travel planning: Adapt for finding restaurants in different cities with local recommendations

## NEXT STEPS
• Add more restaurant platforms: Integrate with Resy, SevenRooms, and local booking sites
• Enhanced AI scoring: Include factors like ambiance, dietary restrictions, and seasonal menus
• Activity integration: Connect with event APIs, movie times, and local attractions
• Calendar integration: Sync with user calendars and send reminders

## HELPFUL RESOURCES
📚 Stagehand Docs: https://docs.stagehand.dev/v3/first-steps/introduction
🎮 Browserbase: https://www.browserbase.com
💡 Try it out: https://www.browserbase.com/playground
🔧 Templates: https://www.browserbase.com/templates
📧 Need help? support@browserbase.com
Loading