n8n-nodes-hebbrix

Hebbrix community nodes for n8n - AI Memory Layer integration for intelligent workflow automation.

Overview

This package provides n8n nodes for integrating with Hebbrix, an AI Memory Layer that enables you to store, search, and recall knowledge for intelligent applications.

Features

• Memory Management: Create, update, delete, and retrieve memories
• AI-Powered Search: Hybrid search combining vector, BM25, and graph-based retrieval
• Chat Completions: AI chat with automatic memory context injection
• Document Processing: Upload and process documents into memories
• Collection Management: Organize memories into collections
• User Profiles: Manage AI personalization profiles
• Real-time Webhooks: Trigger workflows on memory events with HMAC signature verification

Installation

Community Node Installation (Recommended)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-hebbrix
4. Click Install

Manual Installation

# Navigate to your n8n installation
cd ~/.n8n

# Install the package
npm install n8n-nodes-hebbrix

Docker Installation

Add to your docker-compose.yml:

environment:
  - N8N_CUSTOM_EXTENSIONS=n8n-nodes-hebbrix

Or install via the CLI:

docker exec -it n8n npm install n8n-nodes-hebbrix

Authentication

1. Get your Hebbrix API key from the dashboard at https://app.hebbrix.com
2. In n8n, go to Credentials > New Credential
3. Search for "Hebbrix API"
4. Enter your API key (starts with mem_sk_)
5. Optionally customize the API URL for self-hosted instances

Nodes

Hebbrix Node

The main action node for interacting with the Hebbrix API.

Resources & Operations

Memory

Search

Chat

Document

Collection

Profile

Hebbrix Trigger Node

Webhook-based trigger node for real-time event handling.

Events

Security Features

• HMAC-SHA256 Signatures: All webhook payloads are signed
• Timestamp Validation: 5-minute window to prevent replay attacks
• Constant-time Comparison: Prevents timing attacks

Usage Examples

Create a Memory from Email

{
  "nodes": [
    {
      "name": "Email Trigger",
      "type": "n8n-nodes-base.emailTrigger"
    },
    {
      "name": "Hebbrix",
      "type": "n8n-nodes-hebbrix.hebbrix",
      "parameters": {
        "resource": "memory",
        "operation": "create",
        "content": "={{$node[\"Email Trigger\"].json[\"subject\"]}}: {{$node[\"Email Trigger\"].json[\"text\"]}}",
        "sourceType": "email",
        "importance": 0.7
      }
    }
  ]
}

Search and Reply with AI

{
  "nodes": [
    {
      "name": "Slack Trigger",
      "type": "n8n-nodes-base.slackTrigger"
    },
    {
      "name": "Hebbrix Chat",
      "type": "n8n-nodes-hebbrix.hebbrix",
      "parameters": {
        "resource": "chat",
        "operation": "complete",
        "message": "={{$node[\"Slack Trigger\"].json[\"text\"]}}",
        "model": "gpt-4o",
        "useMemory": true,
        "useProfile": true
      }
    },
    {
      "name": "Slack Reply",
      "type": "n8n-nodes-base.slack",
      "parameters": {
        "text": "={{$node[\"Hebbrix Chat\"].json[\"response\"]}}"
      }
    }
  ]
}

Webhook Trigger to Process New Memories

{
  "nodes": [
    {
      "name": "Memory Created",
      "type": "n8n-nodes-hebbrix.hebbrixTrigger",
      "parameters": {
        "events": ["memory.created"]
      }
    },
    {
      "name": "IF High Importance",
      "type": "n8n-nodes-base.if",
      "parameters": {
        "conditions": {
          "number": [
            {
              "value1": "={{$node[\"Memory Created\"].json[\"importance\"]}}",
              "operation": "larger",
              "value2": 0.8
            }
          ]
        }
      }
    },
    {
      "name": "Send Notification",
      "type": "n8n-nodes-base.slack"
    }
  ]
}

Configuration

Environment Variables

Self-Hosted Setup

For self-hosted Hebbrix instances, update the API URL in your credentials:

API URL: https://your-hebbrix-instance.com

Development

Building from Source

# Clone the repository
git clone https://github.com/hebbrix/n8n-nodes-hebbrix.git
cd n8n-nodes-hebbrix

# Install dependencies
npm install

# Build the project
npm run build

# Link for local development
npm link

# In your n8n installation
npm link n8n-nodes-hebbrix

Running Tests

npm test

Project Structure

n8n-nodes-hebbrix/
├── credentials/
│   └── HebbrixApi.credentials.ts    # API authentication
├── nodes/
│   ├── Hebbrix/
│   │   ├── Hebbrix.node.ts          # Main action node
│   │   └── hebbrix.svg              # Node icon
│   └── HebbrixTrigger/
│       └── HebbrixTrigger.node.ts   # Webhook trigger node
├── package.json
├── tsconfig.json
└── README.md

API Reference

For detailed API documentation, visit: https://docs.hebbrix.com/api

Support

• Documentation: https://docs.hebbrix.com
• Issues: https://github.com/hebbrix/n8n-nodes-hebbrix/issues
• Discord: https://discord.gg/hebbrix

License

MIT License - see LICENSE for details.

Changelog

v1.0.0

• Initial release
• Memory CRUD operations
• Hybrid, vector, and BM25 search
• Chat completions with memory context
• Document processing
• Collection management
• Webhook triggers with HMAC verification