n8n Integration

Integrate Demeterics with n8n to access multiple AI providers through a unified API with built-in observability, analytics, and cost tracking in your workflow automations.

Overview

The n8n-nodes-demeterics community node package provides five powerful nodes:

1. Demeterics Chat Model - LangChain-compatible AI model for use with n8n's AI chains and agents
2. Demeterics Speech Gen - Text-to-speech generation across OpenAI, ElevenLabs, and Google
3. Demeterics Image Gen - Image generation across OpenAI DALL-E, Google Imagen, and Stability AI
4. Demeterics Conversion - Track business outcomes and metrics linked to LLM interactions
5. Demeterics Extract - Export interaction data for analysis, compliance, or data pipelines

Package: n8n-nodes-demeterics
npm: npmjs.com/package/n8n-nodes-demeterics
GitHub: github.com/bluefermion/n8n-nodes-demeterics

Installation

Method 1: GUI Install (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install
3. Enter n8n-nodes-demeterics and confirm
4. Restart n8n if prompted

Method 2: Docker with Custom Dockerfile

Create a Dockerfile:

FROM n8nio/n8n:latest

USER root
RUN npm install -g n8n-nodes-demeterics
USER node

Update docker-compose.yml:

version: '3.8'
services:
  n8n:
    build:
      context: .
      dockerfile: Dockerfile
    restart: unless-stopped
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

Build and start:

docker-compose build
docker-compose up -d

Method 3: Docker Volume Mount

# Install locally
mkdir -p ~/n8n-custom-nodes
cd ~/n8n-custom-nodes
npm install n8n-nodes-demeterics

Add to docker-compose.yml:

volumes:
  - ~/n8n-custom-nodes/node_modules/n8n-nodes-demeterics:/home/node/.n8n/custom/node_modules/n8n-nodes-demeterics

Method 4: Non-Docker Installation

cd ~/.n8n
npm install n8n-nodes-demeterics

Restart n8n after installation.

Setting Up Credentials

1. Get Your API Key

1. Sign up or log in at demeterics.ai
2. Navigate to API Keys in your dashboard
3. Click Create API Key
4. Copy your API key (format: dmt_xxx...)

2. Add Credentials in n8n

1. Go to Credentials in n8n
2. Click Add Credential
3. Search for "Demeterics API"
4. Configure your credentials:

5. Click Save

Authentication Modes

Managed Key (Default): Use only your Demeterics API key. Demeterics manages provider credentials on your behalf.

Bring Your Own Key (BYOK): Toggle BYOK on and provide your own provider API keys. Only add keys for providers you'll actually use.

Node 1: Demeterics Chat Model

The Demeterics Chat Model provides access to multiple AI providers and works with n8n's AI nodes.

Compatible AI Nodes

• AI Agent - Build intelligent agents with tool use
• Basic LLM Chain - Simple prompt → response workflows
• Summarization Chain - Summarize documents
• Question and Answer Chain - RAG-based Q&A

Basic Workflow Example

[Chat Trigger] → [AI Agent] ← [Demeterics Chat Model]
                     ↑
                  [Tools]

1. Add a Chat Trigger node
2. Add an AI Agent node
3. Connect Demeterics Chat Model to the AI Agent's "Chat Model" input
4. Select your provider and model
5. Add tools as needed (Calculator, Code, HTTP Request, etc.)

Configuration Options

Supported Providers & Models

Groq (Fastest Inference)

OpenAI

Anthropic

Google

OpenRouter

Node 2: Demeterics Speech Gen

Generate natural-sounding speech from text using multiple TTS providers through a single node.

Configuration Options

Input

Output

Supported Providers

OpenAI

ElevenLabs

Google Cloud TTS

Basic Workflow Example

[Webhook] → [Demeterics Speech Gen] → [HTTP Response with audio URL]

1. Receive text input via webhook
2. Generate speech using Demeterics Speech Gen
3. Return the audio URL to the caller

Use Cases

• Voice Assistants - Generate spoken responses for chatbots
• Content Creation - Convert articles and posts to audio
• Accessibility - Provide audio versions of text content
• Notifications - Generate audio alerts and announcements
• Podcasting - Create AI-narrated podcast content

Node 3: Demeterics Image Gen

Generate images from text prompts using multiple providers through a single node.

Configuration Options

Input

Output

Supported Providers

OpenAI DALL-E

Google Imagen

Stability AI

Basic Workflow Example

[HTTP Trigger] → [Demeterics Image Gen] → [Upload to S3] → [HTTP Response]

1. Receive image description via HTTP trigger
2. Generate image using Demeterics Image Gen
3. Upload to permanent storage (S3, GCS, etc.)
4. Return the permanent URL

Use Cases

• Marketing Content - Generate ad visuals and social media images
• Product Design - Create concept images and mockups
• E-commerce - Generate product variations and lifestyle images
• Creative Tools - Power image generation features in your apps
• Content Pipelines - Automate thumbnail and header image creation

Node 4: Demeterics Conversion

Track business outcomes and metrics linked to your LLM interactions using cohort IDs.

Operations

Submit Outcome

Submit or update conversion metrics for a cohort.

Example:

{
  "cohort_id": "campaign_001",
  "outcome": 95,
  "outcome_v2": 150,
  "label": "7d engagement",
  "event_date": "2025-01-15"
}

Get Outcome

Retrieve conversion information for a cohort.

Use Cases

• Performance Tracking - Link LLM interactions to business outcomes
• A/B Testing - Compare results across different prompt variations
• Model Comparison - Track metrics per provider/model combination
• Campaign Analysis - Monitor effectiveness of AI-generated content
• Conversion Attribution - Measure ROI of LLM features

Node 5: Demeterics Extract

Export interaction data from Demeterics for analysis, compliance, or data pipeline integration.

Operations

Export Interactions (Simple)

Create an export and immediately fetch its contents.

Returns:

• JSON: Parsed items as individual workflow items
• CSV/Avro: Binary file attachments for downstream processing

Create Export Job

Create an export request and return the request ID for async processing.

Stream Export by Request ID

Fetch data for an existing export request ID.

Available Tables

Use Cases

• Data Analysis - Export to analytics tools (BigQuery, Tableau, etc.)
• Compliance Auditing - Full interaction logs for audit trails
• Model Training - Use interactions as training data
• Cost Analysis - Detailed cost breakdowns
• Data Pipeline - Integrate into ETL workflows

Workflow Examples

Example 1: AI Agent with Multi-Provider Fallback

[HTTP Trigger] → [AI Agent + Demeterics Chat Model (Groq)]
                        ↓ (on error)
               [AI Agent + Demeterics Chat Model (Anthropic)]
                        ↓
               [Demeterics Conversion (submit outcome)]
                        ↓
               [HTTP Response]

Example 2: Daily Performance Export

[Schedule Trigger (daily)] → [Demeterics Extract]
                                    ↓
                            [Transform to metrics]
                                    ↓
                            [Save to database]

Example 3: Conversion Attribution

[User Event] → [Save cohort_id] → [Call LLM with cohort_id]
                                          ↓
                                   [Process response]
                                          ↓
                                   [Wait for conversion]
                                          ↓
                              [Demeterics Conversion (submit)]

Benefits of Using Demeterics

Unified API

Access all major AI providers through a single credential. Switch between Groq, OpenAI, Anthropic, and Google without changing your workflow.

Cost Tracking

Every request is automatically logged to your Demeterics dashboard. See exactly what each workflow costs in real-time.

Full Observability

Log every prompt, response, and token for debugging and compliance. Understand usage patterns and performance metrics.

No Vendor Lock-in

Switch providers anytime without code changes. Compare performance across providers easily.

Troubleshooting

Node Not Appearing

• Restart n8n completely after installing the community node
• Check that the installation completed successfully in Settings > Community Nodes
• Clear browser cache and refresh

Authentication Errors

• Verify your API key format starts with dmt_
• Check that your API key is active at demeterics.ai/api-keys
• Ensure the Base URL is set to https://api.demeterics.com (default)
• For BYOK mode, ensure at least one provider key is configured

Model Not Working

• Check the API Reference for the latest supported models
• Verify the model is enabled for your account
• Check your credit balance at demeterics.ai

Export Issues

• Verify date range is valid (start date ≤ end date)
• Check date format is YYYY-MM-DD
• Ensure selected tables have data in the specified range

Resources

• GitHub Repository
• npm Package
• API Reference
• Credits & Pricing
• n8n Community Nodes Documentation

Support

• Documentation: demeterics.ai/docs
• GitHub Issues: Report a bug
• Email: support@demeterics.com