`Bus error` of `torchao` installed, on Termux. Must get rid od `torchao` to resolve

[Manamama]

Bug

Sneaky error after upgrade in Termux to python3.14:
Bus error python /data/data/com.termux/files/usr/bin/docling --help
...

Steps to reproduce

If torchao:

...
               # /data/data/com.termux/files/usr/lib/python3.14/site-packages/transformers/integrations/__pycache__/spqr.cpython-314.pyc matches /data/data/com.termux/files/usr/lib/python3.14/site-packages/transformers/integrations/spqr.py                                        # code object from '/data/data/com.termux/files/usr/lib/python3.14/site-packages/transformers/integrations/__pycache__/spqr.cpython-314.pyc'                                                          import 'transformers.integrations.spqr' # <_frozen_importlib_external.SourceFileLoader object at 0x7cc5a20950>                      import 'transformers.quantizers.quantizer_spqr' # <_frozen_importlib_external.SourceFileLoader object at 0x7cc5a20770>              # /data/data/com.termux/files/usr/lib/python3.14/site-packages/transformers/quantizers/__pycache__/quantizer_torchao.cpython-314.pyc matches /data/data/com.termux/files/usr/lib/python3.14/site-packages/transformers/quantizers/quantizer_torchao.py                  # code object from '/data/data/com.termux/files/usr/lib/python3.14/site-packages/transformers/quantizers/__pycache__/quantizer_torchao.cpython-314.pyc'                                               # /data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/__pycache__/__init__.cpython-314.pyc matches /data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/__init__.py  # code object from '/data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/__pycache__/__init__.cpython-314.pyc'      # /data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/__pycache__/csrc_meta_ops.cpython-314.pyc matches /data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/csrc_meta_ops.py                                                          # code object from '/data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/__pycache__/csrc_meta_ops.cpython-314.pyc' Bus error                  python -v /data/data/com.termux/files/usr/bin/docling

In short:

                            .../0/Movies $ python  /data/data/com.termux/files/usr/bin/docling --help                                                           WARNING: linker: Warning: "/data/data/com.termux/files/usr/lib/python3.14/site-packages/pypdfium2_raw/libpdfium.so" unused DT entry: unknown processor-specific (type 0x70000001 arg 0x0) (ignoring)  WARNING: linker: Warning: "/data/data/com.termux/files/usr/lib/python3.14/site-packages/optree.libs/libc++_shared-d523468d.so" unused DT entry: unknown processor-specific (type 0x70000001 arg 0x0) (ignoring)                                                         Bus error                  python /data/data/com.termux/files/usr/bin/docling --help

If uninstalled:

