Kosinkadink
cf55bd58ae
ComfyUI custom-node package that fetches node descriptors from an
RNP/1 (Remote Node Protocol v1) server and exposes them as native V3
nodes inside ComfyUI.
Includes:
- Manifest + capability handshake, ETag-conditional object_info fetch
- Sync execute_remote and async _run_async_polling flows via
comfy_api_nodes.util.client.poll_op_raw
- Image / mask / audio / video envelope encode + decode
- Presigned upload helper for >8 MiB inputs
- Tier 3:
* TASK_LOST detection + idempotent resume — survives an RNP server
restart mid-task
* SERVER_BUSY / MAINTENANCE 503 envelopes treated as rate limits
with Retry-After honoring and friendly per-second progress text
* Out-of-band url_fetch for URI-only output envelopes per the
descriptor's remote.url_fetch policy
* Per-poll auth refresh so long-running tasks pick up rotated tokens
Pairs with Comfy-Org/comfy-rnp-server (private) as the reference
server implementation.
63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
# comfy-remote-nodes
|
|
|
|
ComfyUI custom-node package that fetches node descriptors from an
|
|
**RNP/1** (Remote Node Protocol v1) server and exposes them as native
|
|
V3 nodes inside ComfyUI.
|
|
|
|
The reference server lives at
|
|
[`Comfy-Org/comfy-rnp-server`](https://github.com/Comfy-Org/comfy-rnp-server)
|
|
(private). This client is intentionally provider-agnostic: any server
|
|
that speaks RNP/1 can publish nodes through it.
|
|
|
|
## Install
|
|
|
|
Clone into your ComfyUI `custom_nodes/` directory:
|
|
|
|
```bash
|
|
cd ComfyUI/custom_nodes
|
|
git clone https://github.com/Comfy-Org/comfy-remote-nodes.git
|
|
```
|
|
|
|
(The directory name on disk doesn't matter — ComfyUI loads the package
|
|
via `spec_from_file_location`, so `comfy-remote-nodes/` is fine.)
|
|
|
|
## Configure
|
|
|
|
Point the extension at one RNP server URL via env var before starting
|
|
ComfyUI:
|
|
|
|
```bash
|
|
export RNP_SERVER_URL=http://127.0.0.1:9190
|
|
python main.py
|
|
```
|
|
|
|
If `RNP_SERVER_URL` is unset, the extension registers zero nodes and
|
|
logs a single line — ComfyUI starts normally with no remote nodes.
|
|
|
|
## What works today
|
|
|
|
* Manifest + capability handshake
|
|
* `object_info` fetch and dynamic V3 class generation (with ETag
|
|
conditional GETs)
|
|
* Sync `execute` and async `execute_async` + poll/cancel
|
|
* Image / mask / audio / video envelope encode + decode
|
|
* Presigned upload helper for >8 MiB inputs
|
|
* **Tier 3** (recent):
|
|
* `TASK_LOST` detection with idempotent resubmission — survives an
|
|
RNP server restart mid-task without losing the workflow
|
|
* `SERVER_BUSY` / `MAINTENANCE` 503 envelopes treated as rate
|
|
limits with `Retry-After` honoring and friendly per-second
|
|
progress text ("Server busy, retrying in 30s...")
|
|
* Out-of-band `url_fetch` for URI-only output envelopes, driven by
|
|
the descriptor's `remote.url_fetch` policy
|
|
* Per-poll auth refresh so long-running tasks can rotate tokens
|
|
|
|
## What does not (yet)
|
|
|
|
* `validate_inputs` / `fingerprint_inputs` / `check_lazy_status` —
|
|
the server returns `501 NOT_IMPLEMENTED`; the client falls through
|
|
to ComfyUI's defaults
|
|
* Multi-server config file (`comfy_remote_nodes.yaml` or similar) —
|
|
today's setup is one server per ComfyUI process via env var
|
|
* Streaming execute (server-sent events for incremental previews)
|