loopcut 0.1.0__py3-none-any.whl

loopcut/state.py

@@ -0,0 +1,81 @@
+"""Small JSON records on disk: the signed-in key, quotes awaiting a start, started jobs and the
+last tool catalog read from the server.
+
+Everything lives under LOOPCUT_CONNECTOR_HOME, else %APPDATA%/loopcut-connector on Windows and
+$XDG_CONFIG_HOME/loopcut-connector (default ~/.config/loopcut-connector) elsewhere. Not
+~/.config/loopcut: other Loopcut tools already keep files there, and the Blender add-on keeps its
+own sign-in in Blender's config folder, so this folder belongs to the connector alone. Files are
+written whole, owner-only, and replaced atomically, so the CLI and an MCP server can share them.
+"""
+
+import json
+import os
+import re
+import sys
+import tempfile
+from pathlib import Path
+
+_ID = re.compile(r"[A-Za-z0-9_-]{1,128}\Z")
+FOLDER = "loopcut-connector"
+
+
+def home():
+    explicit = os.environ.get("LOOPCUT_CONNECTOR_HOME")
+    if explicit:
+        return Path(explicit).expanduser()
+    if sys.platform == "win32" and os.environ.get("APPDATA"):
+        return Path(os.environ["APPDATA"]) / FOLDER
+    return Path(os.environ.get("XDG_CONFIG_HOME") or Path.home() / ".config") / FOLDER
+
+
+def _write(path, value):
+    path.parent.mkdir(parents=True, exist_ok=True, mode=0o700)
+    handle, temporary = tempfile.mkstemp(prefix=".tmp-", dir=path.parent)
+    try:
+        with os.fdopen(handle, "w", encoding="utf-8") as output:
+            json.dump(value, output, indent=2, ensure_ascii=False)
+        os.chmod(temporary, 0o600)
+        os.replace(temporary, path)
+    except BaseException:
+        Path(temporary).unlink(missing_ok=True)
+        raise
+
+
+def _read(path):
+    try:
+        value = json.loads(path.read_text(encoding="utf-8"))
+    except FileNotFoundError:
+        return None
+    return value if isinstance(value, dict) else None
+
+
+def _record(kind, identifier):
+    if not isinstance(identifier, str) or not _ID.fullmatch(identifier):
+        raise ValueError(f"Invalid {kind[:-1]} id: {identifier!r}")
+    return home() / kind / f"{identifier}.json"
+
+
+def credentials(base_url):
+    """{api_key, email} stored for this service, or None."""
+    entry = (_read(home() / "credentials.json") or {}).get(base_url)
+    return entry if isinstance(entry, dict) and isinstance(entry.get("api_key"), str) else None
+
+
+def save_credentials(base_url, api_key, email):
+    stored = _read(home() / "credentials.json") or {}
+    stored[base_url] = {"api_key": api_key, "email": email}
+    _write(home() / "credentials.json", stored)
+
+
+def forget_credentials(base_url):
+    stored = _read(home() / "credentials.json") or {}
+    if stored.pop(base_url, None) is not None:
+        _write(home() / "credentials.json", stored)
+
+
+def load(kind, identifier):
+    return _read(_record(kind, identifier))
+
+
+def save(kind, identifier, value):
+    _write(_record(kind, identifier), value)

