janction-render 0.4.3__tar.gz → 0.4.5__tar.gz

{janction_render-0.4.3 → janction_render-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.3
+Version: 0.4.5
 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
@@ -40,13 +40,17 @@ without a GPU, or when rendering locally is slow.
 - 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.
 - `render_final` renders the frames on GPUs and joins them into an MP4; `render_status` reports the remaining time.
 - Free beta: no charges. Each key gets 10 GPU-minutes per day; a final render is up to 240 frames at 1080p.
   Paid plans (per GPU second, prepaid credit) will be announced on the service page before they start.
-- Inputs and results are deleted 24 hours after last use and are never used for training.
+- Inputs and results are deleted 24 hours after last use and are never used for training. A render you choose to
+  share (`render_share`) gets a public page (`/r/<id>`, OGP for X and Discord) that stays until you unshare it.
 
 ## Status
 
@@ -122,6 +126,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 |
+| `render_share(job_id, title?, note?, include_script?, listed?)` | a public page `/r/<id>` with the image or video, the conditions and (optionally) the script; survives the 24-hour expiry until `render_unshare`; listed pages appear in `/gallery` |
 | `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 |
 
@@ -131,7 +136,7 @@ Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`,
 sent with the scene, found in the script through `os.environ["JR_ASSETS_DIR"]`; a `.blend`'s external files are collected
 automatically with `pip install janction-render[blend]`) or `asset_urls` (remote).
 
-CLI: `janction-render inspect|preview|render|status|download|cancel|jobs|balance|topup|info`.
+CLI: `janction-render inspect|preview|render|status|download|share|unshare|cancel|jobs|balance|topup|info`.
 
 ## Writing a scene script
 
@@ -163,6 +168,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
+POST /v1/jobs/{id}/share {title?, note?, include_script?, listed?} -> {share_id, url}   DELETE /v1/jobs/{id}/share   GET /v1/shares
+GET  /r/{share_id}  public page (no key)   GET /gallery
 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)

{janction_render-0.4.3 → janction_render-0.4.5}/README.md

@@ -23,13 +23,17 @@ without a GPU, or when rendering locally is slow.
 - 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.
 - `render_final` renders the frames on GPUs and joins them into an MP4; `render_status` reports the remaining time.
 - Free beta: no charges. Each key gets 10 GPU-minutes per day; a final render is up to 240 frames at 1080p.
   Paid plans (per GPU second, prepaid credit) will be announced on the service page before they start.
-- Inputs and results are deleted 24 hours after last use and are never used for training.
+- Inputs and results are deleted 24 hours after last use and are never used for training. A render you choose to
+  share (`render_share`) gets a public page (`/r/<id>`, OGP for X and Discord) that stays until you unshare it.
 
 ## Status
 
@@ -105,6 +109,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 |
+| `render_share(job_id, title?, note?, include_script?, listed?)` | a public page `/r/<id>` with the image or video, the conditions and (optionally) the script; survives the 24-hour expiry until `render_unshare`; listed pages appear in `/gallery` |
 | `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 |
 
@@ -114,7 +119,7 @@ Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`,
 sent with the scene, found in the script through `os.environ["JR_ASSETS_DIR"]`; a `.blend`'s external files are collected
 automatically with `pip install janction-render[blend]`) or `asset_urls` (remote).
 
-CLI: `janction-render inspect|preview|render|status|download|cancel|jobs|balance|topup|info`.
+CLI: `janction-render inspect|preview|render|status|download|share|unshare|cancel|jobs|balance|topup|info`.
 
 ## Writing a scene script
 
@@ -146,6 +151,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
+POST /v1/jobs/{id}/share {title?, note?, include_script?, listed?} -> {share_id, url}   DELETE /v1/jobs/{id}/share   GET /v1/shares
+GET  /r/{share_id}  public page (no key)   GET /gallery
 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)

{janction_render-0.4.3 → janction_render-0.4.5}/janction_render/__init__.py

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

{janction_render-0.4.3 → janction_render-0.4.5}/janction_render/cli.py

