Open Source Repository

AI-Assisted Home Search Stack with Real-World Fallbacks

A production-minded repo for budget-aware home search using FastAPI, Docker, Ollama, scrape fallbacks, and persistence for saved searches and homes.

GitHub Source Quick Start

Resilient Search Pipeline

Direct MLS (optional) plus scrape/API fallback chain designed for non-ideal real-world sources.

AI Affordability + Fit

Uses local LLM support to evaluate affordability and generate listing-level fit summaries.

Docker-First Deployment

Single compose stack with health checks, restart policy, and persisted saved data volume.

Quick Start

Clone the repository.
Copy .env.example to .env.
Run docker compose up -d --build.

git clone <your-repo-url>
cd <repo-folder>
cp .env.example .env
docker compose up -d --build

Repository Highlights

FastAPI backend with structured search/detail/saved endpoints
Frontend search UI with listing detail modal and save actions
SQLite persistence for saved search criteria and saved homes
GitHub Actions CI, Pages deploy, and secret scanning workflows

Explore the Codebase

Use this repo as a base for your own real-estate research workflow, AI-assisted filtering, or data-source resilience experiments.

Open Repository