Roomie
A student roommate and apartment matcher built at the GDGoC National Hackathon 2026 in Hanoi with team Hackaphobia. An onboarding survey and swipe interface match on structured fields — location, budget — with an optional free-text bio path using Vertex AI embeddings and cosine similarity.
Provenance
- Role
- Contributor, team of 4 — DevOps & Backend Engineering
- Period
- April 2026
- Built at
- GDGoC National Hackathon 2026 (Hanoi) — team Hackaphobia
- Stack
- Python · FastAPI · React · PostgreSQL · SQL · Vertex AI embeddings
Measured
- Users onboarded
- ~50real users who onboarded and swiped at demo day
- Average request latency
- ~12 msstructured matching path only — excludes embedding generation
Architecture Pattern
Asynchronous FastAPI service with a stateful in-memory WebSocket layer and structured matching
A FastAPI backend isolates incoming I/O from the matching work. Chat is handled by an in-memory connection manager (chat_manager.py) holding stateful WebSocket maps rather than round-tripping every message through PostgreSQL. Matching runs in an isolated block (vector_logic.py): structured fields resolve directly, and the optional free-text bio path computes cosine similarity over Vertex AI embeddings. An MCP-plus-n8n agentic pipeline was designed and then rejected as over-scoped for a four-person team with no operational runway.
Available Product
Next.js Mobile Starter Kit
A mobile-first Next.js 16 and React 19 app skeleton: nine routes, a touch-gesture swipe deck built without a gesture library, a multi-step questionnaire, and a Radix-backed component set on Tailwind.