polyhaven-studio-setup · diff
git:20260921.86ed6ee to git:20260921.655a684
19 added, 87 removed. Audit A to A.
---
name: polyhaven-studio-setup
description: Set up a professional product photography studio in Blender using PolyHaven HDRIs and PBR ground materials. Trigger when asked to create a studio setup, add HDRI lighting, set up product photography, or create a showroom scene.
---
# PolyHaven Studio Setup
- Product photography studio: a PolyHaven HDRI for environment lighting and, optionally, a PBR ground plane — dramatically better reflections than manual lights.
-
- > Adapted for claude-3d-harness. The original ran a bundled Node script that opened Blender's add-on socket itself and
- > sent it Python built from command-line text. The same steps now go through the MCP server, where each one is visible
- > and asks for permission. See `docs/security-review.md`.
+ One-command product photography studio. Downloads a PolyHaven HDRI for environment lighting and optionally adds a PBR ground plane — dramatically better reflections than manual lights.
## Prerequisites
- - **Blender MCP** connected, with **PolyHaven** enabled in the add-on sidebar (`get_polyhaven_status`)
-
- ## Parameters
-
- | Parameter | Description | Default |
- |-----------|-------------|---------|
- | `hdri` | PolyHaven HDRI asset ID | `studio_small_09` |
- | `ground` | PolyHaven texture ID for the ground plane (optional) | none |
- | `resolution` | Asset resolution: 1k, 2k, 4k | `2k` |
- | `strength` | HDRI background strength | `1.0` |
- | `rotation` | HDRI rotation in degrees | `0` |
- | `ground_size` | Ground plane size | `10` |
-
- ## Flow
-
- ### Step 1: Keep the World that is already there
-
- The add-on's HDRI download rebuilds the first World in the file in place. If the scene has a World this job did not
- make, copy it first so it can be given back:
-
- ```python
- import bpy
- scene = bpy.context.scene
- if scene.world and not scene.world.name.startswith("KEEP-"):
- keep = scene.world.copy()
- keep.name = "KEEP-" + scene.world.name
- keep.use_fake_user = True # survives a save with no scene pointing at it
- print("kept:", keep.name)
- ```
-
- To undo the studio later: `scene.world = bpy.data.worlds["KEEP-<name>"]`.
-
- ### Step 2: Download and apply the HDRI
-
- `download_polyhaven_asset(asset_id=<hdri>, asset_type="hdris", resolution=<resolution>, file_format="hdr")`
-
- ### Step 3: Strength and rotation
-
- ```python
- import bpy, math
-
- STRENGTH = 1.0
- ROTATION_DEG = 0
+ - **Blender** (4.x+) with **Blender MCP addon** active on port 9876
+ - **PolyHaven** enabled in the addon sidebar
- world = bpy.context.scene.world
- if world and world.use_nodes:
- for node in world.node_tree.nodes:
- if node.type == 'BACKGROUND':
- node.inputs['Strength'].default_value = STRENGTH
- if node.type == 'MAPPING':
- node.inputs['Rotation'].default_value[2] = math.radians(ROTATION_DEG)
+ ## How to Run
- # Rendered viewport, lit by the scene world, so the HDRI is visible
- for area in bpy.context.screen.areas:
- if area.type == 'VIEW_3D':
- for space in area.spaces:
- if space.type == 'VIEW_3D':
- space.shading.type = 'RENDERED'
- space.shading.use_scene_world = True
- break
+ ```bash
+ node polyhaven-studio-setup/scripts/polyhaven-studio-setup.js --hdri studio_small_09
+ node polyhaven-studio-setup/scripts/polyhaven-studio-setup.js --hdri sunset --ground concrete_wall_003 --resolution 2k
+ node polyhaven-studio-setup/scripts/polyhaven-studio-setup.js --list-hdris
```
- ### Step 4: Ground plane (only when `ground` is given)
-
- `download_polyhaven_asset(asset_id=<ground>, asset_type="textures", resolution=<resolution>, file_format="jpg")`
- returns the name of the material it created. Use that name:
-
- ```python
- import bpy
-
- MATERIAL = "<material name the download returned>"
- GROUND_SIZE = 10
-
- bpy.ops.mesh.primitive_plane_add(size=GROUND_SIZE, location=(0, 0, -0.01))
- plane = bpy.context.active_object
- plane.name = "Studio_Ground"
-
- mat = bpy.data.materials.get(MATERIAL)
- if mat:
- plane.data.materials.append(mat)
- ```
+ ### Options
- If the texture download fails, keep the HDRI and say that the ground was skipped.
+ | Option | Description | Default |
+ |--------|-------------|---------|
+ | `--hdri` | PolyHaven HDRI asset ID | `studio_small_09` |
+ | `--ground` | PolyHaven texture ID for ground plane (optional) | none |
+ | `--resolution` | Asset resolution: 1k, 2k, 4k | `2k` |
+ | `--strength` | HDRI background strength | `1.0` |
+ | `--rotation` | HDRI rotation in degrees | `0` |
+ | `--ground-size` | Ground plane size | `10` |
+ | `--port` | Blender MCP port | `9876` |
+ | `--list-hdris` | List popular studio HDRIs | false |
## Popular Studio HDRIs
- `studio_small_09` — Clean white studio
- `studio_small_08` — Warm studio
- - `studio_small_03` — Soft studio lighting
- `photo_studio_loft_hall` — Loft photography studio
- `industrial_sunset_02_puresky` — Golden hour
- `kloppenheim_06_puresky` — Outdoor overcast
- `royal_esplanade` — Grand interior
- - `venice_sunset` — Warm sunset
- - `snowy_park_01` — Cool daylight
- - `meadow_2` — Bright outdoor