Skip to content

Fix stale Gemini install docs and warn on Rosetta SIGILL crash - #4

Merged
AlexWindels merged 1 commit into
mainfrom
fix/mac-domain-curation-issue
Aug 7, 2026
Merged

Fix stale Gemini install docs and warn on Rosetta SIGILL crash#4
AlexWindels merged 1 commit into
mainfrom
fix/mac-domain-curation-issue

Conversation

@AlexWindels

@AlexWindelsAlexWindels commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Fixes#3.

Summary

  • README's Gemini install instructions still showed the pre-publish editable-install form (pip install -e ".[gemini]"), left over from before the package was on PyPI -- not usable post-install, and also not zsh-safe unquoted (zsh treats [gemini] as a glob). Fixed to pip install "candy-cazyme[gemini]", and removed a duplicate copy of the same instruction elsewhere in the README.
  • The crash reported in Domain curation Gemini Mac failed #3 (zsh: illegal hardware instruction during the FAMSA alignment step, no Python traceback) traces to the Mac's Python being an Intel-prefix (/usr/local) Homebrew build -- i.e. x86_64 Python running under Rosetta 2 translation on Apple Silicon hardware, a known cause of SIGILL in native SIMD code (both FAMSA and VeryFastTree ship compiled SIMD) due to Rosetta's imperfect instruction emulation.
  • Since this is a native-code crash, it can't be caught from Python -- so instead, run_pipeline now detects a translated process at startup (via sysctl -n sysctl.proc_translated, gated to --tree runs since that's the only path that invokes FAMSA/VeryFastTree) and logs an actionable warning before the potentially long clustering/curation stages run, rather than the user finding out from a bare shell crash after several minutes. README also documents the underlying fix (use a native arm64 Python).

Test plan

  • pytest -- 113 passed (5 new tests for the Rosetta-detection helper: warns when translated, silent on native arm64/genuine Intel/non-macOS, and doesn't crash if sysctl itself is missing)
  • Reviewer: confirm CI passes on this PR

Fixes#3.
- README's Gemini install instructions still showed the pre-publish
editable-install form (`pip install -e ".[gemini]"`), which doesn't
work against the published package and isn't zsh-safe unquoted either.
Point at `pip install "candy-cazyme[gemini]"` instead, and de-duplicate
the instruction (it was written out twice).
- A real Mac run crashed with "illegal hardware instruction" (SIGILL, no
Python traceback) during the FAMSA alignment step. The Mac's Python was
an Intel-prefix (/usr/local) Homebrew build, pointing at x86_64 Python
running under Rosetta 2 translation on Apple Silicon hardware -- a known
cause of SIGILL in native SIMD code (FAMSA/VeryFastTree both ship
compiled SIMD) due to Rosetta's imperfect instruction emulation. Detect
this at pipeline startup (before the potentially long clustering/curation
stages run) via `sysctl -n sysctl.proc_translated` and log an actionable
warning instead of letting the run crash silently near the end.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@AlexWindels
AlexWindels merged commit 1604273 into mainAug 7, 2026
6 checks passed
AlexWindels pushed a commit that referenced this pull request Aug 7, 2026
Patch release: fixes stale Gemini install docs and adds a startup
warning for the Rosetta 2 SIGILL crash class (#3/#4).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@AlexWindels
AlexWindels deleted the fix/mac-domain-curation-issue branch August 7, 2026 11:59
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Domain curation Gemini Mac failed

1 participant

@AlexWindels