janction-render 0.4.2__tar.gz → 0.4.4__tar.gz

{janction_render-0.4.2 → janction_render-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.2
+Version: 0.4.4
 Summary: Cloud GPU render farm for Blender, for AI agents: MCP server (remote + stdio) and CLI. Render Blender without a GPU from Claude, ChatGPT, Claude Code, Codex, Cursor.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -37,6 +37,12 @@ without a GPU, or when rendering locally is slow.
 - In hosts that support MCP Apps (Claude web and desktop, among others), previews, progress and download links also appear
   as an interactive panel in the chat: the image, a progress bar, "Open MP4", and preset buttons after an `environment="compare"` preview.
   Both the remote connector and the stdio package ship the panel (`janction_render/mcp_app.html`); set `JR_MCP_APPS=0` to turn it off.
+- CC0 assets by name: `asset_search("wooden table")` finds Poly Haven models, textures and HDRIs; pass `polyhaven:<id>` in
+  `asset_urls` (remote) or `assets` (stdio) and the files land in `JR_ASSETS_DIR/<id>/` on the GPU, ready to import
+  (`bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], 'wooden_table_02', 'wooden_table_02_1k.gltf'))`).
+  Scene scripts can `import jr_assets` for one-liners: `jr_assets.import_model('wooden_table_02')`,
+  `jr_assets.apply(floor, jr_assets.material('wood_floor_deck', scale=2))` (diff / normal / roughness / metal wired into a
+  Principled BSDF), `jr_assets.world_hdri('studio_small_09')`. See `samples/polyhaven_room.py`.
 - `scene_info` reads the scene without rendering (cameras, frame range, missing files).
 - `render_preview` returns 1-4 low-cost frames tiled in one image within seconds, so the agent can look, fix, and repeat.
 - `render_estimate` says how long a render will take ("about 3 minutes") and whether it fits today's free quota.
@@ -119,6 +125,7 @@ Then, in Claude Code:
 | `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?, transparent?, notify_url?)` | frames (png / exr) or video (mp4 / webm / prores / gif / webp); `transparent=True` keeps an alpha background (png / exr / webm / gif / webp); `notify_url` gets one JSON POST when the job finishes; returns job_id + estimate |
 | `render_status(job_id)` | progress and ETA (`eta.human`); `render_download(job_id, only="mp4" / "frames" / "all")` files or links; `render_cancel(job_id)` |
 | `billing()` | free-beta quota (used today, daily limit, reset time); later balance and top-up link |
+| `asset_search(query, kind)` | CC0 models / textures / HDRIs on Poly Haven by words; results carry `polyhaven:<id>` and the entry file |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
 
 Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`, `overcast`, `night`, `compare` on previews; `environment_strength`,
@@ -159,6 +166,8 @@ POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_en
                  environment, environment_strength, environment_visible, blender, orbit, orbit_frames, orbit_elevation}
 GET  /v1/jobs/{id}      status, progress, eta, artifacts[], cost, warnings, info    DELETE /v1/jobs/{id}  cancel
 GET  /v1/jobs/{id}/artifacts/{name}             PNG / MP4
+GET  /v1/assets/search?q=&kind=models|textures|hdris   CC0 assets (Poly Haven) -> spec polyhaven:<id>
+POST /v1/files/{id}/assets/urls {urls: ["https://...", "polyhaven:<id>"]}   fetch assets server-side
 POST /mcp                                       remote MCP (Streamable HTTP; Bearer api key or OAuth)
 GET  /.well-known/oauth-protected-resource/mcp  OAuth discovery
 POST /v1/billing/checkout {amount_yen} -> {checkout_url}   POST /v1/billing/sync   GET /v1/ledger   GET /v1/me

{janction_render-0.4.2 → janction_render-0.4.4}/README.md

@@ -20,6 +20,12 @@ without a GPU, or when rendering locally is slow.
 - In hosts that support MCP Apps (Claude web and desktop, among others), previews, progress and download links also appear
   as an interactive panel in the chat: the image, a progress bar, "Open MP4", and preset buttons after an `environment="compare"` preview.
   Both the remote connector and the stdio package ship the panel (`janction_render/mcp_app.html`); set `JR_MCP_APPS=0` to turn it off.
+- CC0 assets by name: `asset_search("wooden table")` finds Poly Haven models, textures and HDRIs; pass `polyhaven:<id>` in
+  `asset_urls` (remote) or `assets` (stdio) and the files land in `JR_ASSETS_DIR/<id>/` on the GPU, ready to import
+  (`bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], 'wooden_table_02', 'wooden_table_02_1k.gltf'))`).
+  Scene scripts can `import jr_assets` for one-liners: `jr_assets.import_model('wooden_table_02')`,
+  `jr_assets.apply(floor, jr_assets.material('wood_floor_deck', scale=2))` (diff / normal / roughness / metal wired into a
+  Principled BSDF), `jr_assets.world_hdri('studio_small_09')`. See `samples/polyhaven_room.py`.
 - `scene_info` reads the scene without rendering (cameras, frame range, missing files).
 - `render_preview` returns 1-4 low-cost frames tiled in one image within seconds, so the agent can look, fix, and repeat.
 - `render_estimate` says how long a render will take ("about 3 minutes") and whether it fits today's free quota.
@@ -102,6 +108,7 @@ Then, in Claude Code:
 | `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?, transparent?, notify_url?)` | frames (png / exr) or video (mp4 / webm / prores / gif / webp); `transparent=True` keeps an alpha background (png / exr / webm / gif / webp); `notify_url` gets one JSON POST when the job finishes; returns job_id + estimate |
 | `render_status(job_id)` | progress and ETA (`eta.human`); `render_download(job_id, only="mp4" / "frames" / "all")` files or links; `render_cancel(job_id)` |
 | `billing()` | free-beta quota (used today, daily limit, reset time); later balance and top-up link |
+| `asset_search(query, kind)` | CC0 models / textures / HDRIs on Poly Haven by words; results carry `polyhaven:<id>` and the entry file |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
 
 Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`, `overcast`, `night`, `compare` on previews; `environment_strength`,
