Build From Source
Build the agent from source in five ordered steps.
A full build produces the core engine, the Node sidecar, the web UI, the Electron shell and finally the platform installer. Each step depends on the previous one, so a failure early is a real failure rather than a stale artefact.
Clone and install
bash
git clone https://github.com/onelpawarai-X/ZYRAXON-AI.git cd ZYRAXON-AI bun install
Build in order
- 01Step 1 · Core (AI engine and server) --
bun run --cwd packages/zyraxon build - 02Step 2 · Node sidecar --
bun run --cwd packages/cli build - 03Step 3 · Web UI --
bun run --cwd packages/app build - 04Step 4 · Electron shell --
bun run --cwd packages/desktop build - 05Step 5 · Installer --
bun run --cwd packages/desktop package
Command reference
| Command | Description |
|---|---|
bun run --cwd packages/zyraxon build | Build the AI core and server |
bun run --cwd packages/cli build | Build the Node sidecar |
bun run --cwd packages/app build | Build the web UI |
bun run --cwd packages/desktop build | Build the Electron shell |
bun run --cwd packages/desktop package | Package the installer |
Running from source
bash
# Desktop application bun run --cwd packages/desktop dev # Core engine in TUI mode bun run --cwd packages/zyraxon dev
⚠
Low-memory machines
On a machine with less than 16 GB available to the build, raise the heap first:
export NODE_OPTIONS="--max-old-space-size=16384".⚠
Windows: EPERM on dxcompiler.dll
A file lock from antivirus or a lingering Electron process. End the process, delete the locked file, and retry the build.