🏠 SmartHome Architect Agent

AI-powered home renovation planning with multi-agent orchestration, visual analysis, and photorealistic rendering using Google's Gemini 2.5 Flash

🌟 Overview

SmartHome Architect Agent is an intelligent multi-agent system that revolutionizes home renovation planning. Upload photos of your space and inspiration images, and watch as AI agents collaborate to analyze your room, create detailed design plans, estimate budgets, and generate photorealistic renderings of your transformed space.

✨ Key Features

📸 Visual Intelligence - Upload photos of your current space for AI-powered analysis
🎨 Style Transfer - Share inspiration images to match your desired aesthetic
💰 Smart Budgeting - Get realistic cost estimates tailored to your budget constraints
🖼️ Photorealistic Rendering - Generate professional-quality visualizations of your renovated space
🔄 Iterative Refinement - Easily modify renderings with natural language ("make cabinets darker")
🤖 Multi-Agent Orchestration - Specialized AI agents work together seamlessly
📋 Complete Planning - Timeline, budget breakdown, contractor list, and action checklist

🎯 What It Does

Transform your renovation planning process:

Before SmartHome Architect:

❌ Struggle to visualize renovation outcomes
❌ Uncertain about costs and timelines
❌ Difficult to communicate ideas to contractors
❌ Expensive to hire design consultants

With SmartHome Architect:

✅ See your renovated space in photorealistic detail
✅ Get accurate budget estimates and timelines
✅ Communicate your vision clearly with professional renderings
✅ Plan confidently with AI-powered recommendations

🏗️ Architecture

Multi-Agent Design Pattern

This project demonstrates Google ADK's Coordinator/Dispatcher Pattern with specialized agents:

┌─────────────────────────────────────────────────────┐
│         HomeRenovationPlanner (Coordinator)         │
│            Routes requests to specialists            │
└──────────────────┬──────────────────────────────────┘
                   │
        ┌──────────┼───────────┐
        │          │           │
        ▼          ▼           ▼
   ┌────────┐ ┌────────┐ ┌──────────────┐
   │ Info   │ │Render  │ │   Planning   │
   │ Agent  │ │Editor  │ │   Pipeline   │
   └────────┘ └────────┘ └──────┬───────┘
                                 │
                    ┌────────────┼────────────┐
                    │            │            │
                    ▼            ▼            ▼
              ┌──────────┐ ┌─────────┐ ┌───────────┐
              │ Visual   │ │ Design  │ │  Project  │
              │Assessor  │ │ Planner │ │Coordinator│
              └──────────┘ └─────────┘ └───────────┘

Agent Responsibilities

Agent	Role	Key Functions
Coordinator	Routes requests	Analyzes user intent, delegates to specialists
Info Agent	Q&A	Answers general questions, provides system info
Render Editor	Refinement	Modifies existing renderings based on feedback
Visual Assessor	Analysis	Examines photos, detects room type, identifies issues
Design Planner	Specifications	Creates detailed design plans with materials & colors
Project Coordinator	Execution	Generates renderings, timelines, budget breakdowns

Why This Pattern?

🎯 Efficient - Only runs workflows that are needed
🧩 Modular - Each agent has clear, focused responsibilities
📈 Scalable - Easy to add new capabilities
🏭 Production-Ready - Real-world agentic system design

🚀 Quick Start

Prerequisites

Python 3.10 or higher
Google API Key (Gemini 2.5 Flash)
Google ADK 1.15.0+

Installation

Clone the repository

git clone https://github.com/nobitanobi22/SmartHome-Architect-Agent.git
cd SmartHome-Architect-Agent

Install dependencies

pip install -r requirements.txt

Set up your API key

Get your API key from Google AI Studio

Option A: Environment Variable

export GOOGLE_API_KEY="your_gemini_api_key_here"

Option B: .env File

echo "GOOGLE_API_KEY=your_gemini_api_key_here" > .env

Launch ADK Web Interface

adk web

Open in browser

Navigate to http://localhost:8000 and select "SmartHome Architect Agent"

💡 Usage Examples

Example 1: Basic Kitchen Renovation

User: "What can I improve in my kitchen with a $15k budget?"
[Upload photo of current kitchen]

→ Agent analyzes space
→ Suggests budget-friendly upgrades
→ Generates before/after rendering
→ Provides timeline and contractor list

Example 2: Style Transfer

User: "Transform my bathroom to look like this"
[Upload photo 1: Current bathroom]
[Upload photo 2: Pinterest inspiration - modern spa bathroom]

→ Visual Assessor extracts style from inspiration
→ Design Planner applies style to your space
→ Project Coordinator generates photorealistic rendering
→ Complete budget breakdown provided

Example 3: Text-Only Planning

User: "Renovate my 12x14 bedroom. It has beige carpet and boring white walls. 
I want a cozy modern aesthetic with darker walls, hardwood floors, and 
better lighting. Budget: $10,000"

