README.md

Examples

🌍 Surprise Trip Planner

src/surprise_trip.ts

Creates a personalized travel itinerary for Wrocław, Poland with activities, landmarks, and restaurants.

Actors: Activity Planner, Landmark Scout, Restaurant Scout, Itinerary Compiler

🏥 Medical Survey

src/medical_survey.ts & src/medical_survey_server.ts

Conducts a pre-visit medical survey with patients and generates a markdown report. Available as both CLI and server implementations.

Actors: Nurse, Reporter

📚 Library Photo to Website

src/library_photo_to_website.ts

Analyzes a photo of a library to identify books and generates a website listing them.

Actors: Librarian, HTML Webmaster

👟 E-commerce Product Description

src/ecommerce_product_description.ts

Analyzes product photos and creates compelling e-commerce descriptions with technical details.

Actors: Technical Expert, Marketing Manager

📋 Interactive Survey

src/survey.ts

Conducts an interactive medical survey with persistence capabilities.

Actors: Nurse, Reporter

📰 News Wrap Up

src/news_wrap_up.ts

Researches and summarizes the top news from the past week into a comprehensive report.

Actors: News Researcher, News Reader, Wrapup Redactor

📈 GitHub Trending

src/github_trending.ts

Scrapes and analyzes trending Typescript projects from GitHub, creating a markdown summary report.

Actors: Github Researcher, Redactor

📈 GitHub Trending with Vector Store

src/github_trending_vector.ts

Scrapes and analyzes trending Typescript projects from GitHub. Then: asks user about which project he/she wants top learn more - and creates a markdown summary report.

Actors: Github Researcher, Redactor

Running

Each example is a self-contained TypeScript file that can be run with Bun, or with tsx

$ bun run src/<example-name>.ts

or

$ tsx src/<example-name>.ts