Xberg

Xberg is the next iteration of Kreuzberg. Same document-intelligence engine, rebuilt and rebranded under a fresh v1 line.

Point Xberg at anything — a PDF, a spreadsheet, a scanned image, an audio file, a URL, an archive, a source tree — and get back clean, structured content you can use right away. One core does the format detection, reading, and extraction, so you don't assemble a pipeline yourself. Call it from Rust, Python, Node.js, Go, Java, C#, Ruby, PHP, Elixir, Dart, Swift, Zig, WASM, Kotlin, or C FFI, and run it as a library, CLI tool, REST API, or MCP server.

Capabilities marked requires a feature are Cargo feature flags on the core crate (url-ingestion, transcription, reranker, layout/ORT). Prebuilt language packages and the Docker image bundle the common set; a from-source build enables only what you select.

pip install xberg

See Python README for full documentation.

npm install @xberg-io/xberg

See Node.js README for full documentation.

cargo add xberg

See Rust README for full documentation.

go get github.com/xberg-io/xberg/packages/go@latest

⚠️ The repository root is not a Go module — go get github.com/xberg-io/xberg will fail. Always target the /packages/go subdirectory as shown above.

See Go README for full documentation.

Available on Maven Central as io.xberg:xberg. See Java README for the dependency snippet.

dotnet add package Xberg

See C# README for full documentation.

gem install xberg

See Ruby README for full documentation.

composer require xberg-io/xberg

See PHP README for full documentation.

Add {:xberg, "~> 1.0"} to your mix.exs dependencies. See Elixir README for full documentation.

npm install @xberg-io/xberg-wasm

See WebAssembly README for full documentation.

Available on Maven Central as io.xberg:xberg-android. See Kotlin README for the dependency snippet.

Add via Swift Package Manager. See Swift README for full documentation.

dart pub add xberg

See Dart README for full documentation.

Add via zig fetch. See Zig README for full documentation.

Build from source as part of this workspace. See C (FFI) README for full documentation.

brew install xberg-io/tap/xberg

12 commands: extract, batch, detect, formats, version, cache (stats/clear/manifest/warm), serve, mcp, api, embed, chunk, completions.

See CLI usage guide for detailed documentation.

docker pull ghcr.io/xberg-io/xberg:latest

Run in API, CLI, or MCP modes. See Docker guide for examples.

xberg serve --host 0.0.0.0 --port 8000

One POST endpoint handles all formats. Returns JSON or Markdown. Stream large files. See API server guide.

xberg mcp --transport stdio

9 tools (extract, extract_batch, detect_mime_type, cache_stats, list_formats, cache_clear, get_version, cache_manifest, cache_warm). 3 prompts (extract_document, extract_with_ocr, semantic_search). 4 resources (formats, models, OCR languages, embedding presets).

Add to Claude Desktop or Cursor:

{
  "mcpServers": {
    "xberg": { "command": "xberg", "args": ["mcp"] }
  }
}

See MCP integration guide.

Install the Xberg plugin from xberg-io/xberg. Ships extraction APIs, OCR backends, configuration, and language conventions.

/plugin marketplace add xberg-io/xberg
/plugin install xberg@xberg

/plugins add https://github.com/xberg-io/xberg

Search for xberg and select Install Plugin.

Settings → Plugins → Add from URL → https://github.com/xberg-io/xberg, then select xberg.

gemini extensions install https://github.com/xberg-io/xberg

droid plugin marketplace add https://github.com/xberg-io/xberg
droid plugin install xberg@xberg

copilot plugin marketplace add https://github.com/xberg-io/xberg
copilot plugin install xberg@xberg

Add to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@xberg-io/opencode-xberg"]
}

Extract text from a document:

use xberg::{extract, ExtractInput, ExtractionConfig};

#[tokio::main]
async fn main() -> xberg::Result<()> {
    let config = ExtractionConfig::default();
    let output = extract(
        ExtractInput::from_uri("document.pdf"),
        &config
    ).await?;

    println!("{}", output.results[0].content);
    Ok(())
}

Common use cases — see Quick start guide for language-specific examples, OCR, batch processing, and API configuration.

100 formats across 120 file extensions in 8 major categories with intelligent format detection and comprehensive metadata extraction.

Extract structure from 371 programming languages via tree-sitter:

