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 - [email protected]

🔗 Links

• AivenceRealty CRM
• Repositorio GitHub
• Reportar Issues