Repository navigation
feat(desktop): set up everything automatically on first launch - #22
Merged
Merged
Conversation
Packaged desktop installs previously stopped on first launch unless the user had installed uv, git and a Rust toolchain, and the bundled Ollama shipped without its inference libraries, so models couldn't run unless Ollama was installed separately. - Bundle uv and a prebuilt runtime (Locus wheel, locus_rust wheel and hash-locked requirements) per platform. On first launch, or after an app update, the app installs it into ~/.locus/desktop-runtime with a uv-managed Python and runs `locus serve` from there. Source checkouts (LOCUS_ROOT, or running from inside a checkout) work as before. - Bundle Ollama's CPU and Vulkan runtime on Windows and Linux and its helper libraries on macOS; skip CUDA/ROCm to keep installers small. - Find bundled sidecars beside the app on every platform, and hide console windows for child processes on Windows. - Release builds smoke-test the bundled runtime before publishing; PRs run the same check on Linux and Windows. - Replace the leftover OpenJarvis CLI banners with a Locus wordmark. - Update the README and docs: no backend or developer tools to install.
The test fell back to a live DuckDuckGo search and failed whenever it returned no results to the CI runner.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
On a fresh PC, the packaged desktop app stopped on first launch unless the user had already installed uv, git and a Rust toolchain (plus Visual Studio Build Tools on Windows): it cloned the source repo and compiled
locus_rustlocally. The bundled Ollama also shipped without its inference libraries on Windows x64, macOS and Linux, so models couldn't run unless Ollama was installed separately.After this PR, first launch sets everything up itself.
How it works
uv, the Locus wheel, a prebuiltlocus_rustwheel and hash-locked requirements exported fromuv.lock, underruntime/.~/.locus/desktop-runtimewith a uv-managed Python 3.12, then runslocus servefrom it. An install stamp keyed on the bundled manifest triggers a reinstall when the app version changes.LOCUS_ROOTis set or the app runs from inside a checkout, it usesuv sync/uv run locusas before.Changes
frontend/src-tauri/src/runtime.rs(new): manifest parsing, install steps, install stamp and error messages, with unit tests.frontend/src-tauri/src/lib.rs:scripts/download-uv.sh(new): pinned uv 0.13.6, verified against the published SHA-256 checksums.scripts/build-runtime.sh(new): builds the bundled runtime per platform. Windows ARM64 gets an x64 runtime, matching the existing emulated backend.scripts/runtime-smoke.sh(new): installs the bundle exactly as the app does, then checks thatlocus servereports healthy against a stand-in Ollama API.scripts/download-ollama.sh: bundles the inference runtime for every target.desktop.yml:runtime-smokePR job on Linux and WindowsTesting
locus servereached HTTP 200 on/healthin 13 s against a stand-in Ollama.download-uv.shdownloads and verifies uv on Windows.bash -n, anddesktop.ymlparses.validatejob (cargo test) is the first compile and unit-test run, andruntime-smokeis the first end-to-end run with thelocus_rustwheel.