n8n-nodes-roleplay-ai

Overview

A specialized n8n node for role-playing AI integration. This node allows you to create and customize character-based AI interactions through any compatible LLM API, inhereing the system prompt style from Silly Tarven.

Acknowledgment

This node is developed based on n8n-nodes-grok by @jvkassi and has been refactored with Claude 3.7 to specialize in roleplay AI interactions with broader API compatibility, appreciate all the work done by @jvkassi.

Installation

1. Navigate to Settings > Community Nodes in your n8n instance
2. Select "Install"
3. Enter n8n-nodes-roleplay-ai
4. Complete installation and restart n8n

Requirements

• An API key from any OpenAI-compatible AI service
• Base URL of the AI service endpoint

Configuration

Credentials Setup

1. Create a new credential of type "Roleplay AI API"
2. Enter your API key
3. Configure your API settings:
   • API URL: You can freely set your own base URL. The format should include the /v1 path (e.g., https://openrouter.ai/api/v1, https://api.anthropic.com/v1, etc.)
   • Provider Type: This is only used to determine the method for retrieving the model list. Select either "OpenRouter/OpenAI" or "Anthropic" based on your API provider.
4. Save your credentials

Node Configuration

1. Add the "Roleplay AI" node to your workflow

2. Configure the following essential parameters:

   • Character Name: Name of the AI character
   • Character Description: Details about the character's personality and role
   • First Message: Initial message from the character

3. Optional parameters:

   • Scenario: Background context for the conversation
   • Message Examples: Sample exchanges to establish conversation style
   • Format Guidelines: Formatting instructions for responses
   • Model Preset: Model behavior instructions
   • Other Pre-Message: Additional context or instructions

Features

• Service Flexibility: Compatible with any OpenAI-compliant API
• Customizable Characters: Detailed character creation options
• Raw Output Support: Option to include full conversation history in structured format(for memory storage or other data manipulation)

Usage Examples

Basic Character Setup

Character Name: Assistant
Character Description: A professional AI assistant with expertise in technical subjects.
First Message: "Hello, I'm your professional assistant. How can I help you today?"

Specialized Character Configuration

Character Name: Dr. Watson
Character Description: A medical professional with expertise in diagnostics
Scenario: A virtual medical consultation environment
Format Guidelines: Always structure responses with "Assessment:" and "Recommendations:" sections
First Message: "Good day. I'm Dr. Watson. Please describe your symptoms in detail."

Support

For assistance with this node:

• Refer to n8n documentation
• Join the n8n community forum

License

MIT