Installation
Install Hybrix on your machine using npm, npx for a zero-install experience, or build from source for full control.
Install via npm
The recommended way to install Hybrix is globally via npm. This gives you the hybrix CLI command system-wide.
bash
npm install -g hybrix-labVerify the installation by checking the version:
bash
hybrix --versionRun with npx (zero install)
If you prefer not to install globally, use npx to run Hybrix directly. This always pulls the latest version.
bash
npx hybrix-lab initUsing npx is great for one-off projects or trying Hybrix for the first time. For daily use, a global install avoids the download delay on each run.
Build from source
Clone the repository and build locally if you want to contribute or customize the core:
bash
git clone https://github.com/hybrix-lab/hybrix.git
cd hybrix
npm install
npm run build
npm linkAfter linking, the hybrix command points to your local build.
System requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| Node.js | v18.0+ | v20 LTS or v22 |
| npm | v9+ | v10+ |
| OS | macOS, Linux, Windows (WSL) | macOS or Linux |
| RAM | 512 MB free | 2 GB+ for multi-agent setups |
Windows users must use WSL (Windows Subsystem for Linux) or a Unix-compatible shell. Native Windows CMD and PowerShell are not supported.