paperang-cli npm wrapper

This npm package installs the matching Python paperang-cli release from PyPI and exposes the same two commands:

• paperang
• paperang-cli

Requirements

• Node.js 22.14.0 or newer
• npm 11.5.1 or newer
• Python 3.10 or newer

Install

npm install --global paperang-cli
paperang --help

The wrapper runs a postinstall lifecycle script that installs the matching paperang-cli version from PyPI during npm installation. It first installs or updates dependencies, then reinstalls only the top-level Python package with --force-reinstall --no-deps. This replaces same-version editable installations without reinstalling heavy runtime dependencies. The complete sequence retries with --user if the first install scope fails.

To inspect the wrapper before allowing lifecycle scripts to run:

npm install --global paperang-cli --ignore-scripts
python -m pip install --upgrade paperang-cli

Real Bluetooth Low Energy communication and physical printing have been tested only on Windows. CI compatibility checks on Linux and macOS do not prove hardware behavior on those platforms.

The npm wrapper exposes the same smart-layout CLI surface as the Python package, including --style-json for preset-driven dry-runs and length-aware layout checks.

Example:

paperang --json print paragraph "221B Baker Street London" --dry-run --style-json .\address-label.json

See the main repository command reference for ready-to-copy JSON payloads for address labels, long logo strips, and composed badge layouts.

See the main repository and its security policy for usage, safety notes, and documentation.