feat(macos): add native Homebrew install path #9

2026-08-26T13:30:32Z

Athena commented

2026-08-26 13:30:32 +00:00

Summary

Adds a Homebrew-backed native macOS installer.
Skips Linux-only provisioning stages on Darwin.
Selects the GPU-agnostic base requirements because native Ollama provides Metal-accelerated inference outside the Python environment.
Adds macOS setup/update documentation and release-gate shell parsing.

Dependency

Stacked on the portable packaging PR. Merge packaging first; this diff then reduces to six macOS-specific files.

Verification

bash -n install-macos.sh passed.
33 macOS guard and backend smoke tests passed, with one existing skip.
Platform tests verify Darwin chooses requirements-base.txt and never enters Linux provisioning.

This was validated from Windows, so the PR remains community-supported until it receives an actual macOS install smoke test.

## Summary - Adds a Homebrew-backed native macOS installer. - Skips Linux-only provisioning stages on Darwin. - Selects the GPU-agnostic base requirements because native Ollama provides Metal-accelerated inference outside the Python environment. - Adds macOS setup/update documentation and release-gate shell parsing. ## Dependency Stacked on the portable packaging PR. Merge packaging first; this diff then reduces to six macOS-specific files. ## Verification - bash -n install-macos.sh passed. - 33 macOS guard and backend smoke tests passed, with one existing skip. - Platform tests verify Darwin chooses requirements-base.txt and never enters Linux provisioning. This was validated from Windows, so the PR remains community-supported until it receives an actual macOS install smoke test.

Athena added 8 commits 2026-08-26 13:30:33 +00:00

fix(sync): close SQLite handles before restore c3a7b6eefd

Use contextlib.closing for dump, comparison, and restore connections so Windows can unlink the live database immediately after the comparison step.

fix(memory): sweep legacy orphaned message vectors d56d579755

Repair vector rows left behind by older databases at store startup. Keep the existing single-statement delete path from main and avoid reintroducing the redundant batched helper.

fix(ollama): normalize hosts, errors, and reasoning output 2ebe93b4f7

Separate bind and client addresses, include Ollama's response body in HTTP failures, and strip inline <think> blocks from complete and streamed replies.

feat: add portable NexusOS CLI and packaging d579502a5b

feat(packaging): move the CLI into nexusos_cli and make the wheel self-sufficient 9104c724c4

The CLI shipped from `management/`, which also holds desktop-only pieces (the
Tk control panel, the XFCE panel wiring, the shell wrappers). Packaging that
directory meant the wheel either dragged in tkinter or shipped a broken import.
Split it: `nexusos_cli/` is what the wheel ships and what `nexus`/`ncp`/
`nexusos` dispatch to, `management/` keeps the desktop half.

Alongside the move:

* hatch_build.py decides the interface/web/dist include at build time. dist/
  is gitignored, so a static force-include aborts `pip install -e .` on a
  fresh clone - before the reader reaches the `npm run build` step. Editable
  installs now skip a missing dist; wheels and sdists hard-error naming the
  command to run.
* synapse/proc_util.py gives frontend_manager and ncp process inspection and
  termination without psutil, which became an optional extra when the wheel
  landed. It routes around Windows having no signals, where os.kill(pid, 15)
  is an unblockable TerminateProcess rather than a polite request.
* nexusos_cli/monitor.py adds `ncp monitor`, an ASCII dashboard with no curses
  or rich dependency so it works in Termux, plain SSH and Windows Terminal.
  Collector and renderer are separate so tests feed fixtures, no stack needed.
* tests/test_packaging_deps.py fails the gate when synapse or nexusos_cli
  import a distribution pyproject does not declare, and when an optional
  dependency is imported at module scope instead of lazily.
* bin/check.sh now builds the wheel, twine-checks it, and asserts the compiled
  UI and seed playbooks are actually inside it. A wheel that builds but ships
  no dist/ serves a blank page, which only shows up after release.

tests/test_nexus_api.py moves to tests/ with the module it covers.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

fix(packaging): include backend modules in distributions

package / wheel (pull_request) Waiting to run

Details

5f67d19e80

feat(macos): native install path via Homebrew 93d78c0ad3

install-macos.sh mirrors install.sh's split: every portable step - git pull,
venv, pip with the right overlay, npm build - stays in bin/sync.py, shared
with Linux and Windows. The script only does what sync.py cannot do for
itself on a bare Mac, which is install the Homebrew packages needed before a
Python exists to run sync.py with.

Two stages had to learn about darwin. ensure_exec_bits() keyed off
`os.name == "nt"`, which is false on macOS, so it ran the Linux path; and
requirements() had no darwin branch. linux_stage() now no-ops there, which is
what makes skipping the Ollama fetch correct rather than an omission:
bin/fetch-ollama.sh only ships a Linux x86-64 binary, and _ollama_bin() in
synapse/ollama_manager.py already prefers the bundled copy and falls back to
whatever `ollama` is on PATH. On macOS that is the brewed one, with Metal
acceleration and no flags needed.

The XFCE desktop branding is Linux-only and was already gated off macOS the
same way, so there is nothing to install for it here.

install-macos.sh joins the shell-parse list in bin/check.sh.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

test(macos): cover installer platform guards

package / wheel (pull_request) Waiting to run

Details

214ce07d1f

enderofwings referenced this pull request

2026-08-26 19:03:52 +00:00

feat(macos): add native Homebrew install path #14

enderofwings commented

2026-08-26 19:06:49 +00:00

Closing as superseded by #14: this branch carried forward as-is, plus dropping a stale "memory :8001" reference from the quickstart (that service was deleted 2026-08-25, before this PR existed - likely copied from the Linux quickstart's older wording). Merged onto main.

Everything else here - platform detection, install-macos.sh, the guard tests - reviewed clean, no changes needed.

Closing as superseded by #14: this branch carried forward as-is, plus dropping a stale "memory :8001" reference from the quickstart (that service was deleted 2026-08-25, before this PR existed - likely copied from the Linux quickstart's older wording). Merged onto main. Everything else here - platform detection, install-macos.sh, the guard tests - reviewed clean, no changes needed.

enderofwings closed this pull request

2026-08-26 19:06:50 +00:00

Pull request closed

Please reopen this pull request to perform a merge.

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: enderofwings/NexusOS#9

Allow edits from maintainers