1. Download the installer

    Grab the latest Windows installer directly from GitHub Releases:

  2. Run the installer

    Double-click OsdagBridge-Setup.exe and follow the on-screen prompts.

    Windows SmartScreen notice Since the installer isn't yet code-signed, Windows may show a "Windows protected your PC" prompt. Click More infoRun anyway to continue.
  3. Launch OsdagBridge

    Use the desktop shortcut or the Start Menu entry created by the installer.

  4. Uninstalling

    Use Add or Remove Programs, or run the uninstaller shortcut created alongside the app.

  1. Download the installer

    Grab the latest Linux shell installer directly from GitHub Releases:

  2. Make it executable

    chmod +x OsdagBridge-Linux.sh
  3. Run the installer

    ./OsdagBridge-Linux.sh

    Follow the prompts to choose an install location. By default OsdagBridge installs to $HOME/OsdagBridge.

  4. Launch OsdagBridge

    $HOME/OsdagBridge/bin/osdagbridge
  5. Uninstalling

    Run the bundled uninstall script from the install directory:

    $HOME/OsdagBridge/Uninstall-OsdagBridge.sh

Building from source

For contributors, or platforms without a prebuilt installer (e.g. macOS).

  1. Clone the repository

    git clone https://github.com/garvit000/OsdagBridge.git
    cd OsdagBridge
  2. Install in editable mode

    pip install -e .
  3. Run the desktop app

    python -m osdagbridge.desktop
  4. Or run the CLI

    osdagbridge analyze project.yaml --solver native

Continue to Getting Started for a full walkthrough of the desktop, web, and CLI workflows.