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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.1
+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
@@ -116,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 |
@@ -155,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

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

@@ -99,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 |
@@ -138,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

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

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

{janction_render-0.4.1 → 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.1 → 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.1 → 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 "
@@ -241,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 = "",
@@ -263,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 {}))
@@ -343,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 = "",
@@ -367,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)
@@ -388,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.1 → 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.1
+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
@@ -116,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 |
@@ -155,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

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

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