FileLoader

---

🎯 Purpose

The FileLoader node reads files or directories and makes their contents available to other nodes in your ThreoBuilder workflows. It supports CSV, Excel, PDF, video, and directories for batch processing.

📤 Inputs

• CSV/excel
• PDF
• Video
• Directory

📤 Outputs

• Filename
• Full path
• base64 (if enabled)
• Video Frames and audio path (in video mode)

⚙️ Parameters

Name	Type	Required	Default	Description
File Type	Dropdown	Yes	None	Select the type of file: CSV, JSON, Excel, PDF, Video, Audio, Image, Directory.
File Path	String	Conditional	Empty	Path to an individual file.
Key Column Name	String	No	id	Unique column for CSV row identifiers.
Directory Source	String	Conditional	Empty	Folder path for batch file processing.
Allowed File Extensions	String	No	Empty	File types to include in directory mode (e.g., .pdf,.docx).
Include Sub Directories	Boolean	No	false	Include files from subdirectories.
Convert Files to base64	Boolean	No	false	Convert files to base64 for AI compatibility.
Frames per second	Number	No	4	Interval (in seconds) for extracting video frames.
Image Frames Property Name	String	No	video_frames	Workflow property name for extracted frames.
Audio File Path Property Name	String	No	audio_path	Workflow property name for extracted audio.
Columns Config	Data Grid	No	Empty	CSV column configuration (name + type).
Disable Cache	Boolean	No	false	Disable caching to reload files every run.

💡 Example Usage

• 📊 Sales Reporting: Import a daily Excel file with sales transactions, set order_id as the key column, and pass structured data into an analytics node.
• 🎬 Video Highlight Extraction: Load a training video, extract frames every 5 seconds, and send them to an image classifier to detect key scenes.
• 📂 Contract Review: Read all .pdf and .docx files from a legal contracts folder (including subdirectories), convert them to base64, and forward them for AI-based clause extraction.
• 📦 Inventory Management: Load CSV inventory exports from a warehouse system, map sku and quantity columns, and use them to trigger automated restocking alerts.

📘 Best Practices

• Use consistent file names and folder structures.
• Define CSV column types to prevent conversion errors.
• Enable cache for static data, disable for frequently updated sources.
• Use extension filters in directory mode to skip irrelevant files.
• Keep video frame extraction rates reasonable to avoid heavy processing.