nodesafe 0.3.1

Security scanner for ComfyUI custom nodes and node-based workflow plugins

nodesafe

Security scanner for ComfyUI custom nodes — and the emerging standard for node-based workflow plugin security.

nodesafe scans third-party plugins/nodes before you install them in node-based workflow tools, detecting malicious code with a cascading pipeline that combines static analysis, signature matching, machine learning, and optional semantic analysis with an LLM. Starting point: the ComfyUI ecosystem.

[5-second GIF of the scanner detecting a malicious node — placeholder until v0.1]

Why this exists

In June 2024, ComfyUI_LLMVISION stole browser credentials and crypto wallets from hundreds of users. In April 2026, a botnet compromised 1,000+ ComfyUI instances by auto-installing malicious nodes via the Manager. The custom_nodes ecosystem is large, fast-moving, and largely unverified.

nodesafe scans before you install.

Quick start

pip install nodesafe
nodesafe scan /path/to/custom_node

Or directly without installing:

uvx nodesafe scan /path/to/custom_node

How it works

A 9-layer cascading pipeline. Each layer more expensive than the previous. Most clean nodes pass in <100ms; only ambiguous cases escalate.

Layer	Technique	Cost
0	Hash matching against malware database	μs
1	Bloom filter of malicious URLs	μs
2	Aho-Corasick over dangerous patterns	ms
3	AST analysis (optional Semgrep backend)	ms
4	Typosquatting + OSV vulnerability check	ms
5	ML classifier (Naive Bayes + XGBoost)	tens of ms
6	Anomaly detection (Isolation Forest + Autoencoder)	tens of ms
7	Semantic similarity (CodeBERT embeddings + FAISS)	hundreds of ms
8	LLM review (optional, local-first via Ollama)	seconds

Current state (v0.1): Layers 0 and 1 functional. Layers 2-3 in M1 sprint. The rest in the M2-M4 roadmap.

Features

• ✓ Pure static analysis — never executes scanned code
• ✓ Zero telemetry by default — this policy is immutable
• ✓ Works offline (after the first signature update)
• ✓ Multiple output formats: JSON, SARIF (GitHub Code Scanning), Markdown
• ✓ GitHub Action ready — see the example workflow
• ✓ Pre-commit hook ready — for CI/CD of custom_nodes repositories
• ✓ Local-first LLM analysis — Ollama by default, cloud opt-in with BYO key
• ✓ OSS Apache 2.0 — no freemium, no hidden SaaS, no paid whitelisting

Usage

Scan a directory

nodesafe scan /path/to/custom_node

JSON output

nodesafe scan /path/to/custom_node --format json

Integrate with GitHub Code Scanning (SARIF)

nodesafe scan custom_nodes/ --format sarif > nodesafe.sarif

Only cheap layers (fast, no ML)

nodesafe scan /path/to/custom_node --layers 0,1,2,3

Update signatures

nodesafe update

Verify installation

nodesafe doctor

Retrospective analysis

Would nodesafe have detected the historical incidents? We apply the pipeline mentally to each case:

Incident	Detection layer	Time	Verdict
LLMVISION (Jun 2024)	Layer 2-3	~30-50ms	malicious 0.98
Pickai (Mar-Jun 2025)	Layer 2-3 + 5-7	~100ms	malicious 0.92
Mining botnet (Apr 2026)	Layer 2-3 + Manager gate	<50ms	malicious 0.95

Full analysis in docs/retrospective-analysis.md.

Honest limitations

nodesafe is static analysis, not a sandbox. Its limits:

• It does not prevent upstream supply chain attacks (a legitimate provider being compromised). It detects the malware when it is distributed in nodes, not the original compromise.
• It is not a replacement for the Manager — it is complementary; ideally integrated.
• It does not monitor runtime behavior — that is the job of an IDS/EDR.
• False positives happen — the policy is conservative, but every flag shows exactly what triggered the alert so you can decide.

Configuration

~/.config/nodesafe/config.toml (optional — sane defaults):

[scanner]
default_layers = "0,1,2,3,4,5,6"   # Layer 8 NOT included by default
fail_on = "suspicious"

[llm]
enabled = false                     # OFF by default. Conscious opt-in.
provider = "local"                  # local-first if enabled

[llm.local]
endpoint = "http://localhost:11434" # Ollama
model = "qwen2.5-coder:7b-instruct"

[telemetry]
enabled = false                     # ALWAYS false. Immutable policy.

Roadmap

• v0.1 (M1, current): Layers 0-3, functional MVP, silent launch
• v0.5 (M2): Layer 5 ML + Semgrep + OSV integration + first public wave
• v1.0 (M3): Layers 6-7 + PR to ComfyUI-Manager + formal launch
• v1.5 (M4): Layer 8 LLM + public report + consolidated community
• v2+ (Year 2): .nodesafe standard portable to other node-based ecosystems

Full plan in ARCHITECTURE.md.

Contributing

PRs welcome. See CONTRIBUTING.md.

Especially welcome:

• Contributions of new malware signatures — see signatures/README.md
• False positive reports for legitimate nodes
• Missed detection reports — open an issue with the [missed-detection] tag
• Semgrep rules specific to ComfyUI / diffusion patterns

Acknowledgments

Inspired by HuggingFace's safetensors push, Snyk Labs' research on ComfyUI attack vectors, and the unfortunate work of u/roblaughter who discovered LLMVISION at his own cost.

License

Apache 2.0. See LICENSE.

Long-term vision

ComfyUI is the most urgent case, not the only one. The full category of node-based tools with executable plugins (LangFlow, Flowise, Node-RED, n8n, etc.) shares the same structural problem. In the long term, .nodesafe aspires to become a portable manifest artifact that any ecosystem can adopt — analogous to how .safetensors became the standard for ML model weights.

V2-V3 of the project formalizes the standard and works with maintainers of other ecosystems. Today, brutal focus on ComfyUI.