Manual Install

Use this guide to install Pyze on one machine: your own device, a test machine, or an unmanaged browser that is not covered by an enterprise deployment. No admin rights are needed.

There are two steps: install the browser extension, then run the native host helper.

Prerequisites: Your Pyze contact or administrator has sent you:

• The Chrome Web Store link, or the extension package pyze-<customer>-<version>.zip
• The native host helper folder for your operating system: pyze-native-host-<customer>-windows or pyze-native-host-<customer>-macos

Step 1: Install the Extension

Use whichever applies: the store, or the package your Pyze contact sent you.

Option A: From the Chrome Web Store

Open the store link your Pyze contact gave you.

• Chrome: click Add to Chrome.
• Edge: if the link is an Edge Add-ons listing, click Get. If it is a Chrome Web Store listing, allow extensions from other stores when asked, then click Add.

Continue to Step 2.

Option B: From the Package

Extract the extension

Before installing, extract the extension files to a permanent location.

1. Locate the downloaded ZIP file (pyze-<customer>-<version>.zip)
2. Right-click the ZIP file and select Extract All
3. Choose a permanent location, for example:
   • Windows: C:\Extensions\pyze-extension
   • macOS: ~/Extensions/pyze-extension

The package carries a pinned signing key, so the extension keeps the same ID that the native host trusts. Load only the package Pyze sent you. A store build loaded unpacked gets a different ID and the native host rejects it.

Load the extension

Select your browser below and follow the installation steps.

• Chrome
• Edge

Enable Developer Mode

1. Open Google Chrome
2. Navigate to chrome://extensions/
3. Toggle Developer mode ON (top-right corner)

×

Load the Extension

1. Click Load unpacked
2. Navigate to and select the extracted pyze-extension folder
3. The Pyze <Customer> extension appears in your extensions list

×

If Chrome shows a “Disable developer mode extensions” message at start-up, close it. The extension stays on.

Enable Developer Mode

1. Open Microsoft Edge
2. Navigate to edge://extensions/
3. Toggle Developer mode ON (bottom-left corner)

×

Load the Extension

1. Click Load unpacked
2. Navigate to and select the extracted pyze-extension folder
3. The Pyze <Customer> extension appears in your extensions list

×

Note

If prompted with “Turn off Developer mode?”, select Not now to keep the extension active.

×

Step 2: Install the Native Host Helper

The native host is a small local helper that reads your OS username and hands the extension a hashed identifier (see Privacy note). Without it, the extension cannot identify the signed-in user.

You were given a folder for your operating system. Unzip it and keep all the files together. Do not move the files out of the folder.

• Windows: pyze-native-host-<customer>-windows
• macOS: pyze-native-host-<customer>-macos

• Windows
• macOS

Done

Pyze now runs automatically on the approved sites. Nothing else is needed.

Removing Pyze

1. Remove the extension on chrome://extensions/ (Edge: edge://extensions/)
2. Run uninstall-windows.bat (Windows) or uninstall-macos.command (macOS) from the same native host folder you installed from

Troubleshooting

To see why users are not identified, open chrome://extensions/ (Edge: edge://extensions/), turn on Developer mode, click service worker under the Pyze extension, and reload the extension. The first Pyze: lines in the console name the problem. On a company-managed browser the service worker link is hidden until IT sets the DeveloperToolsAvailability policy to 1; see Native Host Troubleshooting for the policy and for the full set of native host errors.

Privacy Note

The native host reads your OS username and sends only a SHA-256 hash of it. The username itself is never sent. The hash is a stable pseudonymous identifier, so the same user gets the same ID on every machine.