n8n-nodes-unstract

This is an n8n community node package that provides integrations with Unstract services, including LLMWhisperer and the Unstract API. These nodes enable seamless document processing and text extraction workflows within your n8n automations.

What is Unstract?

Unstract is a platform that helps extract structured data from unstructured documents using AI. It provides powerful APIs for document processing, including:

• LLMWhisperer: Convert documents to layout-preserved plain text
• Unstract API: Extract structured data from documents using custom workflows

Features

This package includes two main nodes:

🔤 LLMWhisperer Node

• Convert documents (PDF, images, etc.) to layout-preserved plain text
• Maintain document structure and formatting
• Support for various document formats
• Configurable processing modes

🤖 Unstract Node

• Process documents using Unstract's AI-powered extraction
• Extract structured data from unstructured documents
• Support for custom API deployments
• Seamless integration with Unstract workflows

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install a community node
3. Enter the npm package name: n8n-nodes-unstract
4. Click Install

Manual Installation

You can install this node package in your n8n instance using npm:

npm install n8n-nodes-unstract

For Docker installations, add the package to your n8n container:

# Replace <your-path-to-n8n-custom-nodes> with the path to n8n
N8N_CUSTOM_EXTENSIONS="<your-path-to-n8n-custom-nodes>" npx n8n start

Configuration

Prerequisites

Before using these nodes, you'll need:

1. API Credentials: Get your API keys from:

   • LLMWhisperer API - Follow the doc
   • Unstract Platform - Follow the doc

2. Node.js: Version 20 or above is required

Setting up Credentials

1. LLMWhisperer API Credentials:

   • Go to your n8n credentials settings
   • Create new credentials of type "LLMWhisperer API"
   • Enter your LLMWhisperer API key

2. Unstract API Credentials:

   • Go to your n8n credentials settings
   • Create new credentials of type "Unstract API"
   • Enter your Unstract API key and endpoint details

Usage Examples

LLMWhisperer Node

Use the LLMWhisperer node to convert documents to text while preserving layout:

1. Add the LLMWhisperer node to your workflow
2. Configure your API credentials
3. Set the input file (binary data)
4. Choose processing mode and options
5. Execute to get layout-preserved text output

Unstract Node

Use the Unstract node to extract structured data:

1. Add the Unstract node to your workflow
2. Configure your API credentials and deployment
3. Set the input document (binary data)
4. Specify your API deployment name
5. Execute to get structured data output

API Documentation

For detailed API documentation and advanced configuration options:

• LLMWhisperer Documentation
• Unstract Platform Documentation

Development

Prerequisites

• Node.js 20 or above
• npm or yarn

Setup

# Clone the repository
git clone https://github.com/Zipstack/n8n-nodes.git
cd n8n-nodes

# Install dependencies
npm install

# Build the project
npm run build

# Run linting
npm run lint

Running n8n with Custom Nodes

For development and testing:

# Set the custom extensions path and start n8n
N8N_CUSTOM_EXTENSIONS="/path/to/n8n-nodes" npx n8n start

Support

• Documentation: docs.unstract.com
• Issues: GitHub Issues
• Community: Join our community discussions
• Email: support@unstract.com

License

This project is licensed under the MIT License - see the package.json file for details.

Contributing

We welcome contributions! Please feel free to submit issues, feature requests, or pull requests.

---

Made with ❤️ by the Unstract team