Powered by tree-sitter-language-pack.

• Tesseract — Native C FFI (Linux/macOS/Windows) and WASM (browser)
• PaddleOCR — ONNX Runtime, mobile-optimized models
• Candle — Pure Rust, CPU-only, lightweight
• VLM — GPT-4 Vision, Claude Vision, Gemini Vision, or 165 providers via liter-llm

Fallback chains. Extensible via plugin system.

Local (ONNX Runtime):

• Preset models: fast, balanced (default), quality, multilingual
• Dimensions: 384, 768, 1024

Provider-hosted:

• OpenAI, Anthropic, Google, Hugging Face, Mistral, Cohere, and 165 providers total
• Via liter-llm integration

Reranking:

• Local ONNX rerankers (cross-encoder models)
• Provider-hosted: Cohere Rerank, others

Local engines: Ollama, LM Studio, vLLM

Remote: OpenAI, Anthropic, Google, Mistral, Cohere, and 165 providers via liter-llm

Schema validation. Temperature, top-p, frequency penalty tuning.

• NER — GLiNER or LLM-based entity recognition
• Redaction — Mask PII (phone, email, SSN, credit card, addresses)
• Summarization — Document and section summaries via LLM
• Translation — Multi-language via LLM
• Page Classification — Tag document pages (cover, toc, content, etc.)
• QR Code Detection — Extract and decode QR codes from images
• Keyword Extraction — YAKE or RAKE algorithms
• Language Detection — Detect document language
• Layout Detection — RT-DETR + TATR models for document structure
• Table Extraction — Cell-level structure and content
• Token Reduction — TOON wire format (~30–50% fewer tokens than JSON)

Run xberg --help or xberg <command> --help for detailed options.

Full guides, API references for every binding, format reference, and configuration docs live at xberg.io.

• Getting Started
• Quick Start
• Guides
• API Reference (Rust core) — every binding has its own page under /reference/
• Format Reference
• Live Demo (browser, WASM)

Projects that declare Xberg as a dependency. Xberg was previously published as kreuzberg, and most of these projects declare the package under that name.

Project	What it is	Stars
basemind	AI context and content layer for coding agents over one MCP server: code map, document RAG, shared memory and web crawl
delulu	A suite of MCP servers and CLI tools that give your LLM better search and fewer hallucinations
docs-mcp-server	Grounded documentation MCP server, an open-source alternative to Context7, Nia and Ref.Tools
erato	The open-source AI platform
fastmail-cli	CLI and MCP server for Fastmail: email, contacts, masked email, attachments and text extraction
ghfdb-portal	Web portal for the Global Heat Flow Database
hawki-toolkit-file-converter	Prepares and converts PDF files for the HAWKI toolkit
haystack-core-integrations	Integrations that extend Haystack with extra components and document stores
kreuzakt	A search engine for humans and computers, aimed at your most boring documents
lilbee	The whole local AI stack in one executable, with conversational search and cited answers over your files, code and the web
llm-workflow-engine	Power CLI and workflow manager for LLMs
MANSPIDER	Spiders entire networks for files sitting on SMB shares, searching filenames or contents with regex
otoroshi-llm-extension	Connect, secure and manage LLM models behind one OpenAI-compatible API
sift-kg	Turns a collection of documents into a knowledge graph, extracting entities and relationships with an LLM
sirchmunk	Turns raw data into a self-evolving, real-time search and intelligence layer
support-chatbot	Level-1 support chatbot for the Netherlands Red Cross 510 team

Using Xberg in your project? Open a PR adding it to this list.

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Join our Discord community for questions and discussion.

Xberg is one of six open-source projects from Kreuzberg, Inc.:

• Xberg — document intelligence: text, tables, metadata from 100 formats with optional OCR.
• Xberg Enterprise — managed extraction API with SDKs, dashboards, and observability.
• crawlberg — web crawling and scraping with HTML→Markdown and headless-Chrome fallback.
• html-to-markdown — fast, lossless HTML→Markdown engine.
• liter-llm — universal LLM API client with native bindings for 14 languages and 165 providers.
• tree-sitter-language-pack — tree-sitter grammars and code-intelligence primitives.
• alef — the polyglot binding generator that produces every per-language binding across the 5 polyglot repos.

MIT License (MIT) — see LICENSE for details.