README.md

---
title: Damascus Real Estate Chatbot
emoji: 🏠
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.0.2
app_file: app.py
pinned: false
license: mit
---

# Damascus Real Estate Chatbot - Falcon 7B Test

Testing Falcon 7B Instruct for Syrian Arabic real estate queries on Hugging Face Spaces.

## Overview

This is a test deployment of the Damascus Real Estate Chatbot using:
- **Falcon 7B Instruct** for Arabic language understanding
- **Syrian Arabic dialect** for natural conversation
- **20 Damascus property listings** for real estate matching
- **Entity extraction** for user requirements
- **Gradio interface** for easy testing

## Features

- 🤖 **Falcon 7B Instruct** - Advanced Arabic language model
- 🏠 **Real Estate Matching** - Finds properties based on user requirements
- 💬 **Syrian Dialect** - Natural Damascus conversational style
- 📋 **Entity Extraction** - Understands location, rooms, features
- 🔍 **Smart Filtering** - Matches properties to user criteria

## Usage

Ask questions in Syrian Arabic like:
- "بدي شقة مفروشة بالمالكي مع شرفة"
- "في شي ستوديو باب شرقي مفروش؟"
- "شو عندك بالشعلان رخيص؟"

## Next Steps

After testing on Hugging Face Spaces, this will be deployed to:
- **AWS EC2 G4 instances** for production
- **vLLM integration** for parallel inference
- **ChromaDB RAG** for semantic search
- **Performance optimization** for real-world usage

## Technical Details

- **Model**: tiiuae/falcon-7b-instruct
- **Framework**: Transformers + Gradio
- **Languages**: Syrian Arabic, some English for interface
- **Data**: 20 Damascus property listings