The Perfect Reunion

Inspiration

We all know how difficult it can be to organize a trip with your friends. From searching a time which fits all, making sure it doesn't go over anyone's budget to trying to agree where to travel to and what to do there. Our tool is the solution to this problem, offering a fun and simple way to plan a trip!

What it does

The Perfect Reunion helps groups to organize a trip together. Users can create or join a private room with friends, answer personalized questions, and collectively narrow down travel preferences. Our AI assistant generates new questions dynamically and suggests three city destinations based on the groups decisions, ensuring the final choice contains everyones wishes.

How we built it

We built a full-stack web app using FastAPI for the backend and WebSockets for real-time room-based communication. We used Google's Gemini AI to generate adaptive, context-aware questions and city recommendations. Data like answers and history are managed in structured dictionaries, simulating a stateful environment without a persistent database. Group dynamics, voting logic, and tie-breaker handling are fully automated.

Challenges we ran into

Designing real-time communication between multiple users in a room using WebSockets.
Ensuring that the AI prompts were specific and structured enough to return usable JSON responses.
Handling group consensus logic, including ties and dynamic voting.
Managing session states without a database while keeping the experience smooth.

Accomplishments that we're proud of

Seamlessly integrated AI to guide group decisions in a natural and engaging way.
Built a working multiplayer experience with real-time updates and shared state, inspired by popular browser games like skribbl.io.
Created a fun and fair process for choosing travel destinations collaboratively.

What we learned

How to structure prompts to get reliable JSON output from generative models.
Best practices for managing real-time user interactions with WebSockets in FastAPI.
The importance of UX in group decision tools, even in early prototypes.
Some team members learned how to use Git.
We also learned how to develop both frontend and backend components of a web application.