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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.0
+Version: 0.4.2
 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
@@ -31,7 +31,8 @@ without a GPU, or when rendering locally is slow.
 - `orbit=True` turns any scene or imported model into a turntable: an orbit camera circles it once (`orbit_frames`, default 24;
   a preview shows 0/90/180/270 degrees, a final render without `frame_end` gives the whole turn as an MP4). Flat floors and
   walls are ignored when framing; `orbit_target` (object name or `x,y,z`) and `orbit_distance` (multiplier) adjust the shot.
-- While the GPU is lent to another workload, tools answer right away with the queued job and a note instead of waiting.
+- While the GPU is lent to another workload, tools answer right away with the queued job and a wait estimate (how long it
+  has been out, how long it usually stays out, how much longer to expect; `eta.gate`) instead of waiting.
 - While a job renders, `render_status` counts finished frames inside the running chunk, so the ETA updates every few seconds.
 - 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.
@@ -51,7 +52,8 @@ Free beta. Service page: `https://render.janction.jp` (`/v1/health`, `/llms.txt`
 Guides: [render farm for agents](https://render.janction.jp/blender-render-farm) · [without a GPU](https://render.janction.jp/render-blender-without-gpu) ·
 [Claude](https://render.janction.jp/claude-blender) · [ChatGPT](https://render.janction.jp/chatgpt-blender) · [Claude Code](https://render.janction.jp/claude-code-blender) ·
 [Codex](https://render.janction.jp/codex-blender) · [bpy scripts](https://render.janction.jp/bpy-script-cloud-gpu) · [API](https://render.janction.jp/blender-render-api) ·
-[comparison](https://render.janction.jp/blender-render-farm-api-comparison) · 日本語は `/ja/`
+[comparison](https://render.janction.jp/blender-render-farm-api-comparison) · [Blender add-on](https://render.janction.jp/blender-addon) ·
+[Maya / Houdini / Cinema 4D](https://render.janction.jp/maya-houdini-cinema4d) · 日本語は `/ja/`
 
 ## Connect (remote MCP, nothing to install)
 
@@ -114,7 +116,7 @@ Then, in Claude Code:
 | `scene_info(scene_script | scene_url | scene_path | scene_id, assets?)` | cameras, frame range, fps, resolution, objects, lights, missing files. No render. |
 | `render_preview(..., frames="1-24", environment?, blender?)` | up to 4 frames (720p budget) tiled with frame labels; returns the image inline |
 | `render_estimate(scene_id, frame_start, frame_end, width, height, samples)` | GPU seconds, queue wait, "about N minutes", fits today's free quota? No GPU time used |
-| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?)` | frames (png / exr) or video (mp4 / webm / prores); returns job_id + estimate |
+| `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 |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
@@ -153,7 +155,7 @@ POST /v1/keys                                   -> {api_key}         (header X-A
 POST /v1/files  multipart "file" (.blend|.py|.glb|.fbx|.usd|.obj|...)   -> {scene_id}
 POST /v1/files/{id}/assets  multipart "files"   textures, glTF .bin ...   GET /v1/files/lookup?sha256=  reuse an upload
 POST /v1/estimate {kind, frames|frame_start/frame_end, width, height, samples, scene_id?} -> seconds, wall_seconds, human, quota
-POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores), engine (cycles|eevee),
+POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores|gif|webp), transparent, notify_url (https), engine (cycles|eevee),
                  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
@@ -166,11 +168,24 @@ GET  /llms.txt  /llms-full.txt  /ja/llms.txt  /faq  /terms  /privacy  /legal  /s
 During the free beta a `429 quota_exceeded` response carries `resets_at`; a `400 beta_limit` means the job is too big
 (split it). Once paid plans start, a `402 payment_required` response carries `checkout_url`.
 
+## Blender add-on and DCC tools (for people, not agents)
+
+- **Blender extension** (`addons/blender/`, Blender 4.2+): a JANCTION Render panel under Properties → Render with Preview,
+  Estimate and Final. A copy of the open file and the textures it references with relative paths are uploaded; results land
+  next to the .blend. Install from the extension repository `https://render.janction.jp/extensions/index.json`
+  (Preferences → Get Extensions → Repositories → + → Add Remote Repository), or install the zip from
+  `https://render.janction.jp/extensions/janction_render-0.1.0.zip` (`python scripts/build_blender_addon.py` builds it
+  from this repository). Guide: https://render.janction.jp/blender-addon
+- **Maya, Houdini, Cinema 4D** (`integrations/`): export to USD / FBX / Alembic, upload with textures, render with Cycles,
+  open the result; Preview, Final (MP4) and Turntable. Standard-library Python only; `jr_submit.py` is the shared client.
+  Guide: https://render.janction.jp/maya-houdini-cinema4d
+
 ## Self-hosting
 
 The server (FastAPI + SQLite, with the remote MCP endpoint) and the worker (Blender in disposable Docker containers,
 `--network none --cap-drop ALL`) live in the internal repository and are not part of this package yet. This repository
-holds the client side: stdio MCP server, CLI, HTTP client, samples and the Claude Code plugin.
+holds the client side: stdio MCP server, CLI, HTTP client, samples, the Claude Code plugin, the Blender add-on and the
+DCC tools.
 
 ## MCP registry
 
@@ -180,4 +195,5 @@ mcp-name: io.github.JasmyLab-JANCTION/janction-render
 
 ## License
 
-MIT (see LICENSE). Operated by JasmyLab Inc.
+MIT (see LICENSE) for the package, the MCP servers, the CLI and the DCC tools. The Blender extension under
+`addons/blender/` is GPL-3.0-or-later, as Blender requires for add-ons. Operated by JasmyLab Inc.

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

@@ -14,7 +14,8 @@ without a GPU, or when rendering locally is slow.
 - `orbit=True` turns any scene or imported model into a turntable: an orbit camera circles it once (`orbit_frames`, default 24;
   a preview shows 0/90/180/270 degrees, a final render without `frame_end` gives the whole turn as an MP4). Flat floors and
   walls are ignored when framing; `orbit_target` (object name or `x,y,z`) and `orbit_distance` (multiplier) adjust the shot.
-- While the GPU is lent to another workload, tools answer right away with the queued job and a note instead of waiting.
+- While the GPU is lent to another workload, tools answer right away with the queued job and a wait estimate (how long it
+  has been out, how long it usually stays out, how much longer to expect; `eta.gate`) instead of waiting.
 - While a job renders, `render_status` counts finished frames inside the running chunk, so the ETA updates every few seconds.
 - 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.
@@ -34,7 +35,8 @@ Free beta. Service page: `https://render.janction.jp` (`/v1/health`, `/llms.txt`
 Guides: [render farm for agents](https://render.janction.jp/blender-render-farm) · [without a GPU](https://render.janction.jp/render-blender-without-gpu) ·
 [Claude](https://render.janction.jp/claude-blender) · [ChatGPT](https://render.janction.jp/chatgpt-blender) · [Claude Code](https://render.janction.jp/claude-code-blender) ·
 [Codex](https://render.janction.jp/codex-blender) · [bpy scripts](https://render.janction.jp/bpy-script-cloud-gpu) · [API](https://render.janction.jp/blender-render-api) ·
-[comparison](https://render.janction.jp/blender-render-farm-api-comparison) · 日本語は `/ja/`
+[comparison](https://render.janction.jp/blender-render-farm-api-comparison) · [Blender add-on](https://render.janction.jp/blender-addon) ·
+[Maya / Houdini / Cinema 4D](https://render.janction.jp/maya-houdini-cinema4d) · 日本語は `/ja/`
 
 ## Connect (remote MCP, nothing to install)
 
@@ -97,7 +99,7 @@ Then, in Claude Code:
 | `scene_info(scene_script | scene_url | scene_path | scene_id, assets?)` | cameras, frame range, fps, resolution, objects, lights, missing files. No render. |
 | `render_preview(..., frames="1-24", environment?, blender?)` | up to 4 frames (720p budget) tiled with frame labels; returns the image inline |
 | `render_estimate(scene_id, frame_start, frame_end, width, height, samples)` | GPU seconds, queue wait, "about N minutes", fits today's free quota? No GPU time used |
-| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?)` | frames (png / exr) or video (mp4 / webm / prores); returns job_id + estimate |
+| `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 |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
@@ -136,7 +138,7 @@ POST /v1/keys                                   -> {api_key}         (header X-A
 POST /v1/files  multipart "file" (.blend|.py|.glb|.fbx|.usd|.obj|...)   -> {scene_id}
 POST /v1/files/{id}/assets  multipart "files"   textures, glTF .bin ...   GET /v1/files/lookup?sha256=  reuse an upload
 POST /v1/estimate {kind, frames|frame_start/frame_end, width, height, samples, scene_id?} -> seconds, wall_seconds, human, quota
-POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores), engine (cycles|eevee),
+POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores|gif|webp), transparent, notify_url (https), engine (cycles|eevee),
                  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
@@ -149,11 +151,24 @@ GET  /llms.txt  /llms-full.txt  /ja/llms.txt  /faq  /terms  /privacy  /legal  /s
 During the free beta a `429 quota_exceeded` response carries `resets_at`; a `400 beta_limit` means the job is too big
 (split it). Once paid plans start, a `402 payment_required` response carries `checkout_url`.
 
+## Blender add-on and DCC tools (for people, not agents)
+
+- **Blender extension** (`addons/blender/`, Blender 4.2+): a JANCTION Render panel under Properties → Render with Preview,
+  Estimate and Final. A copy of the open file and the textures it references with relative paths are uploaded; results land
+  next to the .blend. Install from the extension repository `https://render.janction.jp/extensions/index.json`
+  (Preferences → Get Extensions → Repositories → + → Add Remote Repository), or install the zip from
+  `https://render.janction.jp/extensions/janction_render-0.1.0.zip` (`python scripts/build_blender_addon.py` builds it
+  from this repository). Guide: https://render.janction.jp/blender-addon
+- **Maya, Houdini, Cinema 4D** (`integrations/`): export to USD / FBX / Alembic, upload with textures, render with Cycles,
+  open the result; Preview, Final (MP4) and Turntable. Standard-library Python only; `jr_submit.py` is the shared client.
+  Guide: https://render.janction.jp/maya-houdini-cinema4d
+
 ## Self-hosting
 
 The server (FastAPI + SQLite, with the remote MCP endpoint) and the worker (Blender in disposable Docker containers,
 `--network none --cap-drop ALL`) live in the internal repository and are not part of this package yet. This repository
-holds the client side: stdio MCP server, CLI, HTTP client, samples and the Claude Code plugin.
+holds the client side: stdio MCP server, CLI, HTTP client, samples, the Claude Code plugin, the Blender add-on and the
+DCC tools.
 
 ## MCP registry
 
@@ -163,4 +178,5 @@ mcp-name: io.github.JasmyLab-JANCTION/janction-render
 
 ## License
 
-MIT (see LICENSE). Operated by JasmyLab Inc.
+MIT (see LICENSE) for the package, the MCP servers, the CLI and the DCC tools. The Blender extension under
+`addons/blender/` is GPL-3.0-or-later, as Blender requires for add-ons. Operated by JasmyLab Inc.

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

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

{janction_render-0.4.0 → janction_render-0.4.2}/janction_render/brief.py

@@ -8,7 +8,7 @@ JST = 9 * 3600
 
 
 def iso(ts: float | int | None) -> str | None:
-    """epoch 秒 → "2026-10-02T04:12:00Z (2026-10-02 13:12 JST)"。エージェントがそのまま伝えられる形。"""
+    """epoch 秒 → "2026-10-01T04:12:00Z (2026-10-01 13:12 JST)"。エージェントがそのまま伝えられる形。"""
     if ts is None:
         return None
     try:
@@ -34,7 +34,7 @@ def eta_brief(e: dict[str, Any] | None) -> dict[str, Any] | None:
     if not e:
         return None
     keep = ("human", "remaining_seconds", "queue_wait_seconds", "remaining_gpu_seconds", "elapsed_seconds",
-            "running_for_seconds", "took_seconds", "workers_online", "basis")
+            "running_for_seconds", "took_seconds", "workers_online", "basis", "gate")
     return {k: e[k] for k in keep if e.get(k) is not None}
 
 
@@ -42,7 +42,7 @@ def estimate_brief(e: dict[str, Any] | None) -> dict[str, Any] | None:
     if not e:
         return None
     keep = ("human", "seconds", "wall_seconds", "queue_wait_seconds", "per_frame_seconds", "frames", "chunks",
-            "workers_online", "basis", "basis_note", "note", "quota", "cost")
+            "workers_online", "basis", "basis_note", "note", "quota", "cost", "gate")
     return {k: e[k] for k in keep if e.get(k) is not None}
 
 

{janction_render-0.4.0 → janction_render-0.4.2}/janction_render/cli.py

@@ -98,7 +98,8 @@ def cmd_render(c: Client, args: argparse.Namespace) -> int:
     w, h = args.size
     fs, fe = args.frames
     j = c.submit(sid, kind="final", frame_start=fs, frame_end=fe, width=w, height=h,
-                 samples=args.samples, fps=args.fps, output=args.output, camera=args.camera, engine=args.engine)
+                 samples=args.samples, fps=args.fps, output=args.output, camera=args.camera, engine=args.engine,
+                 transparent=args.transparent or None, notify_url=args.notify_url or None)
     print(f"job {j['job_id']} queued: {fe - fs + 1} frames in {j['progress']['chunks_total']} chunks, "
           f"estimate ~{j['estimate']['seconds']}s", file=sys.stderr)
     if not args.wait:
@@ -200,8 +201,10 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--samples", type=int, default=128)
     s.add_argument("--engine", choices=["cycles", "eevee"], default=None, help="cycles (default) or eevee (cheaper drafts)")
     s.add_argument("--fps", type=int, default=24)
-    s.add_argument("--output", choices=["auto", "png", "exr", "mp4", "webm", "prores"], default="auto",
-                   help="png/exr = frames, mp4/webm/prores = video (auto: mp4 for a range, png for one frame)")
+    s.add_argument("--output", choices=["auto", "png", "exr", "mp4", "webm", "prores", "gif", "webp"], default="auto",
+                   help="png/exr = frames, mp4/webm/prores/gif/webp = video (auto: mp4 for a range, png for one frame)")
+    s.add_argument("--transparent", action="store_true", help="transparent background (png/exr/webm/gif/webp)")
+    s.add_argument("--notify-url", default=None, help="https URL that receives one JSON POST when the job finishes")
     s.add_argument("--camera", default=None)
     s.add_argument("--out", default=None)
     s.add_argument("--wait", action="store_true", help="wait until done and download")

{janction_render-0.4.0 → janction_render-0.4.2}/janction_render/mcp_app.html

@@ -92,6 +92,8 @@ function render() {
   const links = job.links || {};
   if (status === "done" && out && /\.(mp4|webm|mov)(\?|$)/.test(out)) {
     html += `<video controls playsinline src="${esc(out)}"></video>`;
+  } else if (status === "done" && out && /\.(gif|webp)(\?|$)/.test(out)) {
+    html += `<img class="sheet" src="${esc(out)}" alt="animation">`;
   }
   if (status === "done" && isCompare(job)) {
     html += `<div class="muted">Pick the lighting for the final render:</div><div class="grid">` +

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

@@ -52,6 +52,13 @@ mcp = MCPServer(
     ),
 )
 
+OUTPUT_DOC = (" output: 'auto' (mp4 for a frame range, png for one frame) | 'png' | 'exr' (16-bit linear OpenEXR frames) | "
+              "'mp4' (H.264) | 'webm' (VP9) | 'prores' (ProRes 422 HQ .mov) | 'gif' | 'webp' (animated, at most 960 px wide; "
+              "good for chat and web). transparent=True renders on a transparent background (alpha): png / exr frames, webm, gif "
+              "and webp keep it, mp4 and prores cannot. notify_url: an https URL that receives one JSON POST when the job "
+              "finishes (event job.done / job.failed, artifacts with download links).")
+TRANSPARENT_DOC = (" transparent=True: transparent background (alpha) instead of the world/HDRI backdrop; the preview sheet "
+                   "shows it over dark grey.")
 ORBIT_DOC = (" orbit=True: turntable; an orbit camera circles the scene once over orbit_frames frames (default 24, "
              "elevation orbit_elevation deg, default 18). Flat floors/walls are ignored when framing; orbit_target = an "
              "object name or 'x,y,z' centres on that, orbit_distance scales the distance (1.0). A preview without frames "
@@ -110,8 +117,10 @@ def _wait_unless_gated(c: Client, job: dict[str, Any], timeout: float) -> dict[s
 
 def _gated_hint(j: dict[str, Any], again: str) -> str:
     if j.get("gated"):
-        return (f"the GPU is lent to another workload right now; the job stays queued and starts when the GPU returns. "
-                f"Tell the user and offer to check later with {again}; do not poll continuously")
+        # 受付の eta.human に「閉じてからの経過・ふだん戻るまでの時間・あと何分」が入っている
+        why = str((j.get("eta") or {}).get("human") or "the GPU is lent to another workload right now; the job stays queued and starts when the GPU returns")
+        return (f"{why}. Tell the user how long the wait is likely to be and offer to check later with {again}; "
+                "do not poll continuously")
     return ""
 
 
@@ -239,7 +248,24 @@ def scene_info(scene_path: str = "", scene_id: str = "", scene_script: str = "",
     return _j(_attach_upload_notes(info))
 
 
-@mcp.tool(structured_output=False, meta=_ui_meta())
+RENDER_PREVIEW_DESCRIPTION = (
+    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image.
+
+    Use this when the user is making 3DCG with Blender and wants to see how it looks, but has no
+    GPU or local rendering is slow. Give the scene as scene_path (a .blend file OR a bpy Python
+    script), scene_script (bpy code as text; no file and no local Blender needed), or scene_id
+    from a previous call. frames: '' = frame 1;
+    '12' = one frame; '1,8,16,24' or '1-24' = up to 4 frames tiled in ONE image (2x2, each tile
+    labeled with its frame number) so you can judge camera motion and animation. Same GPU cost as
+    one 720p frame. Quality is deliberately low (up to 1280x720, few samples, denoised).
+    Look at the returned image, fix the scene, preview again; when it looks right, ask the user and
+    call render_final. Returns scene_id (reuse it without re-uploading), job_id, saved PNG paths,
+    Blender warnings (e.g. missing textures), GPU seconds, and the expiry time (24h after last use).
+    """ + ENV_DOC + ORBIT_DOC + TRANSPARENT_DOC
+)
+
+
+@mcp.tool(structured_output=False, meta=_ui_meta(), description=RENDER_PREVIEW_DESCRIPTION)
 def render_preview(
     scene_path: str = "",
     scene_id: str = "",
@@ -261,26 +287,15 @@ def render_preview(
     orbit_target: str = "",
     orbit_distance: float = 1.0,
     engine: str = "",
+    transparent: bool = False,
 ) -> list[Any]:
-    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image.
-
-    Use this when the user is making 3DCG with Blender and wants to see how it looks, but has no
-    GPU or local rendering is slow. Give the scene as scene_path (a .blend file OR a bpy Python
-    script), scene_script (bpy code as text; no file and no local Blender needed), or scene_id
-    from a previous call. frames: '' = frame 1;
-    '12' = one frame; '1,8,16,24' or '1-24' = up to 4 frames tiled in ONE image (2x2, each tile
-    labeled with its frame number) so you can judge camera motion and animation. Same GPU cost as
-    one 720p frame. Quality is deliberately low (up to 1280x720, few samples, denoised).
-    Look at the returned image, fix the scene, preview again; when it looks right, ask the user and
-    call render_final. Returns scene_id (reuse it without re-uploading), job_id, saved PNG paths,
-    Blender warnings (e.g. missing textures), GPU seconds, and the expiry time (24h after last use).
-    """ + ENV_DOC + ORBIT_DOC
+    """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image. (full description on the tool)."""
     c = _client()
     try:
         frame_list = parse_frames(frames) if (frames or not orbit) else None
         sid = _resolve_scene(c, scene_path, scene_id, scene_script, assets)
         j = c.submit(sid, kind="preview", frames=frame_list, camera=camera or None,
-                     width=width, height=height, samples=samples,
+                     width=width, height=height, samples=samples, transparent=(True if transparent else None),
                      **_job_params(environment, environment_strength, environment_visible, blender, engine=engine),
                      **({"orbit": True, "orbit_frames": orbit_frames, "orbit_elevation": orbit_elevation,
                          "orbit_target": orbit_target, "orbit_distance": orbit_distance} if orbit else {}))
@@ -341,7 +356,20 @@ def render_estimate(scene_id: str = "", kind: str = "final", frame_start: int =
     return _j(out)
 
 
-@mcp.tool(meta=_ui_meta())
+RENDER_FINAL_DESCRIPTION = (
+    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs.
+
+    Call this after the user approved a preview. Pass scene_id from render_preview (or scene_path /
+    scene_script to upload a new .blend / bpy script / 3D file). frame_start..frame_end are inclusive; several frames are
+    split across GPUs and joined into output.mp4 (output='mp4', fps), a single frame gives a PNG
+    (output='png'; 'auto' picks). Use the same environment / blender as the approved preview. Returns job_id and a
+    time estimate right away; the render runs in the background: poll with render_status, then fetch with
+    render_download. Inputs and results are deleted 24 hours after last use, so download them.
+    """ + ENV_DOC + ORBIT_DOC + OUTPUT_DOC
+)
+
+
+@mcp.tool(meta=_ui_meta(), description=RENDER_FINAL_DESCRIPTION)
 def render_final(
     scene_path: str = "",
     scene_id: str = "",
@@ -365,16 +393,10 @@ def render_final(
     orbit_target: str = "",
     orbit_distance: float = 1.0,
     engine: str = "",
+    transparent: bool = False,
+    notify_url: str = "",
 ) -> str:
-    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs.
-
-    Call this after the user approved a preview. Pass scene_id from render_preview (or scene_path /
-    scene_script to upload a new .blend / bpy script / 3D file). frame_start..frame_end are inclusive; several frames are
-    split across GPUs and joined into output.mp4 (output='mp4', fps), a single frame gives a PNG
-    (output='png'; 'auto' picks). Use the same environment / blender as the approved preview. Returns job_id and a
-    time estimate right away; the render runs in the background: poll with render_status, then fetch with
-    render_download. Inputs and results are deleted 24 hours after last use, so download them.
-    """ + ENV_DOC + ORBIT_DOC
+    """Render the final frames (or a video) of a Blender scene on JANCTION GPUs. (full description on the tool)."""
     c = _client()
     try:
         sid = _resolve_scene(c, scene_path, scene_id, scene_script, assets)
@@ -386,7 +408,7 @@ def render_final(
                 frame_end = None  # type: ignore[assignment]  # 1 周ぶんは受付が決める
         j = c.submit(sid, kind="final", frame_start=frame_start, frame_end=frame_end,
                      width=width, height=height, samples=samples, fps=fps, output=output,
-                     camera=camera or None,
+                     camera=camera or None, transparent=(True if transparent else None), notify_url=notify_url or None,
                      **_job_params(environment, environment_strength, environment_visible, blender, engine=engine), **extra)
     except ClientError as exc:
         block = _payment_block(exc) or _quota_block(exc)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.0
+Version: 0.4.2
 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
@@ -31,7 +31,8 @@ without a GPU, or when rendering locally is slow.
 - `orbit=True` turns any scene or imported model into a turntable: an orbit camera circles it once (`orbit_frames`, default 24;
   a preview shows 0/90/180/270 degrees, a final render without `frame_end` gives the whole turn as an MP4). Flat floors and
   walls are ignored when framing; `orbit_target` (object name or `x,y,z`) and `orbit_distance` (multiplier) adjust the shot.
-- While the GPU is lent to another workload, tools answer right away with the queued job and a note instead of waiting.
+- While the GPU is lent to another workload, tools answer right away with the queued job and a wait estimate (how long it
+  has been out, how long it usually stays out, how much longer to expect; `eta.gate`) instead of waiting.
 - While a job renders, `render_status` counts finished frames inside the running chunk, so the ETA updates every few seconds.
 - 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.
@@ -51,7 +52,8 @@ Free beta. Service page: `https://render.janction.jp` (`/v1/health`, `/llms.txt`
 Guides: [render farm for agents](https://render.janction.jp/blender-render-farm) · [without a GPU](https://render.janction.jp/render-blender-without-gpu) ·
 [Claude](https://render.janction.jp/claude-blender) · [ChatGPT](https://render.janction.jp/chatgpt-blender) · [Claude Code](https://render.janction.jp/claude-code-blender) ·
 [Codex](https://render.janction.jp/codex-blender) · [bpy scripts](https://render.janction.jp/bpy-script-cloud-gpu) · [API](https://render.janction.jp/blender-render-api) ·
-[comparison](https://render.janction.jp/blender-render-farm-api-comparison) · 日本語は `/ja/`
+[comparison](https://render.janction.jp/blender-render-farm-api-comparison) · [Blender add-on](https://render.janction.jp/blender-addon) ·
+[Maya / Houdini / Cinema 4D](https://render.janction.jp/maya-houdini-cinema4d) · 日本語は `/ja/`
 
 ## Connect (remote MCP, nothing to install)
 
@@ -114,7 +116,7 @@ Then, in Claude Code:
 | `scene_info(scene_script | scene_url | scene_path | scene_id, assets?)` | cameras, frame range, fps, resolution, objects, lights, missing files. No render. |
 | `render_preview(..., frames="1-24", environment?, blender?)` | up to 4 frames (720p budget) tiled with frame labels; returns the image inline |
 | `render_estimate(scene_id, frame_start, frame_end, width, height, samples)` | GPU seconds, queue wait, "about N minutes", fits today's free quota? No GPU time used |
-| `render_final(scene_id, frame_start, frame_end, width, height, samples, fps, output, environment?, blender?, engine?)` | frames (png / exr) or video (mp4 / webm / prores); returns job_id + estimate |
+| `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 |
 | `render_info()` | workers online or gated (GPU lent to another workload), queue, expected wait, supported inputs, environment presets, Blender versions |
@@ -153,7 +155,7 @@ POST /v1/keys                                   -> {api_key}         (header X-A
 POST /v1/files  multipart "file" (.blend|.py|.glb|.fbx|.usd|.obj|...)   -> {scene_id}
 POST /v1/files/{id}/assets  multipart "files"   textures, glTF .bin ...   GET /v1/files/lookup?sha256=  reuse an upload
 POST /v1/estimate {kind, frames|frame_start/frame_end, width, height, samples, scene_id?} -> seconds, wall_seconds, human, quota
-POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores), engine (cycles|eevee),
+POST /v1/jobs   {scene_id, kind: info|preview|final, frames|frame_start/frame_end, width, height, samples, camera, fps, output (png|exr|mp4|webm|prores|gif|webp), transparent, notify_url (https), engine (cycles|eevee),
                  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
@@ -166,11 +168,24 @@ GET  /llms.txt  /llms-full.txt  /ja/llms.txt  /faq  /terms  /privacy  /legal  /s
 During the free beta a `429 quota_exceeded` response carries `resets_at`; a `400 beta_limit` means the job is too big
 (split it). Once paid plans start, a `402 payment_required` response carries `checkout_url`.
 
+## Blender add-on and DCC tools (for people, not agents)
+
+- **Blender extension** (`addons/blender/`, Blender 4.2+): a JANCTION Render panel under Properties → Render with Preview,
+  Estimate and Final. A copy of the open file and the textures it references with relative paths are uploaded; results land
+  next to the .blend. Install from the extension repository `https://render.janction.jp/extensions/index.json`
+  (Preferences → Get Extensions → Repositories → + → Add Remote Repository), or install the zip from
+  `https://render.janction.jp/extensions/janction_render-0.1.0.zip` (`python scripts/build_blender_addon.py` builds it
+  from this repository). Guide: https://render.janction.jp/blender-addon
+- **Maya, Houdini, Cinema 4D** (`integrations/`): export to USD / FBX / Alembic, upload with textures, render with Cycles,
+  open the result; Preview, Final (MP4) and Turntable. Standard-library Python only; `jr_submit.py` is the shared client.
+  Guide: https://render.janction.jp/maya-houdini-cinema4d
+
 ## Self-hosting
 
 The server (FastAPI + SQLite, with the remote MCP endpoint) and the worker (Blender in disposable Docker containers,
 `--network none --cap-drop ALL`) live in the internal repository and are not part of this package yet. This repository
-holds the client side: stdio MCP server, CLI, HTTP client, samples and the Claude Code plugin.
+holds the client side: stdio MCP server, CLI, HTTP client, samples, the Claude Code plugin, the Blender add-on and the
+DCC tools.
 
 ## MCP registry
 
@@ -180,4 +195,5 @@ mcp-name: io.github.JasmyLab-JANCTION/janction-render
 
 ## License
 
-MIT (see LICENSE). Operated by JasmyLab Inc.
+MIT (see LICENSE) for the package, the MCP servers, the CLI and the DCC tools. The Blender extension under
+`addons/blender/` is GPL-3.0-or-later, as Blender requires for add-ons. Operated by JasmyLab Inc.

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "janction-render"
-version = "0.4.0"
+version = "0.4.2"
 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"