OpportunIQ
AI-powered platform for diagnosing and resolving real-world maintenance issues
Overview
Role
Solo Developer
Team
Solo
Timeline
Ongoing
Stack
8 technologies
Built an AI-powered home-repair diagnosis engine that delivers recommendations in under 2 minutes by orchestrating GPT-4o with 7 grounded tools and real API data.
The Problem
Situation
Homeowners and renters waste hours researching maintenance issues across Reddit, forums, YouTube, and retail sites. They struggle to diagnose problems, understand risks, find the right parts, and decide whether to DIY or hire a professional.
My Goal
Build an AI-powered platform that automates the entire research and decision-making process for real-world maintenance and repair issues.
My Approach
Built multimodal ingestion pipeline supporting voice notes (any language), photos, and video (dissected into frames)
Integrated OpenAI Vision and Whisper for analyzing diagnostic media
Implemented Firecrawl to crawl Reddit, forums, and retail sites for solutions and in-stock products
Created budget/income input system that weighs opportunity cost and time for personalized recommendations
Built email drafting and sending feature for contacting contractors
Implemented end-to-end encryption for all diagnostic media and personal data
The Outcome
Built an AI-powered home-repair diagnosis engine that delivers recommendations in under 2 minutes by orchestrating GPT-4o with 7 grounded tools and real API data.
Implemented client-side zero-knowledge encryption for sensitive household media and financial records using AES-256-GCM and PBKDF2, ensuring uploaded data remains unreadable to the server.
Designed a decision framework capturing the full repair lifecycle — diagnosis, DIY-vs-hire cost comparison with opportunity cost, household group voting, and outcome tracking.
Built multi-modal diagnosis input (voice via Google Cloud Speech/TTS, photo via GPT-4o vision, video via FFmpeg client-side compression with diagnostic frame extraction).
Project Roadmap
MVP, stretch goals, and future vision
Project Roadmap
Development phases and milestones
AI Diagnostic Core
Photo-based issue detection and recommendations
Image Upload & Analysis
Upload photos and detect maintenance issues using AI
Diagnostic Engine
OpenAI-powered analysis with actionable recommendations
Voice Issue Reporting
Describe issues verbally for AI analysis
Enhanced Intelligence
Location mapping and cost intelligence
Location Mapping
Mapbox integration for property visualization
Financial Context Engine
Budget-aware recommendations
Email Drafting & Sending
Automated contractor communication
Platform Expansion
Mobile app, marketplace, and community
Contractor Marketplace
Connect homeowners with vetted contractors
Mobile Application
Native mobile app for on-site diagnostics
DIY Community & Reviews
Community platform for sharing solutions
Preventive Maintenance AI
Predictive maintenance scheduling based on home age and conditions
Smart Home Integration
Connect with IoT devices for real-time monitoring
Interview Questions
Common questions, answered in STAR format
Technical Decisions
Why I chose X over Y
Key Trade-offs
Every decision has costs
Challenges & Solutions
The hardest problems I solved
Code Highlights
Key sections I'd walk through in a code review
Multimodal ingestion pipeline
src/lib/ingestion/multimodal.tsThis module handles voice, photo, and video input. Voice goes through Whisper for transcription, photos go directly to Vision, and videos get dissected into frames first. Each path normalizes the output into a common DiagnosticInput type that the analysis engine consumes.
Risk vs Opportunity Cost engine
src/lib/decision/riskEngine.tsTakes the diagnostic result, user's budget/income, and urgency to calculate a recommendation score. Uses a weighted formula that considers: safety risk (highest weight), cost of delay, DIY feasibility, and financial impact. Returns a structured recommendation with confidence intervals.
What I Learned
- →Perceptual hashing deduplicates visual content before expensive API calls
- →Tiered caching by access patterns saves resources
- →RAG quality depends on chunking - smaller chunks with metadata work better
- →Privacy-first builds trust even if limits analytics
- →Queue-based architecture essential for reliable scraping
- →pgvector sufficient for thousands of vectors
- →Test scraping with fixture HTML and mock servers
- →RAG evaluation needs query-answer dataset for measuring relevance
Future Plans
- +Add voice input for describing home issues instead of just photos
- +Implement contractor matching and booking once recommendations are generated
- +Add cost estimation model trained on historical repair data
- +Mobile app for easier photo/video capture on-site
- +Community features for sharing DIY solutions and contractor reviews
Next project
Hoparc Physical Therapy
Want to discuss this project?