.../0/Movies $ pip show torchao                                   Name: torchao                                                     Version: 0.17.0+cpu                                               Summary: Package for applying ao techniques to GPU models         Home-page: https://github.com/pytorch/ao                          Author:                                                           Author-email:                                                     License:                                                          Location: /data/data/com.termux/files/usr/lib/python3.14/site-packages                                                              Requires:                                                         Required-by:                                                      .../0/Movies $ pip uninstall torchao                              Found existing installation: torchao 0.17.0+cpu                   Uninstalling torchao-0.17.0+cpu:                                    Would remove:                                                       /data/data/com.termux/files/usr/lib/python3.14/site-packages/test/*                                                                 /data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao-0.17.0+cpu.dist-info/*                                         /data/data/com.termux/files/usr/lib/python3.14/site-packages/torchao/*                                                          Proceed (Y/n)? y                                                    Successfully uninstalled torchao-0.17.0+cpu                     .../0/Movies $ time python  /data/data/com.termux/files/usr/bin/docling --help                                                      WARNING: linker: Warning: "/data/data/com.termux/files/usr/lib/python3.14/site-packages/pypdfium2_raw/libpdfium.so" unused DT entry: unknown processor-specific (type 0x70000001 arg 0x0) (ignoring)  WARNING: linker: Warning: "/data/data/com.termux/files/usr/lib/python3.14/site-packages/optree.libs/libc++_shared-d523468d.so" unused DT entry: unknown processor-specific (type 0x70000001 arg 0x0) (ignoring)                                                                                                                            Usage: docling [OPTIONS] COMMAND [ARGS]...                                                                                          Convert documents to a unified representation, locally with       `convert` or through a docling-serve service with                 `convert-remote`.                                                                                                                  ╭─ Options ──────────────────────────────────────────────────────╮│ --help          Show this message and exit.                    │╰────────────────────────────────────────────────────────────────╯╭─ Commands ─────────────────────────────────────────────────────╮│ convert                                                        ││ convert-remote  Convert via a remote docling-serve service     ││                 (see `docling convert-remote --help`).         │╰────────────────────────────────────────────────────────────────╯                                                                   Remote conversion: when installed with the `service-client`       extra, use `docling convert-remote` and read `docling             convert-remote --help` for authentication (DOCLING_SERVICE_URL /  DOCLING_SERVICE_API_KEY), supported options, and exit codes       before invoking it.                                                                                                                                                                                          Command being timed: "python /data/data/com.termux/files/usr/bin/docling --help"                                                    User time (seconds): 30.61                                        System time (seconds): 14.60                                      Percent of CPU this job got: 73%                                  Elapsed (wall clock) time (h:mm:ss or m:ss): 1:01.37              Average shared text size (kbytes): 0                              Average unshared data size (kbytes): 0                            Average stack size (kbytes): 0                                    Average total size (kbytes): 0                                    Maximum resident set size (kbytes): 683832                        Average resident set size (kbytes): 0                             Major (requiring I/O) page faults: 729                            Minor (reclaiming a frame) page faults: 289676                    Voluntary context switches: 79547                                 Involuntary context switches: 19780                               Swaps: 0                                                          File system inputs: 2169984                                       File system outputs: 64                                           Socket messages sent: 0                                           Socket messages received: 0                                       Signals delivered: 0                                              Page size (bytes): 4096                                           Exit status: 0

...

Docling version

                                    .../0/Movies $ uname -a                                           Linux localhost 4.14.186+ #1 SMP PREEMPT Thu Mar 17 16:28:22 CST 2022 aarch64 Android                                               .../0/Movies $ docling --version                                  WARNING: linker: Warning: "/data/data/com.termux/files/usr/lib/python3.14/site-packages/pypdfium2_raw/libpdfium.so" unused DT entry: unknown processor-specific (type 0x70000001 arg 0x0) (ignoring)  WARNING: linker: Warning: "/data/data/com.termux/files/usr/lib/python3.14/site-packages/optree.libs/libc++_shared-d523468d.so" unused DT entry: unknown processor-specific (type 0x70000001 arg 0x0) (ignoring)                                                         Docling version: 2.109.0                                          Docling Core version: 2.86.0                                      Docling IBM Models version: 3.13.3                                Docling Parse version: 7.5.0                                      Python: cpython-314 (3.14.6)                                      Platform: Android-11-aarch64-64bit-ELF                            .../0/Movies $

[dosubot]

This looks like a torchao-specific issue rather than a Docling bug. torchao is not a dependency of Docling — it's not listed as a required or optional dependency anywhere in the project [1] [2]. It must have been installed separately or pulled in by something else in your environment.

The bus error occurs during the import of torchao's native code (csrc_meta_ops), which suggests the torchao 0.17.0+cpu binary you have installed is incompatible with your platform (Android aarch64 on an older kernel 4.14 + Python 3.14). This is a crash in torchao's compiled C extensions, not in Docling's code.

Since uninstalling torchao resolves the issue and Docling doesn't need it, keeping it uninstalled is the correct fix. If you do need torchao for other work, you'd want to report this upstream to pytorch/ao regarding Termux/Android compatibility with Python 3.14.

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.