mcpField
M
muapi-floor-plan-rendering

muapi-floor-plan-rendering

github.com/samuraigptDesign & UI25673 installsUpdated 4w ago
Repository

About muapi-floor-plan-rendering

An agent-orchestrated workflow that uses muapi to turn a description or optional plan image into a 2D floor plan, then a 3D architectural rendering. It is intended for exploring residential layouts and visualizing interior concepts.

Key features

  1. 01Generate a 2D plan from text
  2. 02Accept an optional plan image
  3. 03Convert plans into 3D isometric renderings
  4. 04Present and approve work in stages

Use cases

  1. 01Turn a home layout description into a plan
  2. 02Visualize an existing 2D drawing in 3D
  3. 03Review a 2D design before rendering
  4. 04Create architectural or interior concept images

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-floor-plan-rendering

After installing, type/muapi-floor-plan-renderingin Claude Code to confirm it loaded.

Details

From the project README

Floor Plan Rendering

Design a 2D floor plan and convert it into a realistic, high-quality 3D architectural rendering.

Inputs

NameTypeRequiredDefaultDescription
floor_plan_descriptiontextyes—Description of the floor plan (e.g. "a modern 2-bedroom apartment with a balcony and open kitchen").
base_plan_imageimage_urlno—Optional 2D floor plan image to use as a starting point.

Steps

Phase A — 2D Floor Plan Design

If {{base_plan_image}} is not provided, submit the plan with ONE step to create the 2D blueprint:

  1. Floor Plan Generation — muapi image generate (model=nano-banana-2):
    • Prompt: A professional, clean 2D architectural floor plan of {{floor_plan_description}}. Top-down view, technical drawing style, white background, black lines, labeled rooms (Living Room, Kitchen, Bedroom, etc.), high contrast, minimalist design.
    • Aspect ratio: 4:3 or 1:1

Present the 2D plan to the user for approval.

Phase B — 3D Rendering

Once the 2D plan is ready, submit the plan to convert it into a realistic 3D visualization:

  1. 3D Conversion — muapi image edit (model=nano-banana-2-edit):
    • Reference Image: The 2D plan from Phase A.
    • Prompt: A stunning, realistic 3D isometric cutaway rendering of the architectural floor plan. Photorealistic textures, warm wooden flooring, modern furniture, soft natural sunlight coming from windows, realistic shadows. High-end architectural visualization, cinematic look, 8k resolution, clean white studio background.
    • Aspect ratio: 4:3 or 1:1

After generation, present the final 3D rendering to the user.

Trigger Keywords

3d floor plan, architectural rendering, 2d to 3d plan, house design, interior plan

Notes for the Executing Agent

  • This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call muapi CLI commands. Use muapi auth configure first if MUAPI_API_KEY is unset.
  • For model IDs without a CLI alias yet, fall back to the raw endpoint via curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' and poll with muapi predict wait <request_id>.
  • Substitute {{input_name}} placeholders with the user's actual inputs before issuing each call.

Comments

Markdown supported