intextum-worker
The Intextum processing worker: an HTTP-polling worker that pulls tasks from an Intextum API instance and runs the Docling / FFmpeg document, image and audio pipeline (OCR, ASR, chunking, classification, content enrichment, embeddings).
The worker is always-remote: it downloads source files from and uploads results to the API over HTTP, so it does not need a shared volume and can run anywhere — including on a host with a GPU while the rest of the stack runs in Docker.
Install
Pick the bundle that matches your accelerator. The macOS (Apple MPS) wheels are on PyPI, so it installs with no extra flags:
pip install 'intextum-worker[mps]'
Linux CPU and NVIDIA CUDA pull their Torch build from the PyTorch index, so add
the matching --extra-index-url:
# Linux, CPU only
pip install 'intextum-worker[cpu]' --extra-index-url https://download.pytorch.org/whl/cpu
# Linux, NVIDIA CUDA 12.6
pip install 'intextum-worker[cuda]' --extra-index-url https://download.pytorch.org/whl/cu126
Available extras: mps, cpu, cuda, cpu-document (document/image only), plus
the granular document, asr, enrichment stacks.
Run
export API_URL="https://your-intextum-host" # the API to poll
export WORKER_TOKEN="<token from the Add Worker dialog>"
intextum-worker --capabilities document,video,image
intextum-worker --help lists all flags. Every flag also has an environment
variable (API_URL, WORKER_TOKEN, WORK_DIR, CAPABILITIES, POLL_INTERVAL,
CLASSIFICATION_DEVICE, DOCLING_OCR_ENGINE, …); CLI flags take precedence.
Development
This package uses a src/ layout. The repo-root VERSION file is the single
source of truth for the version; it is staged into worker/VERSION at build time
(worker/VERSION is gitignored).
cp ../VERSION VERSION # stage the version for an editable install
pip install -e '.[mps,test]' # or [cpu,test] / [cuda,test]
pytest
export API_URL="http://localhost:8000"
export WORKER_TOKEN="<token from the Add Worker dialog>"
export CLASSIFICATION_DEVICE="mps" # macOS Apple Silicon; use cpu/cuda elsewhere
intextum-worker --capabilities document,video,image,training
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file intextum_worker-0.1.14.tar.gz.
File metadata
- Download URL: intextum_worker-0.1.14.tar.gz
- Upload date:
- Size: 112.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d81c315fc93f2c74ab54077342a036a302b04cd3094204872acdd288454e2949
|
|
| MD5 |
3e78edb9047fad2e1ef63cb4c6c036c4
|
|
| BLAKE2b-256 |
45e130369f31435b6824e3b698ec110660203d4e94682cc2c4c8a9f69993fb49
|
Provenance
The following attestation bundles were made for intextum_worker-0.1.14.tar.gz:
Publisher:
release-worker.yml on intextum/intextum
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
intextum_worker-0.1.14.tar.gz -
Subject digest:
d81c315fc93f2c74ab54077342a036a302b04cd3094204872acdd288454e2949 - Sigstore transparency entry: 2048611231
- Sigstore integration time:
-
Permalink:
intextum/intextum@62ee5cf77c700d6e35db943e1031b7a8bfca054b -
Branch / Tag:
refs/tags/v0.1.14 - Owner: https://github.com/intextum
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-worker.yml@62ee5cf77c700d6e35db943e1031b7a8bfca054b -
Trigger Event:
push
-
Statement type:
File details
Details for the file intextum_worker-0.1.14-py3-none-any.whl.
File metadata
- Download URL: intextum_worker-0.1.14-py3-none-any.whl
- Upload date:
- Size: 94.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0a6e7b4c8732f487995ffe0899c0106ab26208e0d667033f9664aca23948cc3b
|
|
| MD5 |
8629d3d4621de966049b9e80733cfef7
|
|
| BLAKE2b-256 |
bfe58def1d10bfeaeb47f8bba2eb2a8ea208098cf894835b11d3f9283c292e6e
|
Provenance
The following attestation bundles were made for intextum_worker-0.1.14-py3-none-any.whl:
Publisher:
release-worker.yml on intextum/intextum
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
intextum_worker-0.1.14-py3-none-any.whl -
Subject digest:
0a6e7b4c8732f487995ffe0899c0106ab26208e0d667033f9664aca23948cc3b - Sigstore transparency entry: 2048611251
- Sigstore integration time:
-
Permalink:
intextum/intextum@62ee5cf77c700d6e35db943e1031b7a8bfca054b -
Branch / Tag:
refs/tags/v0.1.14 - Owner: https://github.com/intextum
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-worker.yml@62ee5cf77c700d6e35db943e1031b7a8bfca054b -
Trigger Event:
push
-
Statement type:
