n8n-nodes-valora

Custom n8n nodes for Valora AI Memory Platform - Seamlessly integrate AI memory management and cross-platform chat export into your automation workflows.

🚀 Features

• Memory Management: Create, read, update, delete memories with full metadata support
• Chat Import: Import conversations from any AI platform (Claude, ChatGPT, etc.)
• Cross-Platform Export: Export conversations to 6+ AI platform formats
• Webhook Triggers: React to memory changes in real-time
• Semantic Search: Find memories using natural language queries
• Enterprise Ready: Production-grade error handling and logging

📦 Installation

Option 1: npm (Recommended)

npm install n8n-nodes-valora

Option 2: Manual Installation

1. Clone this repository
2. Run npm install
3. Run npm run build
4. Copy the dist folder to your n8n custom nodes directory

Option 3: From GitHub

npm install https://github.com/yorbuachi72/valora-memory-server.git#n8n-nodes-valora

⚙️ Setup

1. Add to n8n

In your n8n instance, go to Settings > Community Nodes and add:

n8n-nodes-valora

2. Configure Credentials

Create a new credential of type "Valora API":

• Server URL: http://localhost:3000 (or your Valora instance URL)
• API Key: Your Valora API key

3. Verify Connection

Use the Test button in credentials to ensure your Valora instance is accessible.

🎯 Available Nodes

Valora (Regular Node)

The main node for all Valora operations.

Memory Operations

• Create: Store new memories with tags and metadata
• Get: Retrieve specific memories by ID
• Search: Semantic search through all memories
• Update: Modify existing memories
• Delete: Remove memories

Chat Operations

• Import: Import chat conversations from JSON

Export Operations

• Conversation: Export conversations to AI platforms
• Formats: List available export formats

Valora Trigger (Webhook Node)

Triggers workflows when Valora events occur.

Supported Events

• memory.created - New memory added
• memory.updated - Memory modified
• memory.deleted - Memory removed
• chat.imported - Chat conversation imported
• search.performed - Memory search executed
• export.completed - Export operation finished

📋 Workflow Examples

1. Cross-Platform AI Transfer

Scenario: Transfer a Claude conversation to ChatGPT

[Manual Trigger] → [Valora: Import Chat] → [Valora: Export to OpenAI] → [HTTP Request: Send to ChatGPT]

Configuration:

• Import Chat: Set source to "claude", paste conversation JSON
• Export: Choose "openai" format
• HTTP Request: POST to ChatGPT API with exported messages

2. Memory Change Notifications

Scenario: Slack notifications for important memories

[Valora Trigger: memory.created] → [Filter: tag=important] → [Slack: Send Message]

Configuration:

• Valora Trigger: Select "memory.created" event
• Filter: Check if memory tags contain "important"
• Slack: Send formatted message with memory content

3. Automated Research Pipeline

Scenario: Web scraping → AI summarization → Memory storage

[HTTP Request: Scrape URL] → [OpenAI: Summarize] → [Valora: Create Memory]

Configuration:

• HTTP Request: Scrape target website
• OpenAI: Prompt to summarize content
• Valora: Store summary as memory with research tags

4. Scheduled Backup

Scenario: Daily backup of all memories to Google Drive

[Cron: Daily] → [Valora: Search *] → [Google Drive: Upload JSON]

Configuration:

• Cron: Schedule for daily execution
• Valora: Search with "*" query, limit 1000
• Google Drive: Upload formatted JSON backup

🔧 Node Reference

Valora Node Properties

Common Parameters

• Resource: memory, chat, or export
• Operation: Action within the selected resource

Memory Create/Update

Content: The memory text content
Source: Origin (e.g., "n8n", "manual")
Tags: Comma-separated tags

Memory Search

Query: Search terms or natural language
Limit: Maximum results (1-100)
Tags: Filter by specific tags

Chat Import

Messages: JSON array of chat messages
Source: Platform (claude, chatgpt, etc.)
Conversation ID: Optional unique identifier

Export Conversation

Conversation ID: ID from imported chat
Target Platform: openai, claude, gemini, mistral, llama, universal

Valora Trigger Properties

Event Selection

• Choose which events trigger the workflow
• Multiple events can be selected

Response Data

• All: Complete webhook payload
• Data Only: Just the event data

🔗 Integration Examples

With Slack Notifications

{
  "nodes": [
    {
      "type": "n8n-nodes-valora.valoraTrigger",
      "parameters": {
        "events": ["memory.created"],
        "responseData": "all"
      }
    },
    {
      "type": "@n8n/nodes-base.slack",
      "parameters": {
        "text": "New memory: {{ $json.data.content.substring(0, 100) }}..."
      }
    }
  ]
}

With HTTP APIs

{
  "nodes": [
    {
      "type": "n8n-nodes-valora.valora",
      "parameters": {
        "resource": "memory",
        "operation": "create",
        "content": "API response data",
        "tags": "api,response"
      }
    }
  ]
}

🛠️ Development

Prerequisites

• Node.js 16+
• npm or yarn
• n8n instance for testing

Local Development

# Clone and setup
git clone https://github.com/yorbuachi72/valora-memory-server.git
cd valora-memory-server/n8n-nodes-valora

# Install dependencies
npm install

# Build
npm run build

# Test
npm test

Adding New Features

1. Add node logic in nodes/YourNode/YourNode.node.ts
2. Update package.json node declarations
3. Add credentials if needed
4. Update documentation

📊 API Compatibility

| Valora Version | n8n-nodes-valora | Status | |----------------|------------------|--------| | v2.0.0+ | v1.0.0+ | ✅ Compatible |

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass
5. Submit a pull request

📝 License

MIT License - see LICENSE file for details.

🆘 Support

• Documentation: Valora Docs
• Issues: GitHub Issues
• Discussions: GitHub Discussions

🎯 Roadmap

• [ ] OAuth authentication support
• [ ] Bulk operations for multiple memories
• [ ] Advanced filtering and search options
• [ ] Memory templates and presets
• [ ] Integration with popular AI platforms
• [ ] Visual memory relationship mapping

Built with ❤️ for the AI automation community

Transform your AI conversations into actionable, searchable, and transferable knowledge with Valora + n8n!