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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.3.3
+Version: 0.4.0
 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
@@ -35,6 +35,7 @@ without a GPU, or when rendering locally is slow.
 - 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.
+  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.
 - `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.
@@ -113,7 +114,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?)` | PNG or MP4; returns job_id + estimate |
+| `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_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 |
@@ -142,7 +143,7 @@ sun = bpy.data.objects.new("Sun", bpy.data.lights.new("Sun", "SUN"))
 scene.collection.objects.link(sun)
 ```
 
-The service sets engine (Cycles), resolution, samples and denoising; your script sets the scene, camera and frame range.
+The service sets the engine (Cycles by default; `engine="eevee"` for cheaper animations: about half the per-frame cost after ~7 s of shader compilation per job), resolution, samples and denoising; your script sets the scene, camera and frame range. In Blender 5.0 materials always use nodes: set the Principled BSDF Base Color, not `diffuse_color`.
 Scripts run in an isolated container with no network. See `samples/cube_scene.py`.
 
 ## HTTP API
@@ -152,7 +153,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,
+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),
                  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.3.3 → janction_render-0.4.0}/README.md

@@ -18,6 +18,7 @@ without a GPU, or when rendering locally is slow.
 - 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.
+  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.
 - `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.
@@ -96,7 +97,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?)` | PNG or MP4; returns job_id + estimate |
+| `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_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 |
@@ -125,7 +126,7 @@ sun = bpy.data.objects.new("Sun", bpy.data.lights.new("Sun", "SUN"))
 scene.collection.objects.link(sun)
 ```
 
-The service sets engine (Cycles), resolution, samples and denoising; your script sets the scene, camera and frame range.
+The service sets the engine (Cycles by default; `engine="eevee"` for cheaper animations: about half the per-frame cost after ~7 s of shader compilation per job), resolution, samples and denoising; your script sets the scene, camera and frame range. In Blender 5.0 materials always use nodes: set the Principled BSDF Base Color, not `diffuse_color`.
 Scripts run in an isolated container with no network. See `samples/cube_scene.py`.
 
 ## HTTP API
@@ -135,7 +136,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,
+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),
                  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.3.3 → janction_render-0.4.0}/janction_render/__init__.py

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

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

@@ -79,7 +79,7 @@ def cmd_preview(c: Client, args: argparse.Namespace) -> int:
     w, h = args.size
     frames = parse_frames(args.frames, default=args.frame)
     j = c.submit(sid, kind="preview", frames=frames, camera=args.camera, width=w, height=h,
-                 samples=args.samples)
+                 samples=args.samples, engine=args.engine)
     print(f"job {j['job_id']} queued: frames {frames} (estimate ~{j['estimate']['seconds']}s)", file=sys.stderr)
     j = c.wait(j["job_id"], timeout=args.timeout, on_progress=_progress)
     if j["status"] != "done":
@@ -98,7 +98,7 @@ 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)
+                 samples=args.samples, fps=args.fps, output=args.output, camera=args.camera, engine=args.engine)
     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:
@@ -187,6 +187,7 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--camera", default=None)
     s.add_argument("--size", type=_size, default=(1280, 720))
     s.add_argument("--samples", type=int, default=16)
+    s.add_argument("--engine", choices=["cycles", "eevee"], default=None, help="cycles (default) or eevee (cheaper drafts)")
     s.add_argument("--out", default=None)
     s.add_argument("--timeout", type=float, default=300)
     s.set_defaults(fn=cmd_preview)
@@ -197,8 +198,10 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--frames", type=_frames, required=True, help="e.g. 1-240 or 12")
     s.add_argument("--size", type=_size, default=(1920, 1080))
     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", "mp4"], default="auto")
