Skip to main content

Data Loaders

Hystersis supports loading data from various document formats for ingestion into memory.

Production Ingestion API

Use the Sources API for production ingestion. It creates a durable source record, stores uploaded files in the configured blob backend, chunks extracted text, and writes searchable source_chunk memories with source attribution metadata.
Production object storage defaults to Cloudflare R2 when STORAGE_PROVIDER=r2 and R2_* credentials are configured. Local filesystem storage is retained for development and self-hosted minimal installs.

Supported Formats

Quick Start

PDF Loader

Audio Loader

Document Structure

Loading from URLs

All loaders support loading from HTTP/HTTPS URLs:

Custom Loaders

Implement the Loader interface for custom formats: