Docs/Installation

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-lab

Verify the installation by checking the version:

bash
hybrix --version

Run 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 init
Using 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 link

After linking, the hybrix command points to your local build.

System requirements

RequirementMinimumRecommended
Node.jsv18.0+v20 LTS or v22
npmv9+v10+
OSmacOS, Linux, Windows (WSL)macOS or Linux
RAM512 MB free2 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.