Investigation: Deprecated macOS Support — Impact on Langflow

Jira: LE-265
Date: 2026-04-02
Status: Complete
Related: LE-172 (PyTorch macOS x86_64 + Python 3.13 — resolved in PR #12469)

TL;DR

macOS Intel (x86_64) is in its final phase of deprecation across the entire ecosystem — Apple hardware, operating system, GitHub Actions runners, PyTorch, and the broader ML/AI stack. Langflow already has platform exclusion markers for the most critical torch-dependent extras (PR #12469), but additional deprecations in GitHub Actions runners, macOS versions, and upstream dependencies will require further action over the next 12–18 months.

Key decision required: Set a timeline to officially drop macOS x86_64 from Langflow's support matrix (recommended: Langflow 2.0 or Q4 2026, whichever comes first).

1. Deprecation Landscape

1.1 Apple Hardware & OS Timeline

Key fact: Apple's Rosetta 2 translates x86_64 binaries on Apple Silicon, but native ARM64 builds are preferred. Rosetta support for macOS is expected to continue but individual frameworks (e.g., Metal 3) are ARM-only.

1.2 GitHub Actions Runner Deprecation

Key fact: macos-latest-large is the only Intel x86_64 runner available. It is one of the most expensive GitHub Actions runners. GitHub has signaled the shift toward ARM-only macOS runners.

1.3 PyTorch macOS x86_64 Deprecation

Result: No PyTorch wheel exists for macOS x86_64 + Python ≥ 3.13. PyTorch 2.2.2 is the last version with Intel Mac support, and it only covers Python 3.10–3.12.

1.4 Broader ML Ecosystem

2. Current State of Langflow macOS Support

2.1 Platform Exclusion Markers in pyproject.toml

The following extras have platform markers excluding macOS x86_64 (as of PR #12469):

Extras with NO macOS exclusion that still work on Intel:

2.2 macOS-Specific Runtime Workarounds

2.3 CI Matrix Coverage

3. Impact Assessment

3.1 What Works on macOS x86_64 Today

Langflow core functionality (flow builder, API, database, all non-ML components) works on macOS Intel with Python 3.10–3.13. The following features are unavailable:

• ALTK (Agent Lifecycle Toolkit) components
• HuggingFace/sentence-transformers embeddings
• EasyOCR
• Docling document processing (binary; docling-core metadata still works)
• MLX inference
• Metal GPU acceleration
• CUGA

This is acceptable because Intel Macs lack the GPU capabilities (Metal 3, Neural Engine) that make these ML features performant.

3.2 What Will Break Next

3.3 CI Cost Exposure

macos-latest-large (Intel x86_64) is the most expensive runner in the matrix:

• GitHub Actions pricing: macOS large runners cost ~$0.12/min (10× Linux)
• Current usage: 4 stable jobs + 1 experimental job = 5 Intel Mac CI jobs per workflow run
• Estimated cost: ~$15–25 per full CI run for Intel Mac jobs alone

4. Recommendations

4.1 Immediate (No Action Needed)

PR #12469 has already addressed the most critical issue:

• ✅ altk and langchain-huggingface excluded on macOS x86_64
• ✅ docling and easyocr already excluded (pre-existing)
• ✅ mlx, cuga are ARM64-only
• ✅ Experimental CI uses continue-on-error: true

4.2 Short-Term (Langflow 1.10 / Q2 2026)

R1: Add platform_machine marker to metal extra — NOT NEEDED

metal_sdk is the SDK for getmetal.io (a cloud vector search/embedding service), not Apple's Metal GPU framework. It's a pure Python package (py3-none-any.whl) with no platform-specific dependencies. No marker change needed.

R2: Reduce macOS Intel CI to Python 3.12 only

Remove the Python 3.10 stable test on macOS AMD64. Python 3.12 is the most commonly deployed version and provides sufficient coverage:

# Remove from stable matrix:
# - os: macos
#   arch: amd64
#   runner: macos-latest-large
#   python-version: "3.10"

Saves: ~$5–7 per CI run, reduces alert noise.

R3: Document macOS support matrix in user-facing docs

Add a support matrix page to docs/ clarifying which features require Apple Silicon vs. work on Intel, so users have clear expectations.

4.3 Medium-Term (Langflow 2.0 / Q4 2026)

R4: Drop macOS x86_64 from CI entirely

Once GitHub deprecates macos-latest-large or macOS 26 ships:

1. Remove all macos-latest-large entries from cross-platform-test.yml
2. Remove the brew install protobuf step (only needed for Intel runners)
3. Keep macos-latest (ARM64) as the sole macOS test target

Saves: ~$15–25 per CI run. Reduces matrix complexity.

R5: Audit and clean up OBJC fork safety workaround

The OBJC_DISABLE_INITIALIZE_FORK_SAFETY workaround in __main__.py and langflow_launcher.py applies to all macOS, not just Intel. However, once Intel is dropped:

• Verify if the issue persists on Apple Silicon with current gunicorn/uvicorn
• If ARM64-only deployments don't trigger the issue, consider removing the workaround
• If still needed, keep it but document why

R6: Officially deprecate macOS x86_64 in release notes

Add a deprecation notice in the Langflow 2.0 release notes:

macOS Intel (x86_64) support is deprecated. Langflow 2.0 is the last version tested on Intel Macs. Future releases will only be tested on Apple Silicon (ARM64). Core functionality may continue to work, but ML features require Apple Silicon.

4.4 Long-Term (Langflow 2.x+ / 2027)

R7: Remove all macOS x86_64 platform markers

Once Intel Mac support is officially dropped, simplify pyproject.toml by removing the platform_machine != 'x86_64' guards — they become unnecessary clutter:

# Before (with Intel exclusion)
altk = ["agent-lifecycle-toolkit>=0.10.1,<1.0; sys_platform != 'darwin' or platform_machine != 'x86_64'"]

# After (Intel dropped from support matrix)
altk = ["agent-lifecycle-toolkit>=0.10.1,<1.0"]

R8: Evaluate ARM64-only macOS features

With Intel out of the picture, lean into Apple Silicon capabilities:

• MLX-based local inference as a first-class feature
• Metal GPU acceleration for embedding generation
• Neural Engine integration for on-device ML
• CoreML model support via ONNX Runtime CoreML EP

5. Risk Matrix

6. Recommended macOS Support Matrix

Current (Langflow 1.9.x)

Proposed (Langflow 2.0+)

7. Summary of Action Items

Appendix A: Complete Platform Marker Inventory

All sys_platform and platform_machine markers in src/backend/base/pyproject.toml:

Line  53: jq         → sys_platform != 'win32'
Line  96: ocrmac     → sys_platform == 'darwin'                    (root pyproject.toml)
Line 258: metal      → (no marker — correct; getmetal.io cloud SDK, not Apple Metal)
Line 293: altk       → sys_platform != 'darwin' or platform_machine != 'x86_64'
Line 297: langchain-huggingface → sys_platform != 'darwin' or platform_machine != 'x86_64'
Line 310: docling    → sys_platform != 'darwin' or platform_machine != 'x86_64'
Line 312: easyocr    → sys_platform != 'darwin' or platform_machine != 'x86_64'
Line 327: cuga       → sys_platform != 'darwin' (non-Mac) + sys_platform == 'darwin' and platform_machine == 'arm64' (Mac ARM)
Line 331: mlx        → sys_platform == 'darwin' and platform_machine == 'arm64' and python_version >= '3.12'
Line 345: gassist    → sys_platform == 'win32'

Appendix B: Related Issues & PRs