mediuminstallation

ChromeDriver Mismatch on Apple M1/M2 Macs

Published 2/24/2026

Symptoms

browse_website command fails with error. Web browsing功能无法工作 on Apple Silicon Macs (M1, M1 Max, M2).

Root Cause

The default ChromeDriver binary is compiled for x86_64 architecture and is incompatible with ARM64 (Apple Silicon). Rosetta 2 translation may not work properly for this specific binary.

Solution

Solution Steps

Install ARM64-compatible ChromeDriver:

# Using Homebrew
brew install --cask chromedriver

Update ChromeDriver path in configuration:

# In .env file
CHROMEDRIVER_PATH=/opt/homebrew/bin/chromedriver

Alternative: Use webdriver-manager:

pip install webdriver-manager

Then update your code:

from webdriver_manager.chrome import ChromeDriverManager
from selenium import webdriver

driver = webdriver.Chrome(ChromeDriverManager().install())

Verify architecture:

file $(which chromedriver)
# Should show: Mach-O 64-bit executable arm64

Verification

Run the browse_website command and confirm that it successfully opens a browser and retrieves web content. Check that ChromeDriver is running natively on ARM64.

Affected Components

browserselenium

ChromeDriver Mismatch on Apple M1/M2 Macs

Solution Steps

Tags

Affected Components