@@ -142,6 +149,8 @@ POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_en
                  environment, environment_strength, environment_visible, blender, orbit, orbit_frames, orbit_elevation}
 GET  /v1/jobs/{id}      status, progress, eta, artifacts[], cost, warnings, info    DELETE /v1/jobs/{id}  cancel
 GET  /v1/jobs/{id}/artifacts/{name}             PNG / MP4
+GET  /v1/assets/search?q=&kind=models|textures|hdris   CC0 assets (Poly Haven) -> spec polyhaven:<id>
+POST /v1/files/{id}/assets/urls {urls: ["https://...", "polyhaven:<id>"]}   fetch assets server-side
 POST /mcp                                       remote MCP (Streamable HTTP; Bearer api key or OAuth)
 GET  /.well-known/oauth-protected-resource/mcp  OAuth discovery
 POST /v1/billing/checkout {amount_yen} -> {checkout_url}   POST /v1/billing/sync   GET /v1/ledger   GET /v1/me

{janction_render-0.4.2 → janction_render-0.4.4}/janction_render/__init__.py

@@ -1,3 +1,3 @@
 """JANCTION Render — ターミナルの AI エージェントから GPU で 3DCG を描く。"""
 
-__version__ = "0.4.2"
+__version__ = "0.4.4"

{janction_render-0.4.2 → janction_render-0.4.4}/janction_render/client.py

@@ -361,6 +361,20 @@ class Client:
         self._raise(r)
         return r.json()
 
+    def fetch_asset_urls(self, scene_id: str, urls: list[str]) -> dict[str, Any]:
+        """URL か polyhaven:<id> の素材を受付に取らせてシーンに足す（受付が取るので手元には要らない）。"""
+        r = self.s.post(f"{self.server}/v1/files/{scene_id}/assets/urls", headers=self._headers(),
+                        json={"urls": [str(u) for u in urls]}, timeout=900)
+        self._raise(r)
+        return r.json()
+
+    def asset_search(self, query: str, kind: str = "models") -> dict[str, Any]:
+        """Poly Haven（CC0）の素材を名前・タグで引く。"""
+        r = self.s.get(f"{self.server}/v1/assets/search", headers=self._headers(),
+                       params={"q": query, "kind": kind}, timeout=30)
+        self._raise(r)
+        return r.json()
+
     def upload_text(self, name: str, text: str) -> dict[str, Any]:
         """文字列で受け取った bpy スクリプトを、そのままシーンとして送る（ファイルを作らなくてよい）。"""
         import tempfile