→ Agent creates design plan from description
→ Generates rendering based on specifications
→ Provides detailed renovation roadmap

Example 4: Iterative Refinement

[After initial rendering is generated]

User: "Make the cabinets cream instead of white"
→ Rendering Editor updates cabinet color

User: "Add pendant lights over the island"
→ Lighting fixtures added

User: "Change the flooring to lighter oak"
→ Floor material updated

All changes versioned automatically (v1, v2, v3...)

📋 Sample Prompts

Kitchens:

"Small galley kitchen (8x12), oak cabinets from 90s. Want modern farmhouse. Budget: $25k"
"Outdated kitchen with dark cabinets and laminate counters. Make it bright and airy. $30k budget"

Bathrooms:

"Tiny bathroom (5x8) with cramped tub. Want spa-like retreat with walk-in shower. $15k"
"Master bath renovation, upgrade to marble and luxury fixtures. Budget: $35k"

Bedrooms:

"Boring 10x12 bedroom needs personality. Thinking accent wall, better lighting. $8k"
"Convert spare room into cozy home office. Need built-ins and good lighting. $12k"

Living Rooms:

"Open concept living room feels cold. Want warmer colors, better furniture layout. $20k"
"1970s living room stuck in time. Modernize everything. Budget: $40k"

🛠️ Tools & Capabilities

Built-in Tools

Tool	Purpose	Example
`google_search`	Find renovation costs, materials, trends	"search for 2024 quartz countertop prices"
`estimate_renovation_cost`	Calculate costs by room type and scope	kitchen, moderate, 120 sq ft
`calculate_timeline`	Estimate project duration	cosmetic bathroom → 2-3 weeks
`generate_renovation_rendering`	Create photorealistic images	16:9 aspect ratio, ultra-detailed
`edit_renovation_rendering`	Refine existing renderings	"make walls lighter gray"
`list_renovation_renderings`	View all generated versions	v1, v2, v3 tracking

Rendering Quality

Resolution: 8K quality, photorealistic
Aspect Ratios: 16:9 (default), 1:1, 9:16
Style: Professional interior photography
Lighting: Natural, bright, magazine-quality
Version Control: Automatic versioning (v1, v2, v3...)

📊 How It Works

Step-by-Step Process

1. 📤 User Input
   ↓
2. 🧠 Coordinator Analyzes Intent
   ↓
3. 📸 Visual Assessor Analyzes Photos
   ├─ Detects room type automatically
   ├─ Identifies current condition
   ├─ Extracts style from inspiration
   └─ Estimates initial costs
   ↓
4. 🎨 Design Planner Creates Specifications
   ├─ Budget-conscious material selection
   ├─ Color palette (with exact codes)
   ├─ Fixture and appliance choices
   └─ Timeline estimation
   ↓
5. 🏗️ Project Coordinator Generates Deliverables
   ├─ Photorealistic rendering
   ├─ Detailed budget breakdown
   ├─ Timeline with phases
   ├─ Contractor recommendations
   └─ Action checklist
   ↓
6. ✅ Results Delivered to User

Technical Implementation

Frontend: Google ADK Web Interface Backend: Python with Google GenAI SDK Image Generation: Gemini 2.5 Flash (multimodal) Pattern: Coordinator/Dispatcher + Sequential Pipeline State Management: Tool Context with version tracking

🎨 Rendering Examples

Before & After Transformations

Kitchen Renovation

Current: Dated oak cabinets, laminate counters, poor lighting
Generated: Modern white shakers, quartz counters, recessed lighting
Budget: $28,000 | Timeline: 8-10 weeks

Bathroom Upgrade

Current: Cramped 5x8 with tub
Generated: Spa-like walk-in shower, marble tiles, modern fixtures
Budget: $16,500 | Timeline: 4-6 weeks

Bedroom Refresh

Current: Boring beige carpet, white walls
Generated: Accent wall (navy), hardwood floors, modern lighting
Budget: $9,200 | Timeline: 2-3 weeks

📂 Project Structure

SmartHome-Architect-Agent/
├── agent.py                 # Main multi-agent orchestration
├── tools.py                 # Image generation & editing tools
├── __init__.py             # Package initialization
├── requirements.txt         # Python dependencies
├── README.md               # This file
├── SETUP.md                # Detailed setup guide
├── USAGE.md                # Advanced usage patterns
├── .env.example            # Environment template
└── .gitignore             # Git exclusions

🔧 Configuration

Cost Estimation Rates (2024)

Costs per square foot:

Room Type	Cosmetic	Moderate	Full	Luxury
Kitchen	$50-100	$150-250	$300-500	$600-1200
Bathroom	$75-125	$200-350	$400-600	$800-1500
Bedroom	$30-60	$75-150	$150-300	$400-800
Living Room	$40-80	$100-200	$200-400	$500-1000

