n8n community nodes for Aparavi DTC API. Run any workflow including PII/HIPAA anonymization, OCR, document parsing, audio transcription, and custom pipelines.
npm install n8n-nodes-aparaviA comprehensive n8n community node package that provides powerful data processing capabilities using the Aparavi DTC (Data Transformation Cloud) service. This package includes two specialized nodes for OCR, document parsing, audio transcription, and PII/HIPAA data anonymization.
> š Get Started: First, sign up for your free Aparavi API key at https://dtc.aparavi.com/usage
- npm Package: n8n-nodes-aparavi
- Version: 1.0.0
- GitHub Repository: AparaviSoftware/aparavi-n8n-node
- š§ Console Logging - Debug output for all operations
- š”ļø Project ID Fix - Automatically handles Aparavi project configuration
- š Flexible Input - Handles files, text, JSON, arrays, objects
- š Batch Processing - Efficiently processes multiple items
- ā” Real-time Processing - Fast and reliable data transformation
- š ļø Error Handling - Robust error handling with continue-on-fail support
- š Structure Preservation - Maintains original data structure while processing
#### Option A: Through n8n Community Nodes (Recommended)
1. Open n8n in your browser (usually http://localhost:5678)
2. Go to Settings ā Community Nodes
3. Click "Install a community node"
4. Enter package name: n8n-nodes-aparavi
5. Click "Install"
6. Restart n8n (if prompted)
#### Option B: Manual Installation
``bashInstall globally
npm install -g n8n-nodes-aparavi
#### Option C: Copy to Custom Nodes Directory
`bash
1. Install the package
npm install n8n-nodes-aparavi2. Copy to n8n custom nodes directory
cp -r node_modules/n8n-nodes-aparavi/dist ~/.n8n/custom/nodes/n8n-nodes-aparavi3. Install dependencies
cd ~/.n8n/custom/nodes/n8n-nodes-aparavi
npm install --production4. Restart n8n
n8n start
`$3
1. Go to Settings ā Credentials
2. Click "Add Credential"
3. Select "Aparavi API"
4. Enter your API key from Step 1
5. Click "Save"$3
Both nodes support custom base URL configuration:
#### Default Environment (Development)
- Base URL:
https://eaas-dev.aparavi.com (default)
- No configuration needed - works out of the box#### Production Environment
1. Add Aparavi DTC Node or Aparavi PII Censor Node
2. Click "Options" to expand advanced settings
3. Set "Custom Base URL":
https://eaas.aparavi.com
4. Save the workflow#### Custom Environment
1. Set "Custom Base URL" to your Aparavi API URL
2. Example:
https://your-custom.aparavi.com$3
#### Verify Nodes Are Available
- ā
Aparavi DTC appears in Transform category
- ā
Aparavi PII Censor appears in Transform category
- ā
Aparavi API appears in credentials list
#### Test with Simple Workflow
1. Create new workflow
2. Add Manual Trigger
3. Add Aparavi DTC node
4. Select "Simple OCR" operation
5. Enter file path:
/path/to/image.png
6. Execute workflow#### Expected Console Output
`
š Using default base URL: https://eaas-dev.aparavi.com
š Simple OCR - Processing file: /path/to/image.png
ā
Simple OCR - Result: { "status": "OK", "data": {...} }
`š Usage Examples
$3
#### Simple Parse (PDF Documents)
`
Operation: Simple Parse
Input: /path/to/document.pdf
Output: Extracted text, tables, and metadata
`#### Simple OCR (Images)
`
Operation: Simple OCR
Input: /path/to/image.png
Output: Extracted text from image
`#### Audio Transcription
`
Operation: Audio Transcribe
Input: /path/to/audio.mp3
Output: Transcribed text
`$3
#### Basic Text Censoring
Input:
`
"John Smith, SSN: 123-45-6789, Phone: (555) 123-4567, Email: john@example.com"
`Output:
`
"āāāā āāāā, SSN: āāā-āā-āāāā, Phone: (āāā) āāā-āāāā, Email: āāā@āāā.āāā"
`#### Object Processing
Input:
`json
{
"name": "Jane Doe",
"email": "jane.doe@example.com",
"ssn": "987-65-4321",
"phone": "(555) 987-6543"
}
`Output:
`json
{
"name": "āāāā āāāā",
"email": "āāāā@āāā.āāā",
"ssn": "āāā-āā-āāāā",
"phone": "(āāā) āāā-āāāā"
}
`#### HIPAA Healthcare Data
Input:
`json
{
"patientName": "Alice Williams",
"ssn": "111-22-3333",
"medicalRecord": "Patient Alice Williams has hypertension, prescribed Lisinopril 10mg"
}
`Output:
`json
{
"patientName": "āāāā āāāāāāā",
"ssn": "āāā-āā-āāāā",
"medicalRecord": "Patient āāāā āāāāāāā has hypertension, prescribed āāāāāāāā 10mg"
}
`š§ Console Logging
Both nodes include comprehensive console logging for debugging:
`
š Simple OCR - Processing file: /path/to/image.png
ā
Simple OCR - Result: { "status": "OK", "data": {...} }š Simple Parse - Processing file: /path/to/document.pdf
ā
Simple Parse - Result: { "status": "OK", "data": {...} }
`š Supported File Types
$3
- Parser: PDF, DOCX, TXT, HTML, and more
- OCR: PNG, JPG, JPEG, TIFF, BMP
- Audio: MP3, WAV, M4A, FLAC$3
- Text: Any text input
- JSON: Objects and arrays
- Files: Any file type (processed as text)š ļø Advanced Configuration
$3
Use the Custom Pipeline operation to run any Aparavi workflow:`json
{
"pipeline": {
"source": "webhook_1",
"components": [
{
"id": "webhook_1",
"provider": "webhook",
"config": {
"hideForm": true,
"mode": "Source",
"type": "webhook"
}
},
{
"id": "processor_1",
"provider": "your-provider",
"config": {
"your-config": "value"
},
"input": [
{
"from": "webhook_1",
"lane": "data"
}
]
}
]
}
}
`$3
Process only specific fields in your data:`json
{
"piiType": "usa",
"inputDataMode": "specific",
"fieldsToProcess": "name,ssn,email"
}
`š Error Handling
Both nodes include comprehensive error handling:
- Connection Errors: Handles API connection issues gracefully
- Validation Errors: Validates input data and parameters
- Processing Errors: Handles individual item processing failures
- Continue on Fail: Option to continue processing other items if one fails
- Automatic Cleanup: Properly disconnects and cleans up resources
š Output Structure
$3
`json
{
"status": "OK",
"data": {
"objectsRequested": 1,
"objectsCompleted": 1,
"types": { "text": "text" },
"objects": {
"object-id": {
"name": "filename.pdf",
"path": "filename.pdf",
"text": ["Extracted text content..."],
"table": [/ Extracted tables /],
"image": [/ Extracted images /],
"metadata": {
"Content-Type": "application/pdf",
"dc:created": "2025-09-19T21:56:14Z"
}
}
}
},
"metrics": {
"cpu": 2085.871,
"output": 10274,
"total_time": 2085.877,
"requests": 1
}
}
`$3
`json
{
"operation": "anonymizePII",
"result": {
"status": "OK",
"data": {
"objectsRequested": 1,
"objectsCompleted": 1,
"objects": {
"object-id": {
"name": "input.json",
"path": "input.json",
"text": ["Anonymized text content..."]
}
}
}
}
}
`š Development Setup
For developers who want to contribute or modify the nodes:
$3
- Node.js 16+
- npm or yarn
- n8n instance$3
`bash
Clone the repository
git clone https://github.com/AparaviSoftware/aparavi-n8n-node.git
cd aparavi-n8n-nodeInstall dependencies
npm installBuild the package
npm run buildStart n8n with custom nodes
./start-n8n-dev.sh
`$3
`bash
Test the SDK directly
node test-local-sdk.jsTest specific operations
node test-pipeline-debug.js
`š Documentation
- INSTALLATION.md - Detailed installation guide
- QUICK_START.md - Quick start guide
- LOCAL_SDK_SETUP.md - Local development setup
- TROUBLESHOOTING_PROJECT_ID.md - Troubleshooting guide
š§ Troubleshooting
$3
#### Nodes Don't Appear in n8n
`bash
Check if package is installed
npm list -g n8n-nodes-aparaviCheck n8n logs for errors
n8n start --log-level debugRestart n8n completely
Stop n8n (Ctrl+C)
n8n start
`#### Installation Errors
`bash
Clear npm cache
npm cache clean --forceReinstall latest version
npm install -g n8n-nodes-aparavi@latestCheck n8n version compatibility
n8n --version
`#### Permission Issues
`bash
Fix npm permissions
sudo chown -R $(whoami) ~/.npmOr use npx instead
npx n8n-nodes-aparavi-dtc
`#### Custom Base URL Not Working
- Check URL format: Must include
https:// or http://
- Verify URL accessibility: Test with curl -I https://your-url.com
- Check console logs: Look for base URL confirmation messages
- Default fallback: Leave empty to use https://eaas-dev.aparavi.com$3
After installation, verify:
- [ ] Nodes appear in Transform category
- [ ] Credentials available (Aparavi API)
- [ ] No errors in n8n console
- [ ] Can create workflows with the nodes
- [ ] API key works (test with Simple OCR)
- [ ] Console logging shows base URL
$3
#### Development Environment (
eaas-dev.aparavi.com)
- Default environment - no configuration needed
- May have pipeline conflicts - wait for existing pipelines to finish
- Console shows: š Using default base URL: https://eaas-dev.aparavi.com#### Production Environment (
eaas.aparavi.com)
- Requires custom base URL configuration
- More stable than dev environment
- Console shows: š Using custom base URL: https://eaas.aparavi.comš¤ Support
Need help? We're here to assist:
1. Aparavi Discord: Join our Discord community and visit the #technical-support channel
2. GitHub Issues: Report problems or request features
3. n8n Community: n8n Community Forum for n8n-specific questions
4. API Key Help: Get your free API key
š Changelog
$3
- ā
Custom Base URL Configuration - Users can now configure custom Aparavi API URLs
- ā
Environment Flexibility - Support for production, development, and custom environments
- ā
Enhanced Documentation - Comprehensive n8n connection and troubleshooting guide
- ā
Console Logging - Clear indication of which base URL is being used
- ā
Both Nodes Updated - Aparavi DTC and Aparavi PII Censor nodes support custom URLs$3
- ā
Dev Environment Default - Package now defaults to eaas-dev.aparavi.com
- ā
Updated API Configuration - All API calls point to development environment
- ā
Console Logging - Debug output shows environment URL$3
- ā
Updated README - Comprehensive documentation with both nodes
- ā
Console Logging - Debug output for all operations
- ā
Project ID Fix - Automatic handling of Aparavi project configuration
- ā
Local SDK Integration - Uses working local SDK with project_id fix
- ā
Enhanced Error Handling - Improved error handling and cleanup
- ā
Updated Documentation - Comprehensive usage examples and guides$3
- ā
Published to npm - Package now available as n8n-nodes-aparavi-dtc`MIT License - see LICENSE file for details.
---
Ready to get started? Install the package and begin processing your data with powerful Aparavi DTC capabilities! š