+    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("--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.3.3 → janction_render-0.4.0}/janction_render/client.py

@@ -19,7 +19,7 @@ CACHE = Path.home() / ".janction-render.json"
 
 # 送れるシーン: .blend、bpy スクリプト、こちらの Blender が読み込める 3D ファイル
 SCENE_SUFFIXES = (".blend", ".py", ".fbx", ".glb", ".gltf", ".obj", ".stl", ".ply", ".usd", ".usda", ".usdc", ".usdz", ".abc")
-ONLY_CHOICES = ("all", "mp4", "frames", "sheet", "output")
+ONLY_CHOICES = ("all", "mp4", "frames", "sheet", "output", "video")
 
 
 def select_artifacts(artifacts: list[dict[str, Any]], only: Optional[str] = None) -> list[dict[str, Any]]:
@@ -27,14 +27,14 @@ def select_artifacts(artifacts: list[dict[str, Any]], only: Optional[str] = None
     o = (only or "all").strip().lower()
     if o in ("", "all"):
         return list(artifacts)
-    if o == "mp4":
-        return [a for a in artifacts if a["name"].endswith(".mp4")]
+    if o in ("mp4", "video"):
+        return [a for a in artifacts if a["name"].endswith((".mp4", ".webm", ".mov"))]
     if o == "frames":
         return [a for a in artifacts if a["name"].startswith("frame_")]
     if o == "sheet":
         return [a for a in artifacts if a["name"] == "sheet.png"]
     if o == "output":
-        picked = [a for a in artifacts if a["name"] in ("output.mp4", "sheet.png")]
+        picked = [a for a in artifacts if a["name"] in ("output.mp4", "output.webm", "output.mov", "sheet.png")]
         return picked or [a for a in artifacts if a["name"].startswith("frame_")][:1]
     raise ValueError("only must be one of: " + ", ".join(ONLY_CHOICES))
 

janction_render-0.4.0/janction_render/mcp_app.html

@@ -0,0 +1,157 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>JANCTION Render</title>
+<style>
+  :root { color-scheme: light dark; --fg: #1b1b1f; --muted: #5f6368; --line: #d9dbe0; --bg: #ffffff; --accent: #1f3a8a; --ok: #1a7f37; --warn: #b26a00; --bad: #b3261e; }
+  @media (prefers-color-scheme: dark) { :root { --fg: #e8eaed; --muted: #9aa0a6; --line: #3c4043; --bg: #1b1b1f; --accent: #8ab4f8; --ok: #6ddb8a; --warn: #f2b84b; --bad: #f28b82; } }
+  html, body { margin: 0; padding: 0; background: transparent; color: var(--fg); font: 14px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif; }
+  .card { padding: 12px 14px; }
+  .head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+  .kind { font-weight: 600; }
+  .pill { font-size: 12px; padding: 2px 8px; border-radius: 999px; border: 1px solid var(--line); color: var(--muted); }
+  .pill.done { color: var(--ok); border-color: var(--ok); }
+  .pill.run { color: var(--accent); border-color: var(--accent); }
+  .pill.bad { color: var(--bad); border-color: var(--bad); }
+  .muted { color: var(--muted); font-size: 12px; }
+  img.sheet { display: block; max-width: 100%; height: auto; border-radius: 8px; margin: 10px 0 6px; border: 1px solid var(--line); }
+  video { display: block; max-width: 100%; border-radius: 8px; margin: 10px 0 6px; border: 1px solid var(--line); }
+  .bar { height: 8px; background: var(--line); border-radius: 4px; overflow: hidden; margin: 8px 0 4px; }
+  .bar > i { display: block; height: 100%; width: 0; background: var(--accent); transition: width .4s; }
+  .row { display: flex; gap: 8px; flex-wrap: wrap; margin-top: 8px; }
+  button { font: inherit; font-size: 13px; padding: 6px 12px; border-radius: 6px; border: 1px solid var(--accent); background: transparent; color: var(--accent); cursor: pointer; }
+  button.primary { background: var(--accent); color: #fff; }
+  button:disabled { opacity: .5; cursor: default; }
+  details { margin-top: 8px; } summary { cursor: pointer; color: var(--muted); font-size: 12px; }
+  ul.warn { margin: 4px 0 0 18px; padding: 0; font-size: 12px; color: var(--warn); }
+  .err { color: var(--bad); white-space: pre-wrap; font-size: 12px; }
+  .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 6px; margin-top: 8px; }
+</style>
+</head>
+<body>
+<div class="card" id="root"><span class="muted">JANCTION Render</span></div>
+<script type="module">
+import { App } from "https://unpkg.com/@modelcontextprotocol/ext-apps@0.4.0/app-with-deps";
+
+const root = document.getElementById("root");
+const app = new App({ name: "JANCTION Render", version: "1.0.0" });
+let state = { job: null, image: null, toolName: "", pollTimer: null, polls: 0 };
+const PRESETS = ["studio", "sunset", "overcast", "night"];
+
+function parseResult(result) {
+  const content = result?.content || [];
+  const text = content.find(c => c.type === "text")?.text || "";
+  let job = null;
+  try { job = JSON.parse(text); } catch (e) { job = { raw: text }; }
+  const img = content.find(c => c.type === "image");
+  return { job, image: img ? `data:${img.mimeType || "image/png"};base64,${img.data}` : null };
+}
+
+function esc(s) { return String(s ?? "").replace(/[&<>"']/g, c => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c])); }
+
+function progressOf(job) {
+  const m = /(\d+)\/(\d+) frames/.exec(job?.progress || "");
+  if (!m) return null;
+  const done = +m[1], total = +m[2];
+  return { done, total, pct: total ? Math.round(100 * done / total) : 0 };
+}
+
+function isCompare(job) {
+  const w = job?.warnings || [];
+  return w.some(x => String(x).startsWith("compare:"));
+}
+
+function render() {
+  const job = state.job;
+  if (!job) { root.innerHTML = '<span class="muted">JANCTION Render</span>'; return; }
+  if (job.ok === false || job.error && !job.status) {
+    root.innerHTML = `<div class="head"><span class="kind">JANCTION Render</span><span class="pill bad">error</span></div><div class="err">${esc(job.error || job.detail || "")}\n${esc(job.detail || "")}</div>`;
+    return;
+  }
+  const status = job.status || "";
+  const pillClass = status === "done" ? "done" : (status === "failed" || status === "canceled") ? "bad" : "run";
+  const kind = job.kind === "preview" ? "Preview" : job.kind === "final" ? "Final render" : job.kind === "info" ? "Scene info" : "Render";
+  let html = `<div class="head"><span class="kind">${esc(kind)}</span><span class="pill ${pillClass}">${esc(status || "ready")}</span>`;
+  if (job.frames) html += `<span class="muted">frames ${esc(job.frames)}</span>`;
+  if (job.gpu_seconds) html += `<span class="muted">${esc(job.gpu_seconds)} GPU s</span>`;
+  if (job.device) html += `<span class="muted">${esc(job.device)}</span>`;
+  html += `</div>`;
+  const eta = job.eta?.human || job.estimate?.human;
+  if (status === "queued" || status === "running") {
+    const p = progressOf(job);
+    if (p) html += `<div class="bar"><i style="width:${p.pct}%"></i></div><div class="muted">${p.done}/${p.total} frames${eta ? " · " + esc(eta) : ""}</div>`;
+    else if (eta) html += `<div class="muted">${esc(eta)}</div>`;
+  } else if (eta && status === "done") {
+    html += `<div class="muted">${esc(eta)}</div>`;
+  }
+  if (state.image) html += `<img class="sheet" src="${state.image}" alt="render preview">`;
+  const out = job.output_url;
+  const links = job.links || {};
+  if (status === "done" && out && /\.(mp4|webm|mov)(\?|$)/.test(out)) {
+    html += `<video controls playsinline src="${esc(out)}"></video>`;
+  }
+  if (status === "done" && isCompare(job)) {
+    html += `<div class="muted">Pick the lighting for the final render:</div><div class="grid">` +
+      PRESETS.map(p => `<button data-preset="${p}">Use ${p}</button>`).join("") + `</div>`;
+  }
+  html += `<div class="row">`;
+  if (status === "queued" || status === "running") html += `<button data-act="refresh">Refresh</button>`;
+  if (status === "done" && out) html += `<button class="primary" data-open="${esc(out)}">Open ${/\.(mp4|webm|mov)/.test(out) ? "video" : "image"}</button>`;
+  const frameLinks = Object.entries(links).filter(([n]) => n.startsWith("frame_"));
+  if (status === "done" && frameLinks.length) html += `<button data-open="${esc(frameLinks[0][1])}">Open first frame</button>`;
+  if (status === "done" && job.kind === "preview") html += `<button data-say="This preview looks right. Please ask me about frames, resolution and samples, then render the final.">Looks good, go final</button><button data-say="Please adjust the scene and preview again.">Needs changes</button>`;
+  html += `</div>`;
+  const warns = (job.warnings || []).filter(w => !String(w).startsWith("compare:"));
+  if (warns.length) html += `<details><summary>${warns.length} note${warns.length > 1 ? "s" : ""} from Blender</summary><ul class="warn">${warns.map(w => `<li>${esc(w)}</li>`).join("")}</ul></details>`;
+  if (job.expires_at) html += `<div class="muted">files kept until ${esc(job.expires_at)}</div>`;
+  root.innerHTML = html;
+  root.querySelectorAll("button[data-open]").forEach(b => b.addEventListener("click", () => app.openLink({ url: b.dataset.open })));
+  root.querySelectorAll("button[data-say]").forEach(b => b.addEventListener("click", () => app.sendMessage({ role: "user", content: { type: "text", text: b.dataset.say } })));
+  root.querySelectorAll("button[data-preset]").forEach(b => b.addEventListener("click", () => app.sendMessage({ role: "user", content: { type: "text", text: `Use the ${b.dataset.preset} lighting preset (environment="${b.dataset.preset}") for the final render. Ask me about frames, resolution and samples first.` } })));
+  root.querySelector("button[data-act=refresh]")?.addEventListener("click", refresh);
+  schedulePoll();
+}
+
+async function refresh() {
+  const id = state.job?.job_id;
+  if (!id) return;
+  try {
+    const r = await app.callServerTool({ name: "render_status", arguments: { job_id: id } });
+    const parsed = parseResult(r);
+    if (parsed.job && parsed.job.job_id) state.job = parsed.job;
+    if (parsed.image) state.image = parsed.image;
+    if (state.job.status === "done" && !state.image && state.job.kind === "preview") {
+      const d = await app.callServerTool({ name: "render_download", arguments: { job_id: id } });
+      const p2 = parseResult(d);
+      if (p2.image) state.image = p2.image;
+      if (p2.job && p2.job.job_id) state.job = p2.job;
+    }
+    render();
+  } catch (e) { console.error(e); }
+}
+
+function schedulePoll() {
+  if (state.pollTimer) { clearTimeout(state.pollTimer); state.pollTimer = null; }
+  const s = state.job?.status;
+  if ((s === "queued" || s === "running") && state.polls < 120) {
+    state.polls += 1;
+    state.pollTimer = setTimeout(refresh, 5000);
+  }
+}
+
+app.ontoolresult = (result) => {
+  const parsed = parseResult(result);
+  state.job = parsed.job; state.image = parsed.image; state.polls = 0;
+  render();
+};
+app.ontoolinput = () => { root.innerHTML = '<span class="muted">Rendering on JANCTION…</span>'; };
+
+await app.connect();
+const ctx = app.getHostContext?.();
+state.toolName = ctx?.toolInfo?.tool?.name || "";
+</script>
+</body>
+</html>

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

@@ -41,7 +41,8 @@ mcp = MCPServer(
         "in one image; look at it, fix the scene, repeat) -> ask the user 'is this OK?' -> render_estimate (tell the "
         "user how long it takes and whether it fits today's free quota) -> render_final (frames or MP4) -> "
         "render_status / render_download. Always tell the user the time estimate (estimate.human / eta.human). "
-        "Blender 5.0 with Cycles on GPU (blender='5.2' selects Blender 5.2 when the worker has it). Inputs: a .blend, a bpy "
+        "Blender 5.0 with Cycles on GPU (blender='5.2' selects Blender 5.2 when the worker has it); engine='eevee' switches to EEVEE "
+        "(about half the per-frame cost on animations of a few dozen frames or more; each job pays ~7 s of shader compilation, so previews stay on Cycles); output='png'|'exr' returns frames, 'mp4'|'webm'|'prores' a video. Blender 5.0 API notes for scripts: materials always use nodes, so set a color on the Principled BSDF (mat.node_tree.nodes['Principled BSDF'].inputs['Base Color'].default_value = (r, g, b, 1)); mat.diffuse_color only affects the viewport. Animate with obj.keyframe_insert(); obj.animation_data.action.fcurves no longer exists (set bpy.context.preferences.edit.keyframe_new_interpolation_type='LINEAR' before inserting keyframes for constant-speed motion); do not set Material.use_nodes; leave resolution, samples and denoising to the service. Inputs: a .blend, a bpy "
         "script, or a 3D file (FBX, glTF/GLB, USD, OBJ, STL, PLY, Alembic) that is imported into an empty scene; images "
         "and other assets can be sent with the scene (assets=[...]). environment='studio'|'sunset'|'overcast'|'night' "
         "lights the scene with a bundled HDRI for a good-looking first render. Inputs and results are deleted 24 hours "
@@ -55,6 +56,23 @@ ORBIT_DOC = (" orbit=True: turntable; an orbit camera circles the scene once ove
              "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 "
              "shows 0/90/180/270 deg; a final without frame_end renders the whole turn as an MP4. Best for imported models.")
+# ---- MCP Apps（Claude Desktop など対応ホストに、絵と進み具合のパネルを出す。対応していないホストは無視する）
+UI_URI = "ui://janction-render/app.html"
+UI_MIME = "text/html;profile=mcp-app"
+
+
+def ui_enabled() -> bool:
+    return (os.environ.get("JR_MCP_APPS") or "1").strip().lower() not in ("0", "false", "no", "off")
+
+
+def _ui_meta() -> Optional[dict[str, Any]]:
+    return {"ui": {"resourceUri": UI_URI}, "ui/resourceUri": UI_URI} if ui_enabled() else None
+
+
+def ui_html() -> str:
+    return (Path(__file__).resolve().parent / "mcp_app.html").read_text(encoding="utf-8")
+
+
 ENV_DOC = ("environment: '' keeps the scene's own world; 'studio' | 'sunset' | 'overcast' | 'night' replaces it with a "
            "bundled HDRI (good first render for scenes without lighting work); 'compare' (render_preview only) renders the "
            "first frame under all four presets in one 2x2 image with labels, so you can pick one; environment_strength scales it (1.0); "
@@ -155,8 +173,11 @@ def _resolve_scene(c: Client, scene_path: str, scene_id: str, scene_script: str
     return up["scene_id"]
 
 
-def _job_params(environment: str, environment_strength: float, environment_visible: bool, blender: str) -> dict[str, Any]:
+def _job_params(environment: str, environment_strength: float, environment_visible: bool, blender: str,
+                engine: str = "") -> dict[str, Any]:
     out: dict[str, Any] = {}
+    if engine:
+        out["engine"] = engine
     if environment:
         out.update({"environment": environment, "environment_strength": environment_strength,
                     "environment_visible": environment_visible})
@@ -218,7 +239,7 @@ def scene_info(scene_path: str = "", scene_id: str = "", scene_script: str = "",
     return _j(_attach_upload_notes(info))
 
 
-@mcp.tool(structured_output=False)
+@mcp.tool(structured_output=False, meta=_ui_meta())
 def render_preview(
     scene_path: str = "",
     scene_id: str = "",
@@ -239,6 +260,7 @@ def render_preview(
     orbit_elevation: float = 18.0,
     orbit_target: str = "",
     orbit_distance: float = 1.0,
+    engine: str = "",
 ) -> list[Any]:
     """Render a fast, cheap preview of a Blender scene on a JANCTION GPU and show the image.
 
@@ -259,7 +281,7 @@ def render_preview(
         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,
-                     **_job_params(environment, environment_strength, environment_visible, blender),
+                     **_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 {}))
         _log(f"preview job {j['job_id']} submitted frames={frame_list}")
@@ -319,7 +341,7 @@ def render_estimate(scene_id: str = "", kind: str = "final", frame_start: int =
     return _j(out)
 
 
-@mcp.tool()
+@mcp.tool(meta=_ui_meta())
 def render_final(
     scene_path: str = "",
     scene_id: str = "",
@@ -342,6 +364,7 @@ def render_final(
     orbit_elevation: float = 18.0,
     orbit_target: str = "",
     orbit_distance: float = 1.0,
+    engine: str = "",
 ) -> str:
     """Render the final frames (or a video) of a Blender scene on JANCTION GPUs.
 
@@ -364,7 +387,7 @@ def render_final(
         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,
-                     **_job_params(environment, environment_strength, environment_visible, blender), **extra)
+                     **_job_params(environment, environment_strength, environment_visible, blender, engine=engine), **extra)
     except ClientError as exc:
         block = _payment_block(exc) or _quota_block(exc)
         return _j(block if block else {"ok": False, "error": str(exc)})
@@ -377,7 +400,7 @@ def render_final(
     return _j(_attach_upload_notes(brief))
 
 
-@mcp.tool()
+@mcp.tool(meta=_ui_meta())
 def render_status(job_id: str) -> str:
     """Check a JANCTION render job: status (queued/running/done/failed/canceled), frames done,
     how many chunks are queued ahead, the ETA (eta.human = remaining time including queue wait),
@@ -393,7 +416,7 @@ def render_status(job_id: str) -> str:
     return _j(b)
 
 
-@mcp.tool()
+@mcp.tool(meta=_ui_meta())
 def render_download(job_id: str, out_dir: str = "", wait_seconds: int = 0, only: str = "all") -> str:
     """Download a JANCTION render job's files to out_dir (default ~/janction-render/<job_id>).
     only: 'all' (default: every PNG frame plus output.mp4 / sheet.png), 'mp4' (just the video), 'frames'
@@ -483,6 +506,15 @@ def render_info() -> str:
                "remote_mcp": f"{c.server}/mcp (Streamable HTTP; for Claude.ai, ChatGPT, Cursor: add this URL as a connector)"})
 
 
+if ui_enabled():
+    @mcp.resource(UI_URI, name="JANCTION Render app", title="JANCTION Render", mime_type=UI_MIME,
+                  description="Interactive view for JANCTION Render results: preview image, progress, ETA, links, preset picker.",
+                  meta={"ui": {"csp": {"resourceDomains": ["https://unpkg.com", "https://render.janction.jp"], "connectDomains": []},
+                               "prefersBorder": True}})
+    def janction_render_app() -> str:
+        return ui_html()
+
+
 def main() -> None:
     _log(f"stdio, server={Client().server}")
     mcp.run()

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.3.3
+Version: 0.4.0
 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
@@ -35,6 +35,7 @@ without a GPU, or when rendering locally is slow.
 - 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.
+  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.
 - `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.
@@ -113,7 +114,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?)` | PNG or MP4; returns job_id + estimate |
+| `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_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 |
@@ -142,7 +143,7 @@ sun = bpy.data.objects.new("Sun", bpy.data.lights.new("Sun", "SUN"))
 scene.collection.objects.link(sun)
 ```
 
-The service sets engine (Cycles), resolution, samples and denoising; your script sets the scene, camera and frame range.
+The service sets the engine (Cycles by default; `engine="eevee"` for cheaper animations: about half the per-frame cost after ~7 s of shader compilation per job), resolution, samples and denoising; your script sets the scene, camera and frame range. In Blender 5.0 materials always use nodes: set the Principled BSDF Base Color, not `diffuse_color`.
 Scripts run in an isolated container with no network. See `samples/cube_scene.py`.
 
 ## HTTP API
@@ -152,7 +153,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,
+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),
                  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.3.3 → janction_render-0.4.0}/janction_render.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ janction_render/__init__.py
 janction_render/brief.py
 janction_render/cli.py
 janction_render/client.py
+janction_render/mcp_app.html
 janction_render/mcp_server.py
 janction_render.egg-info/PKG-INFO
 janction_render.egg-info/SOURCES.txt

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "janction-render"
-version = "0.3.3"
+version = "0.4.0"
 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"
@@ -21,3 +21,6 @@ janction-render-mcp = "janction_render.mcp_server:main"
 
 [tool.setuptools.packages.find]
 include = ["janction_render*"]
+
+[tool.setuptools.package-data]
+janction_render = ["mcp_app.html"]