Xberg

crewai-xberg

CrewAI tools backed by Xberg. Give an agent document intelligence: extract text, metadata, keywords, entities, and summaries from 98 file formats — PDF, DOCX, XLSX, HTML, images with OCR, and more. Extraction is async at the core; the batch tool routes many files through Xberg's extract_batch in a single native call.

Install

pip install crewai-xberg

Requires Python 3.10+.

Tools

Tool	Input	Returns
`XbergExtractTool`	`file_path`	Extracted text, plus any requested rich results.
`XbergExtractBatchTool`	`file_paths`	One section per document via `extract_batch`, then errors.
`XbergExtractMetadataTool`	`file_path`	Title, authors, dates, page/table/image counts, format info.

Use

from crewai import Agent
from crewai_xberg import XbergExtractTool, XbergExtractBatchTool, XbergExtractMetadataTool

agent = Agent(
    role="Document Analyst",
    goal="Extract and analyze document content",
    backstory="You process documents of any format.",
    tools=[XbergExtractTool(), XbergExtractBatchTool(), XbergExtractMetadataTool()],
)

Call a tool directly to see its output:

tool = XbergExtractTool()

# Plain extraction
text = tool.run(file_path="report.pdf")

# Force OCR and surface keywords, entities, and a summary
enriched = tool.run(
    file_path="scan.pdf",
    output_format="markdown",
    force_ocr=True,
    extract_keywords=True,
    extract_entities=True,
    summarize=True,
)

# Many files in one batched extraction
combined = XbergExtractBatchTool().run(file_paths=["report.pdf", "notes.docx", "sheet.xlsx"])

Options

Both extraction tools accept the same options. Each toggles an Xberg ExtractionConfig capability:

Option	Default	Effect
`output_format`	`"markdown"`	`plain`, `markdown`, or `html`.
`force_ocr`	`False`	Run OCR on every page, even with a text layer.
`chunk`	`False`	Split into semantic chunks; report the chunk count.
`extract_keywords`	`False`	Append a keyword list.
`extract_entities`	`False`	Append named entities (people, orgs, locations).
`summarize`	`False`	Append a short summary.

Detected languages and tables are surfaced automatically when present.

Async

The tools are async at the core. Inside an event loop, await tool.arun(...); the synchronous run bridges to it and must not be called from a running loop.

Errors

A missing file raises from Xberg directly. In batch mode, per-file failures land in ExtractionResult.errors and are reported in a trailing Errors section instead of aborting the batch.

For the full API, see the Xberg documentation.

Metadata

Release files for crewai-xberg 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crewai-xberg 1.0.1
File	Size	Uploaded
crewai_xberg-1.0.1.tar.gz	9.8 kB	Jul 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for crewai-xberg 1.0.1
File	Interpreter	ABI	Platform	Reset
crewai_xberg-1.0.1-py3-none-any.whl 8.0 kB Jul 28, 2026	Python 3	none	any	Details

Total release size: 17.8 kB

Release files / crewai_xberg-1.0.1.tar.gz

Download URL	crewai_xberg-1.0.1.tar.gz
Size	9.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`67dcfc62846f0bedb9901dee052a4d32a597b10defa54cc1570dde07c6e2213a`
BLAKE2b-256 checksum How to use checksums	`f7f21c101329ada1aacd64871b5e57bce6973f3cfdeeb78c30470aad2b8df010`
Upload date	Jul 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","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 / crewai_xberg-1.0.1-py3-none-any.whl

Download URL	crewai_xberg-1.0.1-py3-none-any.whl
Size	8.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`235ee642aed92f638398df9136f30f9ac2f50ea803330587367b1bbae065a29d`
BLAKE2b-256 checksum How to use checksums	`6b0e0f35ecb9bba11f9c71d740803cc701dc0b9160c307372e8cc7e69f18f092`
Upload date	Jul 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","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}`