Skip to content

Error Reference

Error Reference

All error types thrown by the library across all languages.

KreuzbergError

Main error type for all Kreuzberg operations.

All errors in Kreuzberg use this enum, which preserves error chains and provides context for debugging.

Variants

  • Io - File system and I/O errors (always bubble up)
  • Parsing - Document parsing errors (corrupt files, unsupported features)
  • Ocr - OCR processing errors
  • Validation - Input validation errors (invalid paths, config, parameters)
  • Cache - Cache operation errors (non-fatal, can be ignored)
  • ImageProcessing - Image manipulation errors
  • Serialization - JSON/MessagePack serialization errors
  • MissingDependency - Missing optional dependencies (tesseract, etc.)
  • Plugin - Plugin-specific errors
  • LockPoisoned - Mutex/RwLock poisoning (should not happen in normal operation)
  • UnsupportedFormat - Unsupported MIME type or file format
  • Other - Catch-all for uncommon errors
Variant Message Description
Io IO error: Io errors
Parsing Parsing error: Parsing errors
Ocr OCR error: Ocr errors
Validation Validation error: Validation errors
Cache Cache error: Cache errors
ImageProcessing Image processing error: Image processing errors
Serialization Serialization error: Serialization errors
MissingDependency Missing dependency: Missing dependency errors
Plugin Plugin error in '{plugin_name}': Plugin errors
LockPoisoned Lock poisoned: Lock poisoned errors
UnsupportedFormat Unsupported format: Unsupported format errors
Embedding Embedding error: Embedding errors
Timeout Extraction timed out after {elapsed_ms}ms (limit: {limit_ms}ms) Timeout errors
Cancelled Extraction cancelled Cancelled errors
Security Security violation: Security errors
Other {0} Other errors

Edit this page on GitHub