@2xdamage/n8n-nodes-docling-serve
v0.0.4
Published
n8n community node for docling-serve document conversion API
Maintainers
Readme
@2xdamage/n8n-nodes-docling-serve
n8n community node for integrating Docling Serve document conversion API with your workflows.
Table of Contents
Installation
Follow the installation guide in the n8n community nodes documentation.
- Go to Settings > Community Nodes
- Select Install
- Enter
@2xdamage/n8n-nodes-docling-servein the npm Package Name field - Agree to the risks of using community nodes
- Select Install
Credentials
Docling Serve API
- Deploy a Docling Serve instance (see Docling Serve documentation)
- In n8n: Create new credential > Docling Serve API
- Enter the Base URL of your Docling Serve instance (default:
http://127.0.0.1:5001) - Optionally enter an API Key if your server requires authentication
- Save
Operations
Document
| Operation | Description | |-----------|-------------| | Convert from URL | Convert a document from a URL (synchronous) | | Convert from File | Convert a document from binary data (synchronous) | | Convert from URL (Async) | Start async conversion from a URL | | Convert from File (Async) | Start async conversion from binary data | | Get Status | Get the status of an async conversion task | | Get Result | Get the result of a completed async conversion |
Document Additional Options
- OCR Engine: Select OCR engine for scanned documents.
- OCR Languages: List of language codes to use with OCR. Defaults to
["en"]for EasyOCR. Note: language codes differ between engines (EasyOCR often uses 2-letter codes likeen; Tesseract often uses 3-letter codes likeeng). - Image Export Mode: Controls how images are represented in output (default:
placeholder). - Output Formats: Which outputs to generate (default:
["md"]). - Document Timeout: Maximum processing time in seconds.
Chunk
| Operation | Description | |-----------|-------------| | Chunk from URL | Chunk a document from a URL | | Chunk from File | Chunk a document from binary data |
Chunk Additional Options
Chunk supports the same OCR/output-related settings as Document. Note that Output Formats and Image Export Mode mainly affect the documents field when Include Converted Document is enabled.
System
| Operation | Description | |-----------|-------------| | Health Check | Check the health status of the Docling Serve instance |
Compatibility
Tested with:
- n8n Version: 2.2.3
- Node Version: 22.11.0
Development Notes
Kill n8n Process
Add this alias to your ~/.zshrc for quick n8n process termination during development:
alias kill-n8n="kill -9 \$(lsof -ti tcp:5678 -sTCP:LISTEN)"After adding, reload your shell: source ~/.zshrc
Publish New Release
# Bump the version
npm version patch|minor|major# push the tag to GitHub
git push origin v1.2.3Resources
Version History
0.0.1- Initial release