{janction_render-0.4.2 → janction_render-0.4.4}/janction_render/mcp_server.py

@@ -87,6 +87,11 @@ ENV_DOC = ("environment: '' keeps the scene's own world; 'studio' | 'sunset' | '
            "blender: '' (5.0) or '5.2' to render with Blender 5.2 when available. assets: local files (images, glTF "
            ".bin, ...) sent along with the scene; a .blend finds them through relative paths, a script through "
            "os.environ['JR_ASSETS_DIR'].")
+POLYHAVEN_DOC = (" assets may also hold 'polyhaven:<id>' (a CC0 model, texture or HDRI from polyhaven.com, fetched by the "
+                 "service into JR_ASSETS_DIR/<id>/; find ids with asset_search) or an https URL. Import a model with "
+                 "bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], '<id>', '<id>_1k.gltf')). "
+                 "Inside the scene script, `import jr_assets` gives helpers: jr_assets.import_model('<id>', location=(x,y,z), scale=1.0) imports a Poly Haven model (or any file under JR_ASSETS_DIR) and returns the objects; jr_assets.material('<id>', scale=1.0) builds a Principled material from a Poly Haven texture set (diff / nor_gl / rough / arm / disp); jr_assets.apply(obj, mat) assigns it; jr_assets.world_hdri('<id>', strength=1.0) uses a Poly Haven HDRI as the world.")
+ENV_DOC = ENV_DOC + POLYHAVEN_DOC
 
 
 def _log(msg: str) -> None:
@@ -153,8 +158,28 @@ def _payment_block(exc: ClientError) -> Optional[dict[str, Any]]:
 _LAST_UPLOAD: dict[str, Any] = {}
 
 
+def _is_remote_asset(a: str) -> bool:
+    s = str(a).strip().lower()
+    return s.startswith("polyhaven:") or s.startswith("https://")
+
+
 def _resolve_scene(c: Client, scene_path: str, scene_id: str, scene_script: str = "",
                    assets: Optional[list[str]] = None) -> str:
+    """手元のファイルは upload、polyhaven:<id> と https の素材は受付に取らせる。"""
+    remote = [str(a) for a in (assets or []) if _is_remote_asset(a)]
+    local = [a for a in (assets or []) if not _is_remote_asset(a)]
+    sid = _resolve_scene_local(c, scene_path, scene_id, scene_script, local or None)
+    if remote:
+        up = c.fetch_asset_urls(sid, remote)
+        got = list(_LAST_UPLOAD.get("assets") or [])
+        _LAST_UPLOAD["assets"] = got + [x for x in (up.get("added") or []) if x not in got]
+        if up.get("polyhaven"):
+            _LAST_UPLOAD["polyhaven"] = up["polyhaven"]
+    return sid
+
+
+def _resolve_scene_local(c: Client, scene_path: str, scene_id: str, scene_script: str = "",
+                         assets: Optional[list[str]] = None) -> str:
     _LAST_UPLOAD.clear()
     if scene_id:
         if assets:
@@ -265,6 +290,20 @@ RENDER_PREVIEW_DESCRIPTION = (
 )
 
 
