🏠 Real Estate Assistant

AI-powered real estate management system with:

• Web UI (Flask) for browser-based management
• Telegram Bot for chat and voice interaction

---

Platforms

• Web: Modern dashboard with AI-assisted registration, semantic search, Excel/PDF import & export
• Telegram: Goal-first chatbot with voice support (optional, controlled by RUN_MODE)

👉 Live Demo: Try the app directly in your browser on Hugging Face Spaces here.

---

Quick Start

1. Clone

git clone https://github.com/yourusername/Real-Estate-Bot.git
cd Real-Estate-Bot

2. Configure

cp env.example .env
# Edit .env and set at least:
# OPENAI_API_KEY=...
# FLASK_SECRET_KEY=...

3. Run Web UI

pip install -r requirements.txt
export RUN_MODE=web  # or set RUN_MODE=web on Windows
python main.py
# Open http://localhost:7860

4. Run Telegram Bot (optional)

# In .env set TELEGRAM_BOT_TOKEN=your-bot-token
export RUN_MODE=telegram   # or both
python main.py

---

Environment Variables (minimal)

• OPENAI_API_KEY – OpenAI API key
• FLASK_SECRET_KEY – Random secret for Flask sessions
• RUN_MODE – web (default), telegram, or both
• DATABASE_URL – default sqlite:///real_estate.db
• OPENAI_API_BASE – optional, default https://api.openai.com/v1

---

Tech Stack

• Backend: Python 3.11, Flask, SQLAlchemy, python-telegram-bot
• AI: OpenAI GPT-4o, embeddings, optional Qdrant for semantic search
• Frontend: Vanilla JS, modern CSS, responsive layout
• Deployment: Docker, Hugging Face Spaces