Timeline Estimates

Cosmetic: 1-2 weeks (paint, fixtures, minor updates)
Moderate: 3-6 weeks (some structural work)
Full: 2-4 months (complete transformation)
Luxury: 4-6 months (custom work, high-end finishes)

🤝 Contributing

Contributions are welcome! Here are ways you can help:

🐛 Report bugs and issues
💡 Suggest new features or improvements
📝 Improve documentation
🔧 Submit pull requests

Development Setup

# Fork and clone
git clone https://github.com/YOUR_USERNAME/SmartHome-Architect-Agent.git

# Create feature branch
git checkout -b feature/your-feature-name

# Make changes and test
adk web

# Commit and push
git commit -m "feat: your feature description"
git push origin feature/your-feature-name

# Open pull request

📚 Learn More

Resources

Google ADK Documentation: https://google.github.io/adk-docs/
Gemini API Docs: https://ai.google.dev/docs
Multi-Agent Patterns: https://google.github.io/adk-docs/agents/multi-agents/
Image Generation Guide: https://ai.google.dev/gemini-api/docs/vision

Tutorial

📺 Step-by-Step Video Tutorial: Coming soon!

Learn how to build this from scratch with detailed explanations of:

Multi-agent orchestration patterns
Visual analysis with Gemini 2.5 Flash
Image generation and editing workflows
State management and version control

🔒 Privacy & Security

Images: Uploaded photos are processed in-memory only
API Keys: Never logged or stored in conversation history
Data: No renovation data saved externally
Renderings: Stored locally in session artifacts only

⚙️ Troubleshooting

Common Issues

Issue: "GOOGLE_API_KEY not set"

# Solution: Export your API key
export GOOGLE_API_KEY="your_key_here"
# Or create .env file

Issue: "Model not found"

# Solution: Ensure you're using correct model name
model="gemini-2.5-flash"

Issue: "Image generation failed"

# Solution: Check prompt is detailed enough
# Minimum: room type, style, colors, materials

Issue: "Rendering edit doesn't work"

# Solution: Ensure rendering was generated first
# Check version history with list_renovation_renderings

For more troubleshooting, see USAGE.md

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Google ADK Team - For the excellent agent development framework
Gemini Team - For powerful multimodal AI capabilities
Open Source Community - For inspiration and collaboration

📧 Contact

For questions, suggestions, or collaborations:

GitHub: @nobitanobi22
Repository: https://github.com/nobitanobi22/SmartHome-Architect-Agent
Issues: https://github.com/nobitanobi22/SmartHome-Architect-Agent/issues

🗺️ Roadmap

Current Version (v1.0)

✅ Multi-agent orchestration (Coordinator/Dispatcher)
✅ Visual analysis of room photos
✅ Style extraction from inspiration images
✅ Photorealistic rendering generation
✅ Iterative rendering refinement
✅ Budget and timeline estimation

Planned Features (v2.0)

🔄 3D room scanning integration
🔄 AR preview on mobile devices
🔄 Material cost database integration
🔄 Contractor matching system
🔄 Project management dashboard
🔄 Multi-room renovation planning

Future Enhancements (v3.0)

📅 Virtual staging for real estate
📅 Energy efficiency recommendations
📅 Smart home integration suggestions
📅 ROI calculators for resale value
📅 Community sharing of designs

⭐ If you find this project useful, please star it on GitHub! ⭐

Built with ❤️ using Google ADK and Gemini AI

Report Bug · Request Feature · Documentation

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
README.md		README.md
SETUP.md		SETUP.md
__init__ (1).py		__init__ (1).py
agent.py		agent.py
requirements.txt		requirements.txt
tools.py		tools.py

Folders and files

Latest commit

History

Repository files navigation

🏠 SmartHome Architect Agent

🌟 Overview

✨ Key Features

🎯 What It Does

🏗️ Architecture

Multi-Agent Design Pattern

Agent Responsibilities

🚀 Quick Start

Prerequisites

Installation

💡 Usage Examples

Example 1: Basic Kitchen Renovation

Example 2: Style Transfer

Example 3: Text-Only Planning

Example 4: Iterative Refinement

📋 Sample Prompts

🛠️ Tools & Capabilities

Built-in Tools

Rendering Quality

📊 How It Works

Step-by-Step Process

Technical Implementation

🎨 Rendering Examples

Before & After Transformations

📂 Project Structure

🔧 Configuration

Cost Estimation Rates (2024)

Timeline Estimates

🤝 Contributing

Development Setup

📚 Learn More

Resources

Tutorial

🔒 Privacy & Security

⚙️ Troubleshooting

Common Issues

📄 License

🙏 Acknowledgments

📧 Contact

🗺️ Roadmap

Current Version (v1.0)

Planned Features (v2.0)

Future Enhancements (v3.0)

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages