Repository navigation
Beluga v0.1.0-preview.1
Pre-release
Pre-release
Run a coding agent in a project on your computer or Linux server, and inspect model requests and tool calls in Trajectory.
- Compose agent presets and connect Codex or an OpenAI-compatible provider.
- Install the Linux x64 CLI with npm and run the Host as a systemd user service.
- Run the Windows x64 portable app or installer, or host Beluga with Docker.
Install
Linux x64 requires Node.js 24 LTS.
npm install -g @retn0/beluga@preview
beluga service installFor Windows, download and extract beluga-windows-x64-portable.zip below. The optional Beluga_0.1.0-preview.1_x64-setup.exe installs the desktop app. Both downloads have accompanying SHA-256 checksums.
The Windows preview is unsigned and requires Microsoft Edge WebView2. If Windows blocks the desktop app, you can connect to a Linux Host in a browser.
The Linux x64 container image is ghcr.io/nbsp1221/beluga:0.1.0-preview.1.
docker pull ghcr.io/nbsp1221/beluga:0.1.0-preview.1See the installation guide and Host setup guide for access codes, provider setup, persistent data, project mounts, and remote access.