Skip to content

Document how to fix an Apple Silicon Rosetta 2 setup - #7

Merged
AlexWindels merged 1 commit into
mainfrom
docs/apple-silicon-setup
Aug 7, 2026
Merged

Document how to fix an Apple Silicon Rosetta 2 setup#7
AlexWindels merged 1 commit into
mainfrom
docs/apple-silicon-setup

Conversation

@AlexWindels

Copy link
Copy Markdown
Collaborator

Summary

  • A package can't auto-fix its own interpreter's architecture -- by the time pip install runs, that's already fixed, so this genuinely can't be solved from inside CANDy itself.
  • Adds an "Apple Silicon setup" README section with two concrete, copy-pasteable fixes:
    • Option A (recommended): uv tool install candy-cazyme -- uv always installs a native-architecture Python, giving an isolated candy command with zero manual venv/PATH management.
    • Option B (manual): Homebrew at the correct (/opt/homebrew) prefix, plus a check for the actual most common root cause -- Terminal.app/iTerm running under Rosetta itself (a per-app "Open using Rosetta" setting, independent of which Homebrew prefix happens to be on PATH).
  • Points the existing runtime Rosetta-detection warning (added in Fix stale Gemini install docs and warn on Rosetta SIGILL crash #4) at this section instead of a generic one-liner.

Test plan

  • pytest -- 114 passed
  • Reviewer: confirm CI passes on this PR

A package can't retroactively fix its own interpreter's architecture --
by the time `pip install` runs, that's already fixed -- so this can't
be auto-remediated from inside CANDy. Add a proper "Apple Silicon
setup" README section with copy-pasteable steps: a uv-based one-liner
(uv always installs the native architecture), and a manual Homebrew
path with the Terminal-under-Rosetta check that's the most common
actual cause (an Intel-only Terminal.app/iTerm profile, independent of
which Homebrew prefix is on PATH). Point the runtime Rosetta-detection
warning at this section instead of a generic one-line suggestion.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@AlexWindels
AlexWindels merged commit aaf8d24 into main Aug 7, 2026
6 checks passed
@AlexWindels
AlexWindels deleted the docs/apple-silicon-setup branch August 7, 2026 11:59
Sign up for free to 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.

1 participant