@@ -136,6 +136,17 @@ def cmd_cancel(c: Client, args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_share(c: Client, args: argparse.Namespace) -> int:
+    v = c.share(args.job, title=args.title or "", note=args.note or "", include_script=bool(args.script), listed=not args.unlisted)
+    print(v["url"])
+    return 0
+
+
+def cmd_unshare(c: Client, args: argparse.Namespace) -> int:
+    print(_j(c.unshare(args.job)))
+    return 0
+
+
 def cmd_jobs(c: Client, args: argparse.Namespace) -> int:
     rows = c.jobs(args.limit)
     for j in rows:
@@ -221,6 +232,16 @@ def build_parser() -> argparse.ArgumentParser:
     s.add_argument("--wait", type=float, default=0, help="seconds to wait for the job first")
     s.set_defaults(fn=cmd_download)
 
+    s = sub.add_parser("share", help="publish a finished job as a public page (/r/<id>)")
+    s.add_argument("job")
+    s.add_argument("--title", default=None)
+    s.add_argument("--note", default=None)
+    s.add_argument("--script", action="store_true", help="include the bpy script on the page")
+    s.add_argument("--unlisted", action="store_true", help="do not list the page in the gallery")
+    s.set_defaults(fn=cmd_share)
+    s = sub.add_parser("unshare", help="remove the public page of a job")
+    s.add_argument("job")
+    s.set_defaults(fn=cmd_unshare)
     s = sub.add_parser("cancel")
     s.add_argument("job")
     s.set_defaults(fn=cmd_cancel)

{janction_render-0.4.3 → janction_render-0.4.5}/janction_render/client.py

@@ -361,6 +361,23 @@ class Client:
         self._raise(r)
         return r.json()
 
+    def share(self, job_id: str, title: str = "", note: str = "", include_script: bool = False, listed: bool = True) -> dict[str, Any]:
+        """描けた結果を公開ページにする（/r/<id>）。"""
+        r = self.s.post(f"{self.server}/v1/jobs/{job_id}/share", headers=self._headers(),
+                        json={"title": title, "note": note, "include_script": include_script, "listed": listed}, timeout=120)
+        self._raise(r)
+        return r.json()
+
+    def unshare(self, job_id: str) -> dict[str, Any]:
+        r = self.s.delete(f"{self.server}/v1/jobs/{job_id}/share", headers=self._headers(), timeout=60)
+        self._raise(r)
+        return r.json()
+
+    def shares(self) -> dict[str, Any]:
+        r = self.s.get(f"{self.server}/v1/shares", headers=self._headers(), timeout=30)
+        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(),

{janction_render-0.4.3 → janction_render-0.4.5}/janction_render/mcp_server.py

@@ -89,7 +89,8 @@ ENV_DOC = ("environment: '' keeps the scene's own world; 'studio' | 'sunset' | '
            "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')).")
+                 "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
 
 
@@ -516,6 +517,27 @@ def render_cancel(job_id: str) -> str:
         return _j({"ok": False, "error": str(exc)})
 
 
+@mcp.tool()
+def render_share(job_id: str, title: str = "", note: str = "", include_script: bool = False, listed: bool = True) -> str:
+    """Publish a finished render as a public page the user can send to anyone (X, Discord, a client): the image or
+    video, the render conditions, an optional title and note, and the bpy script if include_script=True. The page
+    keeps a copy of the result after the job's 24-hour expiry, until render_unshare. listed=True also puts it in the
+    public gallery. Ask the user before sharing; return the url to them."""
+    try:
+        return _j(_client().share(job_id, title=title, note=note, include_script=include_script, listed=listed))
+    except ClientError as exc:
+        return _j({"ok": False, "error": str(exc)})
+
+
+@mcp.tool()
+def render_unshare(job_id: str) -> str:
+    """Remove the public share page of a job (the copy of the result is deleted)."""
+    try:
+        return _j(_client().unshare(job_id))
+    except ClientError as exc:
+        return _j({"ok": False, "error": str(exc)})
+
+
 @mcp.tool()
 def billing(topup_yen: int = 0) -> str:
     """Check the account's quota or credit. During the free beta it returns today's GPU-time usage,

{janction_render-0.4.3 → janction_render-0.4.5}/janction_render.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janction-render
-Version: 0.4.3
+Version: 0.4.5
 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
@@ -40,13 +40,17 @@ without a GPU, or when rendering locally is slow.
 - 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.
 - `render_final` renders the frames on GPUs and joins them into an MP4; `render_status` reports the remaining time.
 - Free beta: no charges. Each key gets 10 GPU-minutes per day; a final render is up to 240 frames at 1080p.
   Paid plans (per GPU second, prepaid credit) will be announced on the service page before they start.
-- Inputs and results are deleted 24 hours after last use and are never used for training.
+- Inputs and results are deleted 24 hours after last use and are never used for training. A render you choose to
+  share (`render_share`) gets a public page (`/r/<id>`, OGP for X and Discord) that stays until you unshare it.
 
 ## Status
 
@@ -122,6 +126,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 |
+| `render_share(job_id, title?, note?, include_script?, listed?)` | a public page `/r/<id>` with the image or video, the conditions and (optionally) the script; survives the 24-hour expiry until `render_unshare`; listed pages appear in `/gallery` |
 | `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 |
 
@@ -131,7 +136,7 @@ Options on `render_preview` / `render_final`: `environment` (`studio`, `sunset`,
 sent with the scene, found in the script through `os.environ["JR_ASSETS_DIR"]`; a `.blend`'s external files are collected
 automatically with `pip install janction-render[blend]`) or `asset_urls` (remote).
 
-CLI: `janction-render inspect|preview|render|status|download|cancel|jobs|balance|topup|info`.
+CLI: `janction-render inspect|preview|render|status|download|share|unshare|cancel|jobs|balance|topup|info`.
 
 ## Writing a scene script
 
@@ -163,6 +168,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
+POST /v1/jobs/{id}/share {title?, note?, include_script?, listed?} -> {share_id, url}   DELETE /v1/jobs/{id}/share   GET /v1/shares
+GET  /r/{share_id}  public page (no key)   GET /gallery
 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)

{janction_render-0.4.3 → janction_render-0.4.5}/pyproject.toml

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