Add this skill
npx mdskills install kreuzberg-dev/kreuzbergComprehensive guide covering installation, API usage, config, and error handling across multiple languages
Extract text and metadata from a wide range of file formats (75+), generate embeddings and post-process at native speeds without needing a GPU.
Complete Documentation | Installation Guides
Each language binding provides comprehensive documentation with examples and best practices. Choose your platform to get started:
Scripting Languages:
JavaScript/TypeScript:
Compiled Languages:
Native:
Containers:
Command-Line:
All language bindings include precompiled binaries for both x86_64 and aarch64 architectures on Linux and macOS.
Complete architecture coverage across all language bindings:
| Language | Linux x86_64 | Linux aarch64 | macOS ARM64 | Windows x64 |
|---|---|---|---|---|
| Python | ✅ | ✅ | ✅ | ✅ |
| Node.js | ✅ | ✅ | ✅ | ✅ |
| Ruby | ✅ | ✅ | ✅ | - |
| Elixir | ✅ | ✅ | ✅ | ✅ |
| Go | ✅ | ✅ | ✅ | ✅ |
| Java | ✅ | ✅ | ✅ | ✅ |
| C# | ✅ | ✅ | ✅ | ✅ |
| PHP | ✅ | ✅ | ✅ | ✅ |
| Rust | ✅ | ✅ | ✅ | ✅ |
| CLI | ✅ | ✅ | ✅ | ✅ |
| Docker | ✅ | ✅ | ✅ | - |
Note: ✅ = Precompiled binaries available with instant installation. All platforms are tested in CI. macOS support is Apple Silicon only.
To use embeddings functionality:
Install ONNX Runtime 1.24+:
brew install onnxruntimeUse embeddings in your code - see Embeddings Guide
Note: Kreuzberg requires ONNX Runtime version 1.24+ for embeddings. All other Kreuzberg features work without ONNX Runtime.
75+ file formats across 8 major categories with intelligent format detection and comprehensive metadata extraction.
| Category | Formats | Capabilities |
|---|---|---|
| Word Processing | .docx, .odt | Full text, tables, lists, images, metadata, styles |
| Spreadsheets | .xlsx, .xlsm, .xlsb, .xls, .xla, .xlam, .xltm, .ods | Sheet data, formulas, cell metadata, charts |
| Presentations | .pptx, .pptm, .ppsx | Slides, speaker notes, images, metadata |
.pdf | Text, tables, images, metadata, OCR support | |
| eBooks | .epub, .fb2 | Chapters, metadata, embedded resources |
| Category | Formats | Features |
|---|---|---|
| Raster | .png, .jpg, .jpeg, .gif, .webp, .bmp, .tiff, .tif | OCR, table detection, EXIF metadata, dimensions, color space |
| Advanced | .jp2, .jpx, .jpm, .mj2, .jbig2, .jb2, .pnm, .pbm, .pgm, .ppm | Pure Rust decoders (JPEG 2000, JBIG2), OCR, table detection |
| Vector | .svg | DOM parsing, embedded text, graphics metadata |
| Category | Formats | Features |
|---|---|---|
| Markup | .html, .htm, .xhtml, .xml, .svg | DOM parsing, metadata (Open Graph, Twitter Card), link extraction |
| Structured Data | .json, .yaml, .yml, .toml, .csv, .tsv | Schema detection, nested structures, validation |
| Text & Markdown | .txt, .md, .markdown, .djot, .mdx, .rst, .org, .rtf | CommonMark, GFM, Djot, MDX, reStructuredText, Org Mode, Rich Text |
| Category | Formats | Features |
|---|---|---|
.eml, .msg | Headers, body (HTML/plain), attachments, UTF-16 support | |
| Archives | .zip, .tar, .tgz, .gz, .7z | Recursive extraction, nested archives, metadata |
| Category | Formats | Features |
|---|---|---|
| Citations | .bib, .ris, .nbib, .enw, .csl | BibTeX/BibLaTeX, RIS, PubMed/MEDLINE, EndNote XML, CSL JSON |
| Scientific | .tex, .latex, .typ, .typst, .jats, .ipynb | LaTeX, Typst, JATS journal articles, Jupyter notebooks |
| Publishing | .fb2, .docbook, .dbk, .opml | FictionBook, DocBook XML, OPML outlines |
| Documentation | .pod, .mdoc, .troff | Perl POD, man pages, troff |
OCR with Table Extraction
Multiple OCR backends (Tesseract, EasyOCR, PaddleOCR) with intelligent table detection and reconstruction. Extract structured data from scanned documents and images with configurable accuracy thresholds.
Batch Processing
Process multiple documents concurrently with configurable parallelism. Optimize throughput for large-scale document processing workloads with automatic resource management.
Password-Protected PDFs
Handle encrypted PDFs with single or multiple password attempts. Supports both RC4 and AES encryption with automatic fallback strategies.
Language Detection
Automatic language detection in extracted text using fast-langdetect. Configure confidence thresholds and access per-language statistics.
Metadata Extraction
Extract comprehensive metadata from all supported formats: authors, titles, creation dates, page counts, EXIF data, and format-specific properties.
Kreuzberg ships with an Agent Skill that teaches AI coding assistants how to use the library correctly. It works with Claude Code, Codex, Gemini CLI, Cursor, VS Code, Amp, Goose, Roo Code, and any tool supporting the Agent Skills standard.
Install the skill into any project using the Vercel Skills CLI:
npx skills add kreuzberg-dev/kreuzberg
The skill is located at skills/kreuzberg/SKILL.md and is automatically discovered by supported AI coding tools once installed.
Contributions are welcome! See CONTRIBUTING.md for guidelines.
MIT License - see LICENSE for details. You can use Kreuzberg freely in both commercial and closed-source products with no obligations, no viral effects, and no licensing restrictions.
Install via CLI
npx mdskills install kreuzberg-dev/kreuzbergKreuzberg is a free, open-source AI agent skill. >-
Install Kreuzberg with a single command:
npx mdskills install kreuzberg-dev/kreuzbergThis downloads the skill files into your project and your AI agent picks them up automatically.
Kreuzberg works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.