crewai-xberg 1.0.0rc41

Xberg document extraction tools for CrewAI agents — text, metadata, and batch extraction across 97 file formats

crewai-xberg

CrewAI tools backed by Xberg. Give an agent document intelligence: extract text, metadata, keywords, entities, and summaries from 97 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.