Xberg

crewai-xberg

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

crewai_xberg-1.2.1.tar.gz (10.6 kB view details)

Uploaded Sep 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

crewai_xberg-1.2.1-py3-none-any.whl (8.0 kB view details)

Uploaded Sep 14, 2026 Python 3

File details

Details for the file crewai_xberg-1.2.1.tar.gz.

File metadata

Download URL: crewai_xberg-1.2.1.tar.gz
Upload date: Sep 14, 2026
Size: 10.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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}

File hashes

Hashes for crewai_xberg-1.2.1.tar.gz
Algorithm	Hash digest
SHA256	`c1ff2226b88452978eb11c80ae0a1d22acad1f4ed5de6b41da5a39289703173b`
MD5	`58fb3ae18329e8bf456410301e0e6023`
BLAKE2b-256	`215e8a3990dd122328695797cc83164f13329807cca0b2d14fdfa8b486591136`

See more details on using hashes here.

File details

Details for the file crewai_xberg-1.2.1-py3-none-any.whl.

File metadata

Download URL: crewai_xberg-1.2.1-py3-none-any.whl
Upload date: Sep 14, 2026
Size: 8.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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}

File hashes

Hashes for crewai_xberg-1.2.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`4a5dc54f9678eaf71c8360ad80666c5974bcb013e5fc56cbfe18c15767d32b91`
MD5	`380e5ece376e779803a1cc08cc8df849`
BLAKE2b-256	`27bf649109edd14159d773b065bfa837c2fe4fdb7f23fae18bd99f827cdc28b9`