Skip to content

Install

WolfXL ships in two editions with the same package name, wolfxl:

Edition Where it installs from Version line
Community (MIT) Public PyPI, no credential 2.0.x
Commercial Authenticated WolfXL package index 2.1 and later

The version pin is what separates them. Always pin "wolfxl>=2.1" when you install Commercial.

WolfXL 2.1 private package

WolfXL 2.2.0 is distributed through the authenticated WolfXL package index. Save the per-purchase credential shown on the checkout success page (you can request a replacement at wolfxl.com/recover), then store it by following the Secure Install guide.

Install or upgrade from the configured private index:

python -m pip install --upgrade "wolfxl>=2.1" --index-url https://packages.wolfxl.com/simple/

Keep the quotes: without them, most shells treat > as a redirect.

Do not use --extra-index-url. The private index contains WolfXL and its required dependencies. If PIP_EXTRA_INDEX_URL or an extra-index-url entry in pip.conf points at public PyPI, an unpinned wolfxl can resolve to the Community 2.0 line from PyPI instead of Commercial. The >=2.1 pin prevents that: pip fails instead of silently installing the wrong edition.

Verify the installed version

python -c "import wolfxl; print(wolfxl.__version__)"

The command should print 2.2.0. A 2.0.x version means Community was installed from public PyPI; reinstall with the pinned command above.

Optional extras

Optional extras such as encrypted, calc, and mcp depend on public packages. Install those dependencies from public PyPI first, then install the pinned Commercial package with the extra from the private index:

python -m pip install msoffcrypto-tool cryptography
python -m pip install --upgrade "wolfxl[encrypted]>=2.1" --index-url https://packages.wolfxl.com/simple/

Community from public PyPI

Community needs no credential and no private index:

python -m pip install wolfxl

Troubleshooting