README.md

metadata

title: Gruha-Alankara
emoji: 🛋️
colorFrom: purple
colorTo: indigo
sdk: docker
pinned: false

🛋️ Gruha Alankara

Welcome to Gruha Alankara, an AI-powered AR Interior Design application. Instantly see how beautiful furniture fits into your real space using advanced computer vision and Agentic AI!

✨ Key Features

• 📷 AR Visualizer: Use your mobile camera to see how furniture fits and looks in your actual room instantly.
• 🗣️ Multilingual Voice Assistant: Interact naturally with your AI Buddy using voice commands in Telugu, Hindi, or English.
• 📊 User Dashboard: Manage your designs, saved layouts, and preferences through a dedicated, personalized dashboard interface.

🧰 Tech Stack

• Backend: Python (Flask)
• Frontend: HTML5, Vanilla CSS3, JavaScript
• AI/ML: Agentic AI frameworks & local Hugging Face Transformers (blip-image-captioning-base) for personalized spatial recommendations.
• Deployment: Hugging Face Spaces (Dockerized)

🚀 Installation & Setup

1. Clone the repository:

   git clone https://github.com/ocial123/Gruha-alankara.git
   cd Gruha-alankara
   

2. Install dependencies: Make sure you have Python 3.10+ installed.

   pip install -r requirements.txt
   

3. Set up Environment Variables: Create a .env file in the root directory and add your Hugging Face API Token (needed for the AI agent):

   HUGGINGFACEHUB_API_TOKEN=your_hf_token_here
   SECRET_KEY=super-secret-gruha-key
   

4. Run the application locally:

   python app.py
   

   The application will launch locally at http://localhost:5000.

---

📂 Architecture & Structure

• app.py: The main entry point and route handler for the Flask web application.
• ai_agent.py: Handles AI pipeline integrations, computer vision, text-generation logic, and voice synthesis.
• models.py: Defines the SQLAlchemy database schemas for Users, Designs, Bookings, and Furniture.
• config.py: Application configurations and cross-site cookie settings (required for Hugging Face Spaces iframes).
• Dockerfile: Production deployment instructions utilized by Hugging Face Spaces to build the container.