graphai

Nodo n8n para AivenceGraph - Sistema de Memoria IA

Package Information

Released: 10/10/2025
Downloads: 0 weekly / 163 monthly
Latest Version: 1.0.1
Author: Federico Aivence

Documentation

n8n-nodes-aivencegraph

Nodo n8n para AivenceGraph - Sistema de IA y Memoria con Neo4j + Groq LLM.

Este paquete permite interactuar con AivenceGraph, el sistema de memoria inteligente que combina Neo4j (base de datos de grafos) con Groq LLM para análisis conversacional avanzado.

📦 Instalación

npm install n8n-nodes-aivencegraph

O desde la interfaz de n8n: Community Nodes → Install y escribir n8n-nodes-aivencegraph.

🔐 Configuración

  1. Obtén un Bearer Token de AivenceGraph
  2. En n8n, ve a Credentials y crea credenciales de tipo AivenceGraph API
  3. Introduce:
    • URL Base: https://realty.aivence.com (o tu dominio)
    • Bearer Token: Tu token de API
  4. Guarda las credenciales

📋 Operaciones Disponibles

🏥 Health Check

Verifica el estado completo del sistema AivenceGraph:

  • Estado de Neo4j
  • Estado de Groq LLM
  • Estado de Embedding Service
  • Tiempos de respuesta

🤖 Test Groq

Prueba la conexión con Groq LLM y verifica que el modelo está respondiendo correctamente.

🧠 Test Embedding

Prueba la generación de embeddings vectoriales para búsqueda semántica.

📊 Test Neo4j

Verifica la conexión con la base de datos Neo4j y comprueba el estado del grafo de conocimiento.

🎯 Ejemplo de Uso

Workflow de Monitoreo

{
  "nodes": [
    {
      "name": "Schedule",
      "type": "n8n-nodes-base.scheduleTrigger",
      "parameters": {
        "rule": {
          "interval": [{ "field": "minutes", "minutesInterval": 5 }]
        }
      }
    },
    {
      "name": "Check AivenceGraph",
      "type": "n8n-nodes-aivencegraph.AivenceGraph",
      "parameters": {
        "operation": "health"
      },
      "credentials": {
        "aivenceGraphApi": "AivenceGraph Credentials"
      }
    }
  ]
}

🔧 Desarrollo Local

# Clonar repositorio
git clone https://github.com/aivence/n8n-nodes-aivencegraph.git
cd n8n-nodes-aivencegraph

# Instalar dependencias
npm install

# Compilar
npm run build

# Vincular localmente
npm link
cd ~/.n8n
npm link n8n-nodes-aivencegraph

# Iniciar n8n
n8n start

📝 Changelog

v0.1.0 (2025-10-09)

  • 🎉 Versión inicial
  • ✅ 4 operaciones de testing y health check
  • ✅ Integración completa con Neo4j + Groq

🏗️ Arquitectura

AivenceGraph combina:

  • Neo4j: Base de datos de grafos para relaciones complejas
  • Groq LLM: Modelo de lenguaje para análisis conversacional
  • Embedding Service: Generación de vectores para búsqueda semántica

📄 Licencia

MIT

👨‍💻 Autor

Federico Aivence - federico@aivence.com

🔗 Links

Discussion