Installation

Installation

Windows

1. Download the latest Halny-Vibe-Deck-Setup-<version>.exe (installer) or Halny-Vibe-Deck-<version>-portable.zip (no-install) from the releases page.
2. Run the installer — or unzip the portable version anywhere and start the exe.
3. In-app self-updates keep you on the latest version automatically.

Linux

User install (recommended for desktops)

curl -fsSL https://raw.githubusercontent.com/Dragonk/halny-vibe-deck/main/scripts/install-linux.sh | bash

Installs into ~/.local/share/halny-vibe-deck/app, adds the halny command to ~/.local/bin and a desktop entry. Re-run to upgrade; in-app self-update works too.

AppImage

Download halny-vibe-deck-<version>-x64.AppImage from releases:

chmod +x halny-vibe-deck-<version>-x64.AppImage
./halny-vibe-deck-<version>-x64.AppImage

If your system has no FUSE (common on servers), extract it once and run the extracted app:

./halny-vibe-deck-<version>-x64.AppImage --appimage-extract
mv squashfs-root halny
"$PWD/halny/halny-vibe-deck"

See Headless Server for running it as a service without a GUI.

From source

git clone https://github.com/Dragonk/halny-vibe-deck.git
cd halny-vibe-deck
npm install
npm run build
npx electron .            # desktop app

Requires Node.js 16+ (24 recommended).

First run

On first start Halny installs the mistral-vibe CLI automatically using uv (or pip install mistral-vibe / uv tool install mistral-vibe manually) and guides you through any missing setup.

CLI flags

Flag	Meaning
--headless	Start without a window (for servers)
--serve	Start the built-in HTTPS server
--port=8443	Server port (default 8443)
--user=<name>	Set the serve login (stored as scrypt hash)
--password=<secret>	Set the serve password
--cert=<path> --key=<path>	Use your own TLS certificate instead of the generated self-signed one

Both --flag value and --flag=value forms are accepted.

Where data lives

• App config: Electron userData dir (~/.config/halny-vibe-deck/config.json on Linux, %APPDATA%\halny-vibe-deck on Windows)
• Agent sessions: ~/.vibe/logs/ (managed by the CLI)
• Model/agent/MCP config: ~/.vibe/config.toml (editable in-app)