Install Decisionhouse

Decisionhouse is currently distributed as a preview for macOS and Linux. Windows is supported through the Windows Subsystem for Linux.

macOS and Linux

1. Run the installer from an interactive terminal.

   curl -fsSL https://get.deql.osm-data.com | sh

2. Choose your data source when prompted.

   Enter a database URL or a path to a local file. The installer creates a deql directory containing the binary and deql-config.toml. DeQL finds that config automatically, even when it is launched from another working directory.

3. Verify the installation from inside that directory.

   ./deql --help

The binary is local

The preview installer does not add the deql binary to your PATH. Commands in this documentation use ./deql from inside the generated deql directory. MCP registration uses the binary’s absolute path and does not require PATH setup.

Optional: add DeQL to PATH

Add the existing install directory to PATH without moving or copying the binary. For zsh, run this once from inside the generated deql directory:

printf '\nexport PATH=%q:$PATH\n' "$PWD" >> "$HOME/.zshrc"
export PATH="$PWD:$PATH"

For Bash, replace ~/.zshrc with ~/.bashrc. Other shells use different startup and PATH syntax; follow your shell’s documentation.

Windows

Install Decisionhouse from a Linux shell under WSL, then follow the Linux instructions above. Native Windows binaries are not currently provided.

Default server address

The installer writes editable defaults to deql-config.toml. DeQL looks for that file in the working directory and then beside the installed binary; an explicit --config <path> overrides both locations. The local server listens on 127.0.0.1:6134 unless you change the configuration.