Installation & Download

This guide explains the practical end-to-end path for ManifestGuard Python: public bootstrap, device hash, customer login, local activation, then Trial/Pro from My Licenses or license update-apply.

Key points

• CLI: On Windows the examples use the recommended py -3.12 -m <module> ... form (for example py -3.12 -m manifestguard ...). On Linux/macOS this usually maps to python3.12 -m ....
• Requirements: The documented default path uses Python 3.12 with pip; on Windows typically via py -3.12, on Linux/macOS typically via python3.12.
• Project versions: Independent of the install interpreter, mgpy can analyze Python projects, packaging metadata and tool targets for versions from 3.8 to 3.12; the currently shipped Trial/Pro wheel is cp312 and must be installed and executed with Python 3.12.
• Trial/Pro: not via pip from PyPI and not via GitHub install-protected. After activation, download the ZIP from My Licenses or run py -3.12 -m manifestguard license update-apply in the same interpreter. Then verify with py -3.12 -m manifestguard --version.
• The current public bootstrap version is listed at https://pypi.org/project/manifestguard/ ; <VERSION> refers to that package version, while 3.12 here is the required Python version for the Trial/Pro runtime. Public pip install manifestguard is bootstrap only.
• Download and installation happen directly through pip: use py -3.12 -m pip install --user --upgrade manifestguard for the latest public bootstrap release or py -3.12 -m pip install --user "manifestguard==<VERSION>" for a pinned package version.
• A Trial/Pro ZIP from My Licenses is installed with pip as well, for example from the wheel file or via --no-index --find-links <bundle-dir>, instead of unpacking files manually. The recommended path is py -3.12 -m manifestguard license update-apply.
• Pick and buy the correct license tier on the product page licensing table at /mgpy#licensing.
• After purchase, sign in on the same domain at /login and then continue to /license/activate.
• For activation you need your local device hash from py -3.12 -m manifestguard license device-hash, your license key from checkout/email and the resulting portal token for CLI or later MGVS.
• Install count: only the first successful license activate or license ping-install counts; check and --help do not ping Zebra.
• Privacy: install/update counts go to Streamingzebra (module mgpy; license hash and version, no source code). Details: https://www.ready-4-it.com/privacy — opt-out: py -3.12 -m manifestguard license lifecycle --off.
• Pro self-update: once Trial/Pro is installed, it updates itself. In the same interpreter (project venv preferred) run py -3.12 -m manifestguard license update-apply. Optionally check first with py -3.12 -m manifestguard license update-check. Do not pip install --upgrade manifestguard from PyPI for Pro.

Recommended mgpy workflow

1. If needed, first check the current public bootstrap version on https://pypi.org/project/manifestguard/ and then install the default latest package with py -3.12 -m pip install --user --upgrade manifestguard. If you need a specific package release, pin it with py -3.12 -m pip install --user "manifestguard==<VERSION>".
2. Buy or open your license under /mgpy#licensing, sign in at /login and then switch to /license/activate.
3. Collect the local device hash with py -3.12 -m manifestguard license device-hash, enter the license key and device hash on /license/activate, then copy the activation token returned by the portal.
4. Activate the token locally with py -3.12 -m manifestguard license activate <TOKEN>. You can later reuse the same token in MGVS in its activation/license view.
5. Trial/Pro: py -3.12 -m manifestguard license update-apply downloads the entitled ZIP and pip-installs the wheel into this interpreter. Alternatively download the ZIP from My Licenses and install with py -3.12 -m pip install --user --no-index --find-links <bundle-dir> manifestguard.
6. Later Pro updates: run the same command again in that interpreter: py -3.12 -m manifestguard license update-apply. That is the self-update; public PyPI --upgrade stays bootstrap-only.
7. Finish by checking py -3.12 -m manifestguard license status so you can see that the local license is active.

Quick start

py -3.12 -m pip install --user --upgrade manifestguard
py -3.12 -m pip install --user "manifestguard==<VERSION>"
py -3.12 -m manifestguard --version
py -3.12 -m manifestguard license device-hash
py -3.12 -m manifestguard license activate <TOKEN>
py -3.12 -m manifestguard license update-check
py -3.12 -m manifestguard license update-apply
py -3.12 -m manifestguard license status