Mu for Windows, macOS and Linux packages the React app with Electron. No Node.js, local server setup or Mu installation is required by users. Models and tools run on the chosen Mu server. The default is micro.mu; Settings selects another server.
Native menus provide New chat (Ctrl/Cmd+N), Settings (Ctrl/Cmd+,), and navigation to Home, Inbox, Agents, Services and All chats (Ctrl/Cmd+1–5). Window size and position are remembered and adjusted when a monitor is disconnected. Help links to the latest downloads; updates are installed manually.
The app uses a sandboxed renderer with no Node integration. A per-launch loopback
server serves bundled assets under an unpredictable path. OAuth opens the system
browser and returns through a state-checked, single-use loopback callback. PKCE
is still checked by the runtime. Tokens are retained only with OS-backed encryption;
Linux's plaintext basic_text backend is not used. Otherwise sign-in lasts for
the app session, with a notice on sign-in and Account. Playback and microphone features depend on Electron/platform support;
there is no desktop background wake-word promise.
From the repository root with Node.js 24+:
npm ci --prefix client/web
npm run build --prefix client/web
npm ci --prefix client/desktop
npm run prepare:app --prefix client/desktop
npm start --prefix client/desktopRun npm test --prefix client/desktop for the local callback boundary tests.
node smoke.mjs from this directory runs the installed Electron app's sign-in and
chat check (Linux needs a graphical display, e.g. Xvfb). It keeps Electron's sandbox.
npm run package --prefix client/desktop creates platform installers in dist/.
The desktop workflow builds Windows x64 NSIS, macOS arm64/x64 DMG, and Linux x64 AppImage/DEB. Release CI attaches supported installers to the same Mu release. PR builds retain installers and screenshots as Actions artifacts.
macOS consumer downloads require Developer ID signing and notarization. Configure
DESKTOP_CSC_LINK, DESKTOP_CSC_KEY_PASSWORD, APPLE_ID,
APPLE_APP_SPECIFIC_PASSWORD and APPLE_TEAM_ID as repository secrets. No App Store
submission is involved. Without those credentials, macOS builds remain Actions
artifacts and are not presented as consumer downloads.
Windows signing optionally uses DESKTOP_WIN_CSC_LINK and
DESKTOP_WIN_CSC_KEY_PASSWORD; unsigned installers may display an unknown-publisher
warning. Linux packages do not require an app store. Updates are currently manual:
download the new installer from Mu. Automatic updates are not implemented.