+@mcp.tool()
+def asset_search(query: str, kind: str = "models") -> str:
+    """Find CC0 3D models, PBR textures or HDRIs on Poly Haven by words (name, tags, category), to furnish a scene
+    without local files. kind: 'models' (default) | 'textures' | 'hdris'. Each result has spec 'polyhaven:<id>', its
+    size in metres (models) and the entry file. Then pass the spec in assets of scene_info / render_preview /
+    render_final; the service fetches the files into JR_ASSETS_DIR/<id>/ and the scene script imports the entry with
+    bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], '<entry>')). No GPU time is used."""
+    c = _client()
+    try:
+        return _j(c.asset_search(query, kind))
+    except ClientError as exc:
+        return _j({"ok": False, "error": str(exc)})
+
+
 @mcp.tool(structured_output=False, meta=_ui_meta(), description=RENDER_PREVIEW_DESCRIPTION)
 def render_preview(
     scene_path: str = "",

{janction_render-0.4.2 → janction_render-0.4.4}/janction_render.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.2
+Version: 0.4.4
 Summary: Cloud GPU render farm for Blender, for AI agents: MCP server (remote + stdio) and CLI. Render Blender without a GPU from Claude, ChatGPT, Claude Code, Codex, Cursor.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -37,6 +37,12 @@ without a GPU, or when rendering locally is slow.
 - In hosts that support MCP Apps (Claude web and desktop, among others), previews, progress and download links also appear
   as an interactive panel in the chat: the image, a progress bar, "Open MP4", and preset buttons after an `environment="compare"` preview.
   Both the remote connector and the stdio package ship the panel (`janction_render/mcp_app.html`); set `JR_MCP_APPS=0` to turn it off.
+- CC0 assets by name: `asset_search("wooden table")` finds Poly Haven models, textures and HDRIs; pass `polyhaven:<id>` in
+  `asset_urls` (remote) or `assets` (stdio) and the files land in `JR_ASSETS_DIR/<id>/` on the GPU, ready to import
+  (`bpy.ops.import_scene.gltf(filepath=os.path.join(os.environ['JR_ASSETS_DIR'], 'wooden_table_02', 'wooden_table_02_1k.gltf'))`).
+  Scene scripts can `import jr_assets` for one-liners: `jr_assets.import_model('wooden_table_02')`,
+  `jr_assets.apply(floor, jr_assets.material('wood_floor_deck', scale=2))` (diff / normal / roughness / metal wired into a
+  Principled BSDF), `jr_assets.world_hdri('studio_small_09')`. See `samples/polyhaven_room.py`.
 - `scene_info` reads the scene without rendering (cameras, frame range, missing files).
 - `render_preview` returns 1-4 low-cost frames tiled in one image within seconds, so the agent can look, fix, and repeat.
 - `render_estimate` says how long a render will take ("about 3 minutes") and whether it fits today's free quota.
@@ -119,6 +125,7 @@ Then, in Claude Code:
 | `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?, transparent?, notify_url?)` | frames (png / exr) or video (mp4 / webm / prores / gif / webp); `transparent=True` keeps an alpha background (png / exr / webm / gif / webp); `notify_url` gets one JSON POST when the job finishes; returns job_id + estimate |
 | `render_status(job_id)` | progress and ETA (`eta.human`); `render_download(job_id, only="mp4" / "frames" / "all")` files or links; `render_cancel(job_id)` |
 | `billing()` | free-beta quota (used today, daily limit, reset time); later balance and top-up link |
+| `asset_search(query, kind)` | CC0 models / textures / HDRIs on Poly Haven by words; results carry `polyhaven:<id>` and the entry file |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
 
 Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`, `overcast`, `night`, `compare` on previews; `environment_strength`,
@@ -159,6 +166,8 @@ POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_en
                  environment, environment_strength, environment_visible, blender, orbit, orbit_frames, orbit_elevation}
 GET  /v1/jobs/{id}      status, progress, eta, artifacts[], cost, warnings, info    DELETE /v1/jobs/{id}  cancel
 GET  /v1/jobs/{id}/artifacts/{name}             PNG / MP4
+GET  /v1/assets/search?q=&kind=models|textures|hdris   CC0 assets (Poly Haven) -> spec polyhaven:<id>
+POST /v1/files/{id}/assets/urls {urls: ["https://...", "polyhaven:<id>"]}   fetch assets server-side
 POST /mcp                                       remote MCP (Streamable HTTP; Bearer api key or OAuth)
 GET  /.well-known/oauth-protected-resource/mcp  OAuth discovery
 POST /v1/billing/checkout {amount_yen} -> {checkout_url}   POST /v1/billing/sync   GET /v1/ledger   GET /v1/me

{janction_render-0.4.2 → janction_render-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "janction-render"
-version = "0.4.2"
+version = "0.4.4"
 description = "Cloud GPU render farm for Blender, for AI agents: MCP server (remote + stdio) and CLI. Render Blender without a GPU from Claude, ChatGPT, Claude Code, Codex, Cursor."
 readme = "README.md"
 requires-python = ">=3.11"