Skip to content

bnssaanirudh/IntentIQ-Spatial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

IntentIQ Spatial 🌐

Anticipate the Market. Map the Future.

License: MIT React FastAPI Leaflet


🎯 The Elevator Pitch

IntentIQ Spatial is a high-frequency real estate intelligence engine. We fuse real-time macro indicators—like job growth from FRED and search demand momentum from Google Trends—with sub-neighborhood granularity. By integrating a native AI copilot with an interactive scenario simulator, we allow developers and investors to visualize the impact of migration shifts and economic shocks long before they happen.


✨ Core Pillars

1. Geo-Demand Equilibrium 🗺️

Interactive Leaflet-powered dashboard that maps submarket-level "Demand Scores" (0-100). Uses custom glassmorphism gauges and heatmap layers to visualize market health.

2. Scenario Sim Engine ⚡

Real-time macro-economic simulator. Adjust sliders for job growth, migration inflow, or interest rate deltas to see the geographic demand equilibrium shift instantly.

3. AI Copilot 🤖

A native LLM-driven research assistant. Ask natural language questions like "Where is the rent growth momentum highest?" or "Analyze Austin's tech-migration risk" to configure the map layers automatically.


🏗️ Architecture

graph TD
    A[Public APIs: FRED, Google Trends] --> B[Data Ingestion Engine]
    B --> C[Normalization & Scoring]
    C --> D[Reality Engine Core]
    D --> E[React Dashboard]
    E --> F[AI Copilot - Groq/OpenAI]
    F --> E
    E --> G[Scenario Simulation Panel]
    G --> D
Loading

🚀 Quick Start (Local Setup)

1. Prerequisites

  • Python 3.9+
  • Node.js 16+
  • (Optional) FRED API Key

2. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000
  • API Docs: http://localhost:8000/docs

3. Frontend Setup

cd frontend
npm install
npm start
  • Dashboard: http://localhost:3000/dashboard

📊 Scoring Methodology

Our Demand Score is an institutional-grade composite index calculated as: Demand = (0.35 * Job_Growth) + (0.25 * Search_Momentum) + (0.25 * Rent_Growth) + (0.15 * Migration_Inflow)


🛠️ Built With

  • Frontend: React.js, Tailwind CSS, React-Leaflet, Framer Motion, Lucide Icons
  • Backend: FastAPI, Pandas, GeoPandas, Pytrends, FRED API
  • AI: Groq SDK / OpenAI Integration
  • Infrastructure: CartoDB Dark Matter (Free, high-contrast tiles)

About

A high-frequency geospatial intelligence engine for real estate. Fuses real-time data (FRED, Google Trends) with spatial analytics to map market demand, simulate economic shocks, and unlock predictive alpha.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors