nebula

n8n nodes for Nebula - Human-in-the-Loop (HITL) requests with configurable REST API backend

Package Information

Downloads: 358 weekly / 371 monthly

Latest Version: 1.1.5

Author: Joost Faassen

Available Nodes

Nebula Action

Execute Nebula Actions via the Nebula API

Nebula HITL Request

Send Human-in-the-Loop requests via Nebula and wait for responses

Nebula Trigger

Starts the workflow when called from Nebula with form data. The form definition is exposed via n8n API for Nebula to fetch and present to users.

Documentation

n8n-nodes-nebula

A collection of custom n8n nodes for integrating with Nebula - enabling Human-in-the-Loop (HITL) workflows, action execution, and webhook-based triggers.

Nodes

Node	Description
Nebula HITL Request	Create human approval/input requests that pause workflow execution until a human responds
Nebula Action	Execute Nebula Actions via the Nebula API
Nebula Trigger	Webhook-based trigger that starts workflows with Survey.js form data

Credentials

Credential	Description
Nebula API	Authentication for outbound requests to Nebula
Nebula Trigger Auth	Authentication for incoming webhook requests

See the credentials documentation for setup instructions.

Installation

Prerequisites

n8n version 1.0.0 or later
Node.js 18.10 or later
pnpm (recommended) or npm

Install via npm (Community Nodes)

In your n8n instance, go to Settings → Community Nodes and install:

n8n-nodes-nebula

Manual Installation (Self-hosted n8n)

Clone or download this repository:

cd ~/.n8n/custom
git clone https://github.com/linkorb/n8n-nodes-nebula.git
cd n8n-nodes-nebula

Install dependencies:

pnpm install

Build the node:

pnpm build

Restart n8n:

# If running n8n directly
n8n start

# If running via PM2
pm2 restart n8n

# If running via Docker
docker restart n8n

Installation with Docker

If you're running n8n in Docker, you can mount the custom nodes:

version: '3.8'
services:
  n8n:
    image: n8nio/n8n
    volumes:
      - ~/.n8n:/home/node/.n8n
      - ./n8n-nodes-nebula:/home/node/.n8n/custom/n8n-nodes-nebula
    environment:
      - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom

Quick Start

1. Set Up Credentials

In n8n, go to Credentials → Add Credential
Search for "Nebula API" and configure your Nebula instance connection
See credentials documentation for details

2. Use a Node

For human approvals: Use the Nebula HITL Request node
For executing actions: Use the Nebula Action node
For triggering workflows: Use the Nebula Trigger node

Development

Project Structure

n8n-nodes-nebula/
├── credentials/
│   ├── NebulaApi.credentials.ts      # Outbound API authentication
│   ├── NebulaTriggerAuth.credentials.ts  # Inbound webhook authentication
│   └── README.md                     # Credentials documentation
├── nodes/
│   ├── NebulaAction/                 # Execute Nebula actions
│   ├── NebulaHitlRequest/            # Human-in-the-loop requests
│   ├── NebulaTrigger/                # Webhook trigger with forms
│   └── README.md                     # Nodes overview
├── package.json
├── tsconfig.json
└── README.md

Building from Source

# Install dependencies
pnpm install

# Build
pnpm build

# Watch mode (for development)
pnpm dev

# Lint
pnpm lint

# Format
pnpm format

Troubleshooting

Node not appearing in n8n

Ensure the build completed successfully (pnpm build)
Check that the dist folder contains compiled JS files
Verify the custom nodes path in n8n configuration
Restart n8n completely

Authentication errors

Verify credentials in n8n are correct
Check your backend's authentication logic
Look at the backend logs for more details

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

License

MIT License - see LICENSE file for details.

Related Projects

n8n - Fair-code workflow automation
n8n documentation on creating nodes
Survey.js - Form library used for form definitions

Support

Create an issue on GitHub for bug reports
Discussions for questions and feature requests

nebulaInstall