XyPriss CLI — Installation Guide #
This document provides step-by-step instructions for installing the XyPriss CLI (xyp, also known as xfpm) on all supported operating systems.
Requirements #
Before installing, ensure the following prerequisites are met:
- Node.js: Version 18 or later is required.
- Internet connection: Needed to download the optimized Rust engine during installation.
Installation (Unified Installer) #
XyPriss is distributed through a unified installer that automatically detects your operating system and CPU architecture, then installs the appropriate binary and configures your PATH.
Linux & macOS #
Open a terminal and run:
curl -sL https://xypriss.nehonix.com/install.js | node
Windows (PowerShell) #
Run the following command in PowerShell:
Invoke-WebRequest -Uri https://xypriss.nehonix.com/install.js -OutFile install.js; node install.js; Remove-Item install.js
The installer will download the engine, configure aliases, and make the CLI globally accessible.
Updating XyPriss #
To update to the latest version, simply re-run the installation command for your platform.
If an existing installation is detected, the installer will prompt you before overwriting it with the newest version.
Uninstallation #
To completely remove XyPriss and all related aliases:
Linux / macOS #
curl -sL https://xypriss.nehonix.com/install.js | node - uninstall
Windows (PowerShell) #
Invoke-WebRequest -Uri https://xypriss.nehonix.com/install.js -OutFile install.js; node install.js uninstall; Remove-Item install.js
This removes the engine binaries and PATH mappings created by the installer.
Verification #
After installation, verify that XyPriss is available by running:
xyp
or
xfpm
You should see the current XFPM version along with architecture information.
Troubleshooting #
Permission denied (Linux/macOS) #
If you encounter an EACCES error, the installer may require elevated privileges to create symlinks in /usr/local/bin.
You will be prompted for your password if necessary.
PowerShell execution policy (Windows) #
If PowerShell blocks the script, enable local script execution with:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Then re-run the installer.
Command not found after installation #
If xyp or xfpm is not recognized:
- Restart your terminal to refresh environment variables.
- On Linux/macOS, ensure
/usr/local/binis included in your$PATH. - On Windows, verify that
$HOME\.xypriss\binexists in your User PATH (added automatically by the installer).