kreuzberg-dev/kreuzberg v4.0.0-rc.3

on GitHub

Release Candidate 3 - ONNX Runtime Bundling & Test Fixes

Breaking Changes

None - this is a patch release over rc.2

Bug Fixes

ONNX Runtime Distribution

• Switched from ort-load-dynamic to ort-download-binaries feature
• ONNX Runtime binaries are now bundled at build time
• Fixes embeddings feature across ALL release variants (npm, PyPI, RubyGems, Maven, crates.io)
• Users no longer need to install onnxruntime as a system dependency

Node.js Bindings

• Fixed TypeScript build configuration (tsconfig.json rootDir)
• Fixed all test imports from src/ to dist/ (461 tests now passing)
• Fixed flaky forceOcr: true test (OCR backend isolation issue)
• Fixed test cleanup to prevent mutex errors

Documentation

• Added CONTRIBUTING.md symlink to fix broken GitHub link

Known Issues

• A cosmetic mutex error may appear at the very end of Node.js test runs during C++ static destruction
• This occurs after all Rust code completes and can be safely ignored
• Will be resolved when fastembed upgrades to ort >= 2.0.0

Test Results

• Rust: All tests passing
• Node.js: 461/461 tests passing (100%)
• Python, Ruby, Java, Go: TBD via CI

What Changed Since rc.2

• ONNX Runtime is now properly bundled
• Node.js package fully functional and tested
• All test isolation issues resolved