Setup Desktop

Install

Use one of these install paths:

1. Download prebuilt Desktop artifacts from this project’s releases page: https://github.com/XtremeHarness/alphabase/releases
2. If release artifacts are not available yet, run from source:

bun run dev:desktop

This starts the canonical Codex-enabled Electron shell. It reuses source-fingerprinted runtime artifacts when valid; use bun run dev:desktop:rebuild for a clean rebuild. The former Tauri host is available only through the explicit compatibility command bun run dev:desktop:tauri while it is retired.

First-Run Checklist

1. open AlphaBase Desktop
2. open your workspace folder
3. connect at least one model provider
4. select model + agent
5. run a simple file-generation prompt

Example prompt:

Create hello-world.txt with the text "Hello, AlphaBase desktop".

Expected signals:

• tool activity appears
• file write succeeds in workspace
• final completion response is visible

If Something Fails

Use Runtime Diagnostics then Troubleshooting.