🏆 Central India Hackathon 2.0 Finalist Project
Developed during the intense 36-hour Round 2 (Final Round) of CIH 2.0 (23–24 June 2025) organized by Suryodaya College of Engineering & Technology, Nagpur.
The AI Real Estate Advisor is a multilingual, data-driven planning ecosystem built to simplify Indian real estate investments. By pairing the rapid reasoning capabilities of Google Gemini 1.5 Flash with custom unit-economic algorithms, the application assists users in navigating complex decisions—such as whether to build a multi-unit property versus buying a single flat, estimating future rental yield, forecasting resale values, and assessing ecological risks.
The application operates on a state-based multi-step form workflow synchronized with local CSV persistence and live AI analysis tools:
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#E8F5E9', 'edgeLabelBackground':'#FFFFFF', 'tertiaryColor': '#F1F8E9', 'lineColor': '#2E7D32', 'nodeBorder': '#2E7D32' }}}%%
flowchart TD
classDef start fill:#E8F5E9,stroke:#2E7D32,stroke-width:2px,color:#1B5E20;
classDef step fill:#FFF3E0,stroke:#E65100,stroke-width:2px,color:#E65100;
classDef gemini fill:#EDE7F6,stroke:#4A148C,stroke-width:2px,color:#4A148C;
classDef tools fill:#E0F7FA,stroke:#006064,stroke-width:2px,color:#006064;
A["🏁 Start Application"]:::start --> B["🌍 Select Language (EN / HI / MR)"]:::start
B --> C["📁 Project Manager (Sidebar)"]:::start
C --> D1["➕ Create New Project"]:::step
C --> D2["📂 Load Existing (CSV)"]:::step
D1 --> E["📝 Step 1: Personal Details"]:::step
E --> F["🎯 Step 2: Primary Goal Definition"]:::step
F --> G["📐 Step 3: Location & Build Specifics"]:::step
G --> H["💾 Save Project (CSV Data Store)"]:::step
D2 & H --> I["📊 Step 4: Market Snapshot & Strategy"]:::step
I --> J["🧠 Gemini 1.5 Flash Strategy Generator"]:::gemini
J --> K["💡 Detailed Financial Advisor Report"]:::gemini
K --> L["💬 Memory-Retained Follow-up Q&A"]:::gemini
I --> M["🛠️ 14+ Advanced Real Estate Tools"]:::tools
M --> N["📈 Projections (Build vs Buy, Resale, Rental)"]:::tools
M --> O["🧱 Costs (Sqft Details, Vendor Finder)"]:::tools
M --> P["♻️ Green (Eco-Savings, Solar Payback)"]:::tools
M --> Q["📍 Location (Quality Score, Eco Risks)"]:::tools
class A,B,C start;
class D1,D2,E,F,G,H,I step;
class J,K,L gemini;
class M,N,O,P,Q tools;
- Full language localization for English, Hindi (हिन्दी), and Marathi (मराठी) to maximize accessibility for diverse demographics across central India.
- Initial Planning Report: Synthesizes user income, goals, budgets, and localities into structured financial recommendations.
- Follow-up Advisor Q&A: A state-retaining chat feature allowing users to ask natural language questions about interest rate hikes, regulatory rules, or local developer credentials.
- Build vs. Buy Analyzer: Unit economic calculator analyzing the profitability of buying a ready-made flat versus constructing a multi-unit property on land, factoring in the target Floor Space Index (FSI).
- Future Resale Predictor: Generates a 10-year compound growth projection matching local market rates.
- Hyper-Local Rent Forecaster: Forecasts commercial and residential rental potential based on proximity variables (e.g., Main Road vs. Interior).
- Investment Payback Calculator: Calculates capital recovery windows matching localized maintenance expense ratios.
- Detailed sq.ft. Costing: Displays granular itemized cost tables (structural foundations, Vitrified flooring, plumbing, painting) matching the user's budget.
- Material Price Index: Establishes commercial material prices (cement, steel, sand, bricks) across municipal zones.
- Vendor Suggestion Hub: Recommends highly-rated local builders, electricians, plumbers, and solar contractors.
- Location Quality Score: Renders an interactive score (0-100) analyzing proximity preferences and local pollution/crime concerns.
- Alternative Localities: Discovers comparable nearby neighborhoods matching the user's target square footage.
- Environmental Eco-Risk Scan: Evaluates potential flood risks and ecological sensitivities.
- Subsidy Eligibility Guide: Integrates logic for government initiatives such as PMAY (Pradhan Mantri Awas Yojana) based on annual household income and category.
- Tax Benefit Guide: Explains deductions under Sections 24(b) and 80C.
The application runs in standard Python environments (local, Codespaces, or cloud containers):
- Python 3.9 or higher installed.
- Google Gemini API Key (Obtain a key for free at Google AI Studio).
Clone the repository to your workspace:
git clone https://github.com/Advait251206/Code_Warriors_CIH_2.0.git
cd Code_Warriors_CIH_2.0Install verified packages from the requirements registry:
pip install -r requirements.txtTo prevent exposed credentials, the script loads your key securely in priority order:
- Environment Variable: Set
GOOGLE_API_KEYon your OS. - Local Dotenv File: Create a
.envfile in the root directory:GOOGLE_API_KEY=your_gemini_api_key_here
- Interactive UI Input: If no key is configured, a secure password input field will display in the Streamlit sidebar.
Execute the script to boot the web client:
streamlit run app.py├── .gitignore # Ignores pycache, .env credentials, and local project save states
├── README.md # Dynamic CIH 2.0 project documentation with colored Mermaid map
├── app.py # Streamlit client script & modular computational algorithms
├── requirements.txt # Project library dependencies
└── projects/ # Directory containing CSV-based project data (automatically ignored)
Simulated and optimized with precision for the Central India Hackathon 2.0 Final Round 🏠.