Add downloadable macOS launcher app builder

build-macos-app.sh generates dist/Odysseus.app and a drag-to-Applications
dist/Odysseus.dmg. The app starts the local server from this repo's venv and
opens the UI in a chrome-less app window (Chromium --app mode, falling back to
the default browser). It's a launcher wrapper — it drives the venv rather than
bundling Python — so the install path is baked in at build time.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
yunggilja
2026-05-31 21:08:43 -05:00
parent 0ad8896c03
commit 7927940c38
2 changed files with 172 additions and 0 deletions
+8
View File
@@ -138,6 +138,14 @@ equivalent of the systemd unit), use the bundled launchd installer:
ODYSSEUS_PORT=7860 ./install-service-macos.sh # if 7000 is taken by AirPlay
```
Prefer a clickable app? Build a launcher `Odysseus.app` (+ a drag-to-Applications
`.dmg`) that starts the local server and opens the UI in its own window:
```bash
./build-macos-app.sh # → dist/Odysseus.app and dist/Odysseus.dmg
```
This wraps the venv in this repo (it doesn't bundle Python), so the install path
is baked in at build time — rebuild if you move the repo.
### Option 3: Manual install — Windows (PowerShell)
Windows support is not actively tested. Use it with caution; Docker on Linux
or a Linux/macOS manual install is the safer path for now.