loopcut-0.1.0.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: loopcut
+Version: 0.1.0
+Summary: Loopcut's cloud tools for Claude Code, Codex and other agents: render .blend files on cloud GPUs, search free assets, make 3D models, sound effects and voice lines, billed to your Loopcut credits.
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://loopcut.org/render
+Project-URL: Documentation, https://loopcut.org/docs/render
+Project-URL: Source, https://github.com/loopcut-ai/loopcut
+Keywords: blender,render,mcp,cloud,loopcut,3d,assets
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# loopcut
+
+Loopcut's cloud tools for Claude Code, Codex, Cursor, Claude Desktop and the shell. Render `.blend` files on
+cloud RTX 4090s, search free asset libraries, turn images into 3D models, remesh meshes, and make sound
+effects and voice lines. Results come back as files the agent imports with Blender's Python. Everything is
+paid from your [Loopcut](https://loopcut.org/render) account's credits. You don't need the Loopcut app;
+any Blender install packs the scene.
+
+<!-- mcp-name: io.github.loopcut-ai/loopcut -->
+
+It's one MCP server plus a CLI with the same verbs. The tools come from Loopcut's catalog, so a cloud tool
+that opens on Loopcut shows up without a new release.
+
+| Tool | What it does | Result |
+|---|---|---|
+| `loopcut_login` | Signs in or switches account. Any tool does it by itself the first time: a browser opens, you approve, and the call carries on | |
+| `loopcut_account` | Plan, credit balance, Private mode and no-generation settings, and which tools you can use | |
+| `render_quote` | Packs the saved scene with headless Blender, uploads what the cloud lacks and prices the render | PNG frames and a QA report |
+| `asset_search` | Searches Poly Haven, ambientCG and Physically Based. Free, and it runs at once | Matches with licence and download details |
+| `image_to_3d` | Makes a textured model from a prompt, an image or both | GLB |
+| `remesh` | Rebuilds a GLB mesh with clean quads or triangles and bakes its textures onto it | FBX (quads) or GLB (triangles) |
+| `sound_effect` | Makes a sound effect from a description | WAV |
+| `voice_line` | Speaks a line with a chosen voice and direction | WAV |
+| `job_start` | Starts a quoted job, which spends credits. Calling it again returns the same job | |
+| `job_status` | Waits for a job and downloads its results, hash-checked and resumable | |
+| `job_cancel` | Cancels a job and refunds unspent credits | |
+
+Image generation and image editing appear as `image_generate` and `image_edit` once they open.
+
+**Price.** 1 credit = $0.01. Every paid tool quotes first, for free, and the quote is the most a job can
+cost. Rendering costs 5 credits per GPU-minute on an RTX 4090 with a one-minute minimum; the other prices
+are on [loopcut.org/pricing](https://loopcut.org/pricing). Asset search, quotes, packing and the render QA
+report are free. Failed jobs are refunded. New accounts start with 100 credits.
+
+## Install
+
+You need [uv](https://docs.astral.sh/uv/) (it provides Python 3.10+), and Blender if you render.
+
+**Claude Code** (plugin, which includes a skill that teaches the agent the tools and the habits that save
+credits)
+
+```
+/plugin install loopcut --marketplace loopcut-ai/loopcut
+```
+
+On Claude Code before 2.1.275, run `/plugin marketplace add loopcut-ai/loopcut` and then
+`/plugin install loopcut@loopcut`. Or add only the MCP server:
+
+```sh
+claude mcp add loopcut -- uvx loopcut mcp
+```
+
+**Codex** (plugin, with the same skill)
+
+```sh
+codex plugin marketplace add loopcut-ai/loopcut
+codex plugin add loopcut@loopcut
+```
+
+Or add only the MCP server:
+
+```sh
+codex mcp add loopcut -- uvx loopcut mcp
+```
+
+Every tool call returns within 50 s, under Codex's default 60 s tool timeout; long work carries on between
+calls. Both plugins start the server from their own folder with `uv run --frozen --project <plugin folder>
+loopcut mcp`; the package has no dependencies beyond Python.
+
+**Cursor, VS Code, Claude Desktop and other MCP clients**
+
+```json
+{
+  "mcpServers": {
+    "loopcut": {
+      "command": "uvx",
+      "args": ["loopcut", "mcp"]
+    }
+  }
+}
+```
+
+Apps opened from the Dock or Start menu may not see your shell's `PATH`. If the server doesn't start, use
+the full path from `which uvx` as `command`.
+
+The first call opens a browser to sign in, and the key is kept where only you can read it. Without a
+browser (over SSH, say), the call returns the link for you to open. `LOOPCUT_API_KEY` skips all of this.
+
+## CLI
+
+```sh
+loopcut login                                         # once per machine
+loopcut account                                       # plan, credits, settings
+loopcut tools                                         # the open tools and their inputs
+loopcut render shot.blend --frames 1-120 --samples 256 --max-credits 300
+loopcut run asset_search --input '{"query": "oak floor", "kind": "material"}'
+loopcut run image_to_3d --input '{"prompt": "a brass desk lamp", "quality": "draft"}' --file image=lamp.png --max-credits 30
+loopcut quote sound_effect --input '{"prompt": "a heavy wooden door slams", "duration_seconds": 2}'
+loopcut start QUOTE_ID | status JOB_ID --wait | fetch JOB_ID --out DIR | cancel JOB_ID
+loopcut settings --private-mode off                   # or on; also --no-generation on|off
+```
+
+Install the command with `uv tool install loopcut`, or run any command without installing as `uvx loopcut …`.
+`run` and `render` quote, then start only with `--yes`, under `--max-credits N`, or after you answer the
+prompt. Results print as JSON on stdout; progress goes to stderr. In CI, create a key on
+[loopcut.org/account](https://loopcut.org/account) and set `LOOPCUT_API_KEY`.
+
+## Settings
+
+| Variable | Meaning |
+|---|---|
+| `LOOPCUT_API_KEY` | A Loopcut key (`lc_…`) to use instead of the stored sign-in, e.g. in CI |
+| `LOOPCUT_BLENDER` | The Blender executable used for packing. Without it, the tool checks `BLENDER`, then `PATH`, then the usual install folders |
+| `LOOPCUT_SERVICE_URL` | The service, `https://loopcut.org` by default |
+| `LOOPCUT_CONNECTOR_HOME` | Where the sign-in, quotes, jobs and the last tool catalog are kept. Default: `~/.config/loopcut-connector`, or `%APPDATA%\loopcut-connector` on Windows. It is separate from the Loopcut app's own files |
+
+**Private mode and no-generation.** These account settings apply here too. Private mode (on by default on
+paid plans) refuses tools whose provider may train on what it receives; today that is sound effects.
+No-generation hides and refuses the generative tools. Change them in the Loopcut app or with
+`loopcut settings`.
+
+## How it works
+
+1. **Quote.** Every tool goes through the same job API the Loopcut add-on uses. A quote prices the exact
+   request and lasts ten minutes; an expired one is renewed at start, and the job goes ahead only if the
+   price didn't change. Starting the same quote twice returns the same job.
+2. **Files in.** File inputs are local paths. They're checked (type and size), addressed by SHA-256, and
+   only uploaded if the cloud doesn't already have them, straight to storage with presigned URLs. Big
+   files go in parts, each retried on its own.
+3. **Render packing.** A background Blender (`-b --factory-startup --disable-autoexec`) opens the saved
+   `.blend` and runs the Loopcut add-on's own collector (`addon/bundles.py`, vendored). It copies every
+   texture, library, cache and sequencer file into a bundle with relative paths. That Blender gets a
+   private config folder and none of your environment's keys. The cloud never runs Python from your file,
+   and the renderer has no internet access.
+4. **Files out.** Results are checked against their hashes and saved into `loopcut_renders/<job_id>/`
+   next to the `.blend` for a render, and `loopcut_outputs/<job_id>/` in the working folder for everything
+   else (or `out_dir`). The working folder is the client's workspace root when it shares one; Codex starts
+   plugin servers in the plugin's own folder, so there results go under your home folder instead. A
+   render's QA report flags black, white, flat and transparent frames, fireflies, duplicate frames and
+   exposure jumps.
+
+If the catalog can't be read at startup, the server uses the last catalog it read from that service, then
+the snapshot in `src/loopcut/catalog.json`.
+
+**What it runs and connects to.** `uv`, which provides Python (and downloads it if needed); your Blender,
+headless, only to pack a scene for `render_quote`; and your browser, only to open the Loopcut sign-in
+page. It connects to `loopcut.org` (the catalog, sign-in and job API) and to the presigned storage URLs
+that API hands out for uploads and downloads. It sends no analytics.
+
+## Privacy Policy
+
+Loopcut's privacy policy is at [loopcut.org/privacy](https://loopcut.org/privacy). For this connector:
+
+- **What it sends.** The Loopcut key on every request, with the client's name and version. For a render,
+  the packed scene: the saved `.blend` and every texture, library and cache it uses. For other tools, the
+  inputs you or the agent give (prompts, settings) and the files named as inputs (images, meshes). It reads
+  nothing else from your machine: no other files, no environment keys besides `LOOPCUT_API_KEY`, no open
+  Blender session.
+- **Where it's stored.** Loopcut's database (Supabase, US) holds your account, quotes and jobs; uploaded
+  files and results are kept in Cloudflare R2.
+- **Third parties.** Each job goes only to the provider that runs it: today OpenAI, fal and the model
+  developers it runs (Deemos for Rodin, Tripo), Google Cloud, ElevenLabs and RunPod. Providers' own
+  retention terms are on the privacy page. Private mode, on by default for paid plans, refuses tools whose
+  provider may train on what it receives (today, sound effects).
+- **Retention.** Uploaded files are deleted 7 days after their last use and results 30 days after theirs.
+  Account and billing records are kept while the account exists. Results you download are ordinary files
+  on your machine.
+- **On your machine.** The key, quotes, jobs and the last tool catalog are kept in
+  `~/.config/loopcut-connector`, readable only by you. `loopcut logout` removes the key.
+- **Contact.** hello@loopcut.org, also for exporting or deleting your account data.
+
+## Development
+
+```sh
+PYTHONPATH=src python3 -m unittest discover -s tests       # MCP protocol and unit tests
+LOOPCUT_TEST_BLENDER=/path/to/blender PYTHONPATH=src python3 -m unittest tests.test_blender_pack
+python3 scripts/snapshot_catalog.py                         # refresh the fallback catalog before a release
+```
+
+The end-to-end tests run against Loopcut's contract mock, which lives in the service repository; they're
+skipped here. `addon/VENDORED.md` explains how the add-on copies are kept in sync.
+
+Released under the GPL-3.0-or-later. Loopcut is an independent project; Blender is a trademark of the
+Blender Foundation.

loopcut-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+loopcut/__init__.py,sha256=Vfi9rWzegZCEgZRlyfRaelzzSiFLmJJiE6FirukULw4,272
+loopcut/__main__.py,sha256=ifaxB2AjCol94-nP2LzRaVc7KSe5sQ9qyVPaDmSwq5c,295
+loopcut/agent_tools.json,sha256=Sc3nuzHW7GiZ5T6x8QNzFZIOFvJAADMVBEJlw9xUBTU,2226
+loopcut/catalog.json,sha256=lxxvcoarE_Uu5Zv22WB1GtEUgOKOGyKYxdKodiu3PjA,28387
+loopcut/catalog.py,sha256=AK5rlSFvT1JugAyQHFZq4z4j-IXvQcOBZAeHnh_a1Eo,4079
+loopcut/cli.py,sha256=2TC9x7mKK5-vgTWOLcN-BtwdTk7KIVtfw1aIzRGQExM,12130
+loopcut/mcp_server.py,sha256=Z2Ug5RVbI-3mDSRlw6mzBQ6ri5PuKE7NmvOi-l4eD9A,18863
+loopcut/pack.py,sha256=c9uSqtHpW4y7xzdAa6q92KuBW71wuDjilFXYF1ZQrNs,7892
+loopcut/service.py,sha256=W5jh_A0OUK7ugPQEA19M_m7kYuoTCUFZ4matCIwzL2E,45870
+loopcut/state.py,sha256=Su6m8k-zSBAw4fdKbM4l_QqIaW7ytMYZIqOpt07npiI,2797
+loopcut/addon/VENDORED.md,sha256=gFi32OTZY0lOyBSOStHdVdHCLsDWA22nLj5gY4RYWMA,882
+loopcut/addon/__init__.py,sha256=d9bmFgHVKIwSi4ahSjG8gnV7qPbUcKOxrqcC6OXZ2Ms,416
+loopcut/addon/blobs.py,sha256=V_rizBviQiARoM7dniEc5wcrCFrCwhZ8dORv3ZYDMYw,21127
+loopcut/addon/bundles.py,sha256=aqk5yXC2sgbxnYwB_KJoiWuhg12ePdswSnkPCf1ie_E,28953
+loopcut/addon/cloud_http.py,sha256=omJUCsYm1D9nR4QwVV3s7qWkeNvDjaqYnm5TAvL-iEc,11569
+loopcut/addon/config.py,sha256=WdAAeSHKb9vr1tg2OGXgfs9YZ26xq_Dbjg0xJCADCQ0,190
+loopcut/addon/credentials.py,sha256=J6dPHG_zunc4K_gnPyEoq1c8at9YgocabqmT7zqRzKM,212
+loopcut-0.1.0.dist-info/licenses/LICENSE,sha256=jOtLnuWt7d5Hsx6XXB2QxzrSe2sWWh3NgMfFRetluQM,35147
+loopcut-0.1.0.dist-info/METADATA,sha256=GyAY9ZYk5h7bapU7wWcgn0tXOzp21AwUpshvP2TwHUU,10958
+loopcut-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+loopcut-0.1.0.dist-info/entry_points.txt,sha256=uZ6M5Aq3Eba9bsHcDb1T9wtke5rQF0pLFOdQhDSNsZs,45
+loopcut-0.1.0.dist-info/top_level.txt,sha256=Ea17ZV-WdAtQTBeD13TOslzcQswftry0C2_UNpDVWHw,8
+loopcut-0.1.0.dist-info/RECORD,,

loopcut-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

loopcut-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+loopcut = loopcut.cli:main