EPUB File Loader

EPUB (Electronic Publication) is a free and open e-book standard by the International Digital Publishing Forum (IDPF). This module provides functionality to load and process EPUB files within your workflow.

This module provides a sophisticated EPUB document loader that can:

• Load single or multiple EPUB files
• Support both base64-encoded files and files from storage
• Extract content per chapter or per file
• Process content with text splitters
• Handle metadata extraction
• Manage temporary file processing

Inputs

Required Parameters

• EPUB File: The EPUB file(s) to process (.epub extension required)
• Usage: Choose between:
  • One document per chapter: Split content by chapters
  • One document per file: Process entire file as one document

Optional Parameters

• Text Splitter: A text splitter to process the extracted content
• Additional Metadata: JSON object with additional metadata
• Omit Metadata Keys: Comma-separated list of metadata keys to omit

Outputs

• Document: Array of document objects containing metadata and pageContent
• Text: Concatenated string from pageContent of documents

Features

• Multiple file processing
• Chapter-level splitting
• File-level processing
• Storage integration
• Metadata customization
• Text splitting support
• Temporary file handling
• Error handling

Processing Modes

Per Chapter Mode

• Creates separate documents for each chapter
• Maintains chapter structure
• Preserves chapter metadata
• Better for detailed analysis

Per File Mode

• Processes entire file as one document
• Maintains overall structure
• Simpler document organization
• Better for overview analysis

Notes

• Supports both local and storage-based files
• Handles base64 encoded content
• Automatically cleans up temporary files
• Preserves document structure
• Supports custom metadata addition
• Error handling for invalid files
• Memory-efficient processing