langchain-xberg
A LangChain document loader backed by Xberg. XbergLoader extracts text and metadata from 107 formats — running OCR where needed — and returns LangChain Document objects. Extraction is async at the core; multiple sources go through Xberg's extract_batch in a single native call, so concurrency happens Rust-side.
Install
pip install langchain-xberg
Requires Python 3.10+.
Load
Pass a path, a list of paths, a directory, or raw bytes. One source becomes one Document.
from langchain_xberg import XbergLoader
# Single file
docs = XbergLoader(file_path="report.pdf").load()
print(docs[0].page_content) # extracted markdown
print(docs[0].metadata["title"]) # source, mime_type, title, authors, detected_languages, page_count, ...
# Multiple files — one batched extraction
docs = XbergLoader(file_path=["report.pdf", "notes.docx"]).load()
# A directory with a glob
docs = XbergLoader(file_path="./corpus/", glob="**/*.pdf").load()
# Raw bytes (mime_type required)
docs = XbergLoader(data=raw_bytes, mime_type="application/pdf").load()
Chunk for retrieval
Enable Xberg's native chunking to emit one Document per chunk, sized for embedding. Each chunk carries chunk_index, total_chunks, heading_path, page, and token_count in its metadata.
from langchain_xberg import XbergLoader
from xberg import ChunkingConfig, ExtractionConfig
config = ExtractionConfig(chunking=ChunkingConfig(max_characters=1000, overlap=200))
docs = XbergLoader(file_path="report.pdf", config=config).load() # one Document per chunk
To split by page instead, pass pages=PageConfig(extract_pages=True); each Document then gets a 0-indexed page.
Configure extraction
Pass any Xberg ExtractionConfig to control OCR, output format, and batch concurrency.
from xberg import ExtractionConfig, OcrConfig
config = ExtractionConfig(
output_format="markdown",
ocr=OcrConfig(backend="tesseract"),
force_ocr=True,
max_concurrent_extractions=8,
)
docs = XbergLoader(file_path="./corpus/", config=config).load()
Async
Inside an event loop, use the async API — await loader.aload() or async for doc in loader.alazy_load(). These use Xberg's native async extraction end to end. The synchronous load / lazy_load bridge to it and must not run inside a running loop.
loader = XbergLoader(file_path="report.pdf")
docs = await loader.aload()
Errors
A per-input failure raises xberg.XbergError with the offending source and message. In batch mode the failure comes from ExtractionResult.errors; a single load surfaces the raised exception directly.
For the full API, see the Xberg documentation.
1 maintainer
Release files for langchain-xberg 1.2.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| langchain_xberg-1.2.8.tar.gz | 12.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| langchain_xberg-1.2.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 21.8 kB
Release files / langchain_xberg-1.2.8.tar.gz
| Download URL | langchain_xberg-1.2.8.tar.gz |
|---|---|
| Size | 12.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe05b885298633fb53284acda670c0c66d6e695a923f94869f8296546eacb40f
|
|
BLAKE2b-256 checksum How to use checksums |
d876cac4b562addacccf428dec7c6a0203dde2ab1963f5a7a569cf2295ef9d44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / langchain_xberg-1.2.8-py3-none-any.whl
| Download URL | langchain_xberg-1.2.8-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
de3abbcda42d56c276b74271489f2b58f8f8d90076d2f256fb8a0e37a0ec3bda
|
|
BLAKE2b-256 checksum How to use checksums |
4b40ed8a18a52e68c141fe6e6a6a2086ab75fb50a23ac78ae67147b4cb375c49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
