n8n-nodes-pisama
v0.2.0
Published
n8n community node that forwards workflow executions to Pisama for failure detection and self-healing
Maintainers
Readme
n8n-nodes-pisama
An n8n community node that forwards workflow executions to Pisama for failure detection and self-healing.
Without this node, integrating n8n with Pisama requires wiring an HTTP Request node by hand, computing HMAC signatures yourself, and shaping the payload to match the Pisama webhook contract. With this node, you drop "Pisama" on any workflow, authenticate once, and every subsequent execution is analyzed.
What Pisama detects in n8n workflows
- Structural: cycles, missing error handlers, schema mismatches between nodes, excessive branching
- Runtime: token/cost budget overruns, AI node timeouts, unprotected LLM calls, resource exhaustion
- Semantic (when LLM nodes are present): loops, hallucinations, context neglect, coordination breakdown across sub-agents
See docs.pisama.ai/integrations/n8n for the full detector list.
Install
In n8n's community nodes settings, enter n8n-nodes-pisama and install. Restart n8n. The Pisama node will appear in the node picker.
Configure
- Get your API key at pisama.ai/settings/api-keys (starts with
pisama_) - In n8n: Credentials → New → Pisama API
- Paste the key. If you've registered this workflow in Pisama (optional, enables HMAC verification), paste the webhook secret too
- Save
Use
Add a Pisama node at the end of any workflow whose executions you want analyzed. Set Operation to "Send Execution". No other config needed.
The node ships per-node outputs, workflow metadata, and (optionally) the workflow definition for structural checks. Analysis runs in the background on Pisama's side — the node returns immediately.
Self-hosted Pisama
Set the API URL field in credentials to your own deployment (e.g., https://pisama.your-company.com/api/v1). All other behavior is identical.
License
MIT
