100+ AI Agents, Agent Skills and RAG Apps - Free and Open Source.
chore: Update AI Home Renovation Agent to utilize Gemini 3 Flash and Gemini 3 Pro, enhancing multimodal capabilities. Modify tools to support artifact management and ensure layout preservation in renderings.
Shubhamsaboo44efabeac69a
diff --git a/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/README.md b/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/README.mdindex bb96837e..6771d899 100644--- a/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/README.md+++ b/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/README.md@@ -3,12 +3,12 @@### π FREE Step-by-Step Tutorial**π [Click here to follow our complete step-by-step tutorial](https://www.theunwindai.com/p/build-an-ai-home-renovation-planner-agent-using-nano-banana) and learn how to build this from scratch with detailed code walkthroughs, explanations, and best practices.**-A multi-agent system built with Google ADK that analyzes photos of your space, creates personalized renovation plans, and generates photorealistic renderings using Gemini 2.5 Flash's multimodal capabilities.+A multi-agent system built with Google ADK that analyzes photos of your space, creates personalized renovation plans, and generates photorealistic renderings using Gemini 3 Flash and Gemini 3 Pro's multimodal capabilities.## Features- **π Smart Image Analysis**: Upload room photos and inspiration images - agent automatically detects and analyzes them-- **π¨ Photorealistic Rendering**: Generates professional-quality images of your renovated space using Gemini 2.5 Flash+- **π¨ Photorealistic Rendering**: Generates professional-quality images of your renovated space using Gemini 3 Pro- **π° Budget-Aware Planning**: Tailors recommendations to your budget constraints- **π Complete Roadmap**: Provides timeline, budget breakdown, contractor list, and action checklist- **π€ Multi-Agent Orchestration**: Demonstrates Coordinator/Dispatcher + Sequential Pipeline patternsdiff --git a/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/agent.py b/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/agent.pyindex 195bebc8..231a52bb 100644--- a/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/agent.py+++ b/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/agent.py@@ -1,6 +1,6 @@"""AI Home Renovation Planner - Coordinator/Dispatcher Pattern with Multimodal Vision-This demonstrates ADK's Coordinator/Dispatcher Pattern with Gemini 2.5 Flash's multimodal+This demonstrates ADK's Coordinator/Dispatcher Pattern with Gemini 3 Flash's multimodalcapabilities where a routing agent analyzes requests and delegates to specialists:- General questions β Quick info agent@@ -26,7 +26,7 @@ from .tools import (search_agent = LlmAgent(name="SearchAgent",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Searches for renovation costs, contractors, materials, and design trends",instruction="Use google_search to find current renovation information, costs, materials, and trends. Be concise and cite sources.",tools=[google_search],@@ -108,7 +108,7 @@ def calculate_timeline(info_agent = LlmAgent(name="InfoAgent",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Handles general renovation questions and provides system information",instruction="""You are the Info Agent for the AI Home Renovation Planner.@@ -135,7 +135,7 @@ Be enthusiastic about home improvement and helpful!rendering_editor = LlmAgent(name="RenderingEditor",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Edits existing renovation renderings based on user feedback",instruction="""You refine existing renovation renderings.@@ -165,6 +165,10 @@ Call: edit_renovation_rendering(Be SPECIFIC in prompts - vague = poor results!After editing, briefly confirm the change.++**IMPORTANT - DO NOT use markdown image syntax!**+- Do NOT output `` or similar markdown image links+- Simply confirm the edit was successful and mention the artifact is available in the artifacts panel""",tools=[edit_renovation_rendering, list_renovation_renderings],)@@ -176,7 +180,7 @@ After editing, briefly confirm the change.visual_assessor = LlmAgent(name="VisualAssessor",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Analyzes room photos and inspiration images using visual AI",instruction="""You are a visual AI specialist. Analyze ANY uploaded images and detect their type automatically.@@ -198,6 +202,16 @@ AUTOMATICALLY DETECT:- Key problems: [what needs fixing]- Improvement opportunities: [quick wins, major changes]+**CRITICAL - DOCUMENT EXACT LAYOUT (for preservation in rendering):**+- Window positions: [e.g., "large window on left wall above sink", "skylight in center"]+- Door positions: [e.g., "doorway on right side"]+- Cabinet layout: [e.g., "L-shaped upper and lower cabinets along back and left walls"]+- Appliance positions: [e.g., "stove centered on back wall", "refrigerator on right"]+- Sink location: [e.g., "under window on left wall"]+- Counter layout: [e.g., "continuous counter along back and left walls"]+- Special features: [e.g., "skylight", "breakfast bar", "island"]+- Camera angle in photo: [e.g., "shot from doorway looking into kitchen"]+## For INSPIRATION images:**Inspiration Style:**- Style name: [modern farmhouse/minimalist/industrial/etc.]@@ -237,9 +251,19 @@ Room Details:- Key Issues: [problems to address]- Improvement Opportunities: [suggested improvements]- Budget Constraint: $[amount if mentioned, or "Not specified"]++**EXACT LAYOUT TO PRESERVE (critical for rendering):**+- Windows: [exact positions and sizes]+- Doors: [exact positions]+- Cabinets: [configuration and placement - upper/lower, which walls]+- Appliances: [stove, fridge, dishwasher positions]+- Sink: [location]+- Counter layout: [shape and coverage]+- Special features: [skylights, islands, breakfast bars, etc.]+- Camera angle: [perspective of the original photo]```-Be DETAILED in your analysis - this drives the quality of the generated rendering later.+Be EXTREMELY DETAILED about the layout - the rendering must match this layout EXACTLY while only changing surface finishes.""",tools=[AgentTool(search_agent), estimate_renovation_cost],)@@ -247,31 +271,49 @@ Be DETAILED in your analysis - this drives the quality of the generated renderindesign_planner = LlmAgent(name="DesignPlanner",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Creates detailed renovation design plan",instruction="""Read from state: room_analysis, style_preferences, room_type, key_issues, opportunities, budget_constraintCreate SPECIFIC, ACTIONABLE design plan tailored to their situation.+**CRITICAL RULE - PRESERVE EXACT LAYOUT:**+The design plan must KEEP THE EXACT SAME LAYOUT as the current room. DO NOT suggest:+- Moving appliances to different locations+- Reconfiguring cabinet positions+- Adding or removing windows/doors+- Changing the room's footprint or structure+- Adding islands or removing existing features++ONLY specify changes to SURFACE FINISHES applied to the existing layout:+- Paint colors for existing walls and cabinets+- New countertop material on existing counters+- New flooring in the same floor area+- New backsplash on existing walls+- New hardware on existing cabinets+- Lighting upgrades (can add under-cabinet lights, replace fixtures in same positions)+## Design Plan**Budget-Conscious Approach:**- If budget_constraint exists: Prioritize changes that give max impact for the money- Separate "must-haves" vs "nice-to-haves"-**Design Specifications:**-- **Layout**: [keep same/modify - be specific about changes]-- **Colors**: [exact colors with names - "Benjamin Moore Simply White OC-117"]-- **Materials**: [specific products - "Shaker white cabinets", "Carrara quartz countertops"]-- **Flooring**: [type, color, installation]-- **Lighting**: [fixture types, placement, purpose]-- **Storage**: [solutions for identified needs]-- **Appliances**: [if applicable - keep/replace/upgrade]-- **Key Features**: [backsplash, hardware, special elements]+**Design Specifications (surface finish changes ONLY - no layout changes):**+- **Layout**: PRESERVE EXACTLY AS-IS (reference Visual Assessor's layout documentation)+- **Cabinet Color**: [exact paint color with code - applied to EXISTING cabinets]+- **Wall Color**: [exact paint color with code]+- **Countertops**: [material and color - applied to EXISTING counter layout]+- **Flooring**: [type, color - same floor area]+- **Backsplash**: [material, pattern - same wall areas]+- **Hardware**: [handles, pulls - replace on existing cabinets]+- **Lighting**: [fixture upgrades in same positions, add under-cabinet if applicable]+- **Appliances**: [keep existing OR replace with similar size in SAME locations]+- **Key Features**: [decorative elements only]**Style Consistency:**-If inspiration photo provided: Match that aesthetic precisely+If inspiration photo provided: Match that aesthetic precisely using ONLY surface finish changesIf no inspiration: Use style_preferences from stateUse calculate_timeline tool with room_type and renovation_scope.@@ -281,17 +323,23 @@ Use calculate_timeline tool with room_type and renovation_scope.```DESIGN COMPLETE-Renovation Scope: [cosmetic/moderate/full/luxury]-Design Approach: [preserve_layout/reconfigure_layout]+Renovation Scope: [cosmetic/moderate - NO structural changes]+Layout: PRESERVED EXACTLY (no changes to cabinet positions, appliance locations, or room structure)-Materials Summary:-[Detailed list with product names]+Surface Finish Changes:+- Cabinets: [color change only]+- Walls: [paint color]+- Countertops: [material/color]+- Flooring: [type/color]+- Backsplash: [material/pattern]+- Hardware: [style/finish]+- Lighting: [upgrades]-Design Plan Summary:-[All specifications from above]+Materials Summary:+[Detailed list with product names and color codes]```-Be SPECIFIC with product names, colors, dimensions. This drives the rendering quality.+Be SPECIFIC with product names, colors, dimensions. The rendering must show the EXACT same layout with only the surface finishes changed.""",tools=[calculate_timeline],)@@ -299,7 +347,7 @@ Be SPECIFIC with product names, colors, dimensions. This drives the rendering quproject_coordinator = LlmAgent(name="ProjectCoordinator",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Coordinates renovation timeline, budget, execution plan, and generates photorealistic renderings",instruction="""Read conversation history to extract:@@ -342,21 +390,31 @@ Build an EXTREMELY DETAILED prompt that incorporates:**Prompt Structure:**"Professional interior photography of a renovated [room_type].-Current Space Context: [If Visual Assessor analyzed photos, mention key layout features to preserve]+**CRITICAL - PRESERVE EXACT LAYOUT**: The room must maintain the EXACT same layout, structure, and spatial arrangement as the original photo:+- Same window positions and sizes+- Same door locations+- Same cabinet configuration and placement+- Same appliance positions (stove, sink, refrigerator in same spots)+- Same architectural features (skylights, alcoves, etc.)+- Same room dimensions and proportions+- Same camera angle/perspective as the original photo-Design Specifications:+ONLY change the surface finishes, colors, materials, and decorative elements - NOT the structure or layout.++Design Specifications (changes to apply to the EXISTING layout):- Style: [exact style from design plan]-- Colors: [specific color names with codes - e.g., 'Benjamin Moore Simply White OC-117 on walls']-- Cabinets/Fixtures: [exact specifications - e.g., 'white shaker style cabinets with brushed nickel hardware']-- Countertops: [material and color - e.g., 'Carrara marble-look quartz countertops']-- Flooring: [type and color - e.g., 'light oak luxury vinyl plank flooring']-- Backsplash: [pattern and material - e.g., 'white subway tile in classic running bond']-- Lighting: [specific fixtures - e.g., 'recessed LED lights plus pendant lights over island']-- Appliances: [if applicable - e.g., 'stainless steel appliances']-- Key Features: [all important elements from design]--Camera: Wide-angle interior photography, eye-level perspective-Quality: Photorealistic, 8K, professional interior design magazine, natural lighting, bright and airy"+- Cabinet Color: [specific color names with codes - e.g., 'Benjamin Moore Simply White OC-117' - apply to EXISTING cabinets in their current positions]+- Wall Color: [specific paint color]+- Countertops: [material and color - apply to EXISTING counter layout]+- Flooring: [type and color - same floor area]+- Backsplash: [pattern and material - same wall areas]+- Hardware: [handles, pulls - replace on existing cabinets]+- Lighting: [specific fixtures - same positions or clearly specified additions]+- Appliances: [keep existing OR specify replacements in SAME locations]+- Key Features: [all important elements]++Camera: Match the EXACT camera angle from the original photo+Quality: Photorealistic, 8K, professional interior design magazine, natural lighting"Parameters:- prompt: [your ultra-detailed prompt above]@@ -366,6 +424,12 @@ Parameters:**After generating:**Briefly describe (2-3 sentences) key features visible in the rendering and how it addresses their needs.+**IMPORTANT - DO NOT use markdown image syntax!**+- Do NOT output `` or similar markdown image links+- Do NOT try to display the image inline with markdown+- Simply mention that the rendering has been generated and saved as an artifact+- The user can view the artifact through the artifacts panel+**Note**: Image editing from uploaded photos has limitations in ADK Web. We generate fresh renderings based on detailed descriptions from the analysis.""",tools=[generate_renovation_rendering, edit_renovation_rendering, list_renovation_renderings],@@ -390,7 +454,7 @@ planning_pipeline = SequentialAgent(root_agent = LlmAgent(name="HomeRenovationPlanner",- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",description="Intelligent coordinator that routes renovation requests to the appropriate specialist or planning pipeline. Supports image analysis!",instruction="""You are the Coordinator for the AI Home Renovation Planner.diff --git a/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/tools.py b/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/tools.pyindex ebb8f47b..037943fb 100644--- a/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/tools.py+++ b/advanced_ai_agents/multi_agent_apps/ai_home_renovation_agent/tools.py@@ -110,7 +110,7 @@ class GenerateRenovationRenderingInput(BaseModel):class EditRenovationRenderingInput(BaseModel):- artifact_filename: str = Field(..., description="The filename of the rendering artifact to edit.")+ artifact_filename: str = Field(default=None, description="The filename of the rendering artifact to edit. If not provided, uses the last generated rendering.")prompt: str = Field(..., description="The prompt describing the desired changes (e.g., 'make cabinets darker', 'add pendant lights', 'change floor to hardwood').")asset_name: str = Field(default=None, description="Optional: specify asset name for the new version (defaults to incrementing current asset).")reference_image_filename: str = Field(default=None, description="Optional: filename of a reference image to guide the edit. Use 'latest' for most recent upload.")@@ -124,7 +124,7 @@ async def generate_renovation_rendering(tool_context: ToolContext, inputs: Gener"""Generates a photorealistic rendering of a renovated space based on the design plan.- This tool uses Gemini 2.5 Flash's image generation capabilities to create visual+ This tool uses Gemini 3 Pro's image generation capabilities to create visualrepresentations of renovation plans. It can optionally use current room photosand inspiration images as references."""@@ -134,7 +134,10 @@ async def generate_renovation_rendering(tool_context: ToolContext, inputs: Generlogger.info("Starting renovation rendering generation")try:client = genai.Client()- inputs = GenerateRenovationRenderingInput(**inputs)++ # Handle inputs that might come as dict instead of Pydantic model+ if isinstance(inputs, dict):+ inputs = GenerateRenovationRenderingInput(**inputs)# Handle reference images (current room photo or inspiration)reference_images = []@@ -163,31 +166,40 @@ async def generate_renovation_rendering(tool_context: ToolContext, inputs: GenerOriginal description: {inputs.prompt}+ **CRITICAL REQUIREMENT - PRESERVE EXACT LAYOUT:**+ The generated image MUST maintain the EXACT same room layout, structure, and spatial arrangement described in the prompt:+ - Keep all windows, doors, skylights in their exact positions+ - Keep all cabinets, counters, appliances in their exact positions+ - Keep the same room dimensions and proportions+ - Keep the same camera angle/perspective+ - ONLY change surface finishes: paint colors, cabinet colors, countertop materials, flooring, backsplash, hardware, and decorative elements+ - DO NOT move, add, or remove any structural elements or major fixtures+Enhance this to be a professional interior photography prompt that includes:- - Specific camera angle (wide-angle, eye-level perspective)- - Exact colors and materials mentioned- - Realistic lighting (natural light from windows, fixture types)- - Spatial layout and dimensions- - Texture and finish details+ - Specific camera angle (match original photo perspective if described)+ - Exact colors and materials mentioned (apply to existing surfaces)+ - Realistic lighting (natural light from existing windows, fixture types)+ - Maintain existing spatial layout and dimensions+ - Texture and finish details for the new materials- Professional interior design photography qualityAspect ratio: {inputs.aspect_ratio}"""if reference_images:- base_rewrite_prompt += "\nUse the provided reference image(s) as inspiration for style, layout, or visual elements."+ base_rewrite_prompt += "\n\n**Reference Image Layout:** The reference image shows the EXACT layout that must be preserved. Match the camera angle, room structure, window/door positions, and furniture/appliance placement EXACTLY. Only change the surface finishes and colors."- base_rewrite_prompt += "\n\n**Important:** Output your prompt as a single detailed paragraph optimized for photorealistic interior rendering."+ base_rewrite_prompt += "\n\n**Important:** Output your prompt as a single detailed paragraph optimized for photorealistic interior rendering. Emphasize that the layout must remain unchanged."# Get enhanced promptrewritten_prompt_response = client.models.generate_content(- model="gemini-2.5-flash",+ model="gemini-3-flash-preview",contents=base_rewrite_prompt)rewritten_prompt = rewritten_prompt_response.textlogger.info(f"Enhanced prompt: {rewritten_prompt}")- model = "gemini-2.5-flash-image"+ model = "gemini-3-pro-image-preview"# Build content partscontent_parts = [types.Part.from_text(text=rewritten_prompt)]@@ -229,6 +241,7 @@ async def generate_renovation_rendering(tool_context: ToolContext, inputs: Generinline_data = chunk.candidates[0].content.parts[0].inline_data# Create a Part object from the inline data+ # The inline_data already contains the mime_type from the API responseimage_part = types.Part(inline_data=inline_data)try:@@ -247,7 +260,7 @@ async def generate_renovation_rendering(tool_context: ToolContext, inputs: Generlogger.info(f"Saved rendering as artifact '{artifact_filename}' (version {version})")- return f"β Renovation rendering generated successfully!\n\nSaved as: **{artifact_filename}** (version {version} of {inputs.asset_name})\n\nThis photorealistic rendering shows your renovated space based on the design plan."+ return f"β Renovation rendering generated successfully!\n\nThe rendering has been saved and is available in the artifacts panel. Artifact name: {inputs.asset_name} (version {version}).\n\nNote: The image is stored as an artifact and can be accessed through the session artifacts, not as a direct image link."except Exception as e:logger.error(f"Error saving artifact: {e}")@@ -282,14 +295,25 @@ async def edit_renovation_rendering(tool_context: ToolContext, inputs: EditRenovtry:client = genai.Client()- inputs = EditRenovationRenderingInput(**inputs)++ # Handle inputs that might come as dict instead of Pydantic model+ if isinstance(inputs, dict):+ inputs = EditRenovationRenderingInput(**inputs)++ # Get artifact_filename from session state if not provided+ artifact_filename = inputs.artifact_filename+ if not artifact_filename:+ artifact_filename = tool_context.state.get("last_generated_rendering")+ if not artifact_filename:+ return "β No artifact_filename provided and no previous rendering found in session. Please generate a rendering first or specify the artifact filename."+ logger.info(f"Using last generated rendering from session: {artifact_filename}")# Load the existing rendering- logger.info(f"Loading artifact: {inputs.artifact_filename}")+ logger.info(f"Loading artifact: {artifact_filename}")try:- loaded_image_part = await tool_context.load_artifact(inputs.artifact_filename)+ loaded_image_part = await tool_context.load_artifact(artifact_filename)if not loaded_image_part:- return f"β Could not find rendering artifact: {inputs.artifact_filename}"+ return f"β Could not find rendering artifact: {artifact_filename}"except Exception as e:logger.error(f"Error loading artifact: {e}")return f"Error loading rendering artifact: {e}"@@ -307,7 +331,7 @@ async def edit_renovation_rendering(tool_context: ToolContext, inputs: EditRenovif reference_image_part:logger.info(f"Using reference image for editing: {ref_filename}")- model = "gemini-2.5-flash-image"+ model = "gemini-3-pro-image-preview"# Build content partscontent_parts = [loaded_image_part, types.Part.from_text(text=inputs.prompt)]@@ -337,7 +361,7 @@ async def edit_renovation_rendering(tool_context: ToolContext, inputs: EditRenovasset_name = current_asset_nameelse:# Extract from filename- base_name = inputs.artifact_filename.split('_v')[0] if '_v' in inputs.artifact_filename else "renovation_rendering"+ base_name = artifact_filename.split('_v')[0] if '_v' in artifact_filename else "renovation_rendering"asset_name = base_nameversion = get_next_version_number(tool_context, asset_name)@@ -361,6 +385,7 @@ async def edit_renovation_rendering(tool_context: ToolContext, inputs: EditRenovinline_data = chunk.candidates[0].content.parts[0].inline_data# Create a Part object from the inline data+ # The inline_data already contains the mime_type from the API responseedited_image_part = types.Part(inline_data=inline_data)try:@@ -379,7 +404,7 @@ async def edit_renovation_rendering(tool_context: ToolContext, inputs: EditRenovlogger.info(f"Saved edited rendering as artifact '{edited_artifact_filename}' (version {version})")- return f"β Rendering edited successfully!\n\nSaved as: **{edited_artifact_filename}** (version {version} of {asset_name})\n\nThe rendering has been updated based on your feedback."+ return f"β Rendering edited successfully!\n\nThe updated rendering has been saved and is available in the artifacts panel. Artifact name: {asset_name} (version {version}).\n\nNote: The image is stored as an artifact and can be accessed through the session artifacts, not as a direct image link."except Exception as e:logger.error(f"Error saving edited artifact: {e}")