Files
langflow/deployment-macos-support.html
2026-06-25 13:37:38 +00:00

165 lines
33 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-1.10.0 docs-doc-page docs-doc-id-Deployment/deployment-macos-support" data-has-hydrated="false">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">macOS Support | Langflow Documentation</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.langflow.org/deployment-macos-support"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="1.10.0"><meta data-rh="true" name="docusaurus_tag" content="docs-default-1.10.0"><meta data-rh="true" name="docsearch:version" content="1.10.0"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-1.10.0"><meta data-rh="true" property="og:title" content="macOS Support | Langflow Documentation"><meta data-rh="true" name="description" content="Langflow supports both Apple Silicon (ARM64) and Intel (x86_64) Macs, but with different feature availability due to hardware capabilities and upstream dependency support."><meta data-rh="true" property="og:description" content="Langflow supports both Apple Silicon (ARM64) and Intel (x86_64) Macs, but with different feature availability due to hardware capabilities and upstream dependency support."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.langflow.org/deployment-macos-support"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/deployment-macos-support" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/deployment-macos-support" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://UZK6BDPCVY-dsn.algolia.net" crossorigin="anonymous"><link rel="preconnect" href="https://www.google-analytics.com">
<link rel="preconnect" href="https://www.googletagmanager.com">
<script async src="https://www.googletagmanager.com/gtag/js?id=G-SLQFLQ3KPT"></script>
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-SLQFLQ3KPT",{})</script>
<link rel="search" type="application/opensearchdescription+xml" title="Langflow Documentation" href="/opensearch.xml">
<script>window._ibmAnalytics={settings:{name:"DataStax",tealiumProfileName:"ibm-subsidiary"},trustarc:{privacyPolicyLink:"https://ibm.com/privacy"},"digitalData.page.services.google.enabled":!0},window.digitalData={page:{pageInfo:{ibm:{siteId:"IBM_"+_ibmAnalytics.settings.name},segment:{enabled:!0,env:"prod",key:"B04fNhD06DqDPuaRfQl5lZ2iQICdxxuh",coremetrics:!1,carbonComponentEvents:!1}},category:{primaryCategory:"PC230"}},commonProperties:{productTitle:"IBM Elite Support for Langflow",productCode:"5900BUB",productCodeType:"WWPC",UT30:"30AS5",instanceId:"docs-site",subscriptionId:"public-access",productPlanName:"Public",productPlanType:"freemium",userId:"IBMid-ANONYMOUS"}}</script>
<script src="//1.www.s81c.com/common/stats/ibm-common.js" async="true"></script>
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&amp;family=Geist+Mono:wght@400;500&amp;family=Sora:wght@550;600&amp;display=swap">
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("consent","default",{ad_storage:"denied",ad_user_data:"denied",ad_personalization:"denied",analytics_storage:"denied"})</script>
<script>!function(){function e(){if(void 0!==window.truste&&window.truste.cma){var e=window.truste.cma.callApi("getConsent",window.location.href)||{},n=1===e[2],t=1===e[3];gtag("consent","update",{ad_storage:n?"granted":"denied",ad_user_data:n?"granted":"denied",ad_personalization:n?"granted":"denied",analytics_storage:t?"granted":"denied"})}}window.addEventListener&&(window.addEventListener("cm_data_subject_consent_changed",e),window.addEventListener("cm_consent_preferences_set",e)),"complete"===document.readyState?e():window.addEventListener("load",e)}()</script><link rel="stylesheet" href="/assets/css/styles.0d9d771d.css">
<script src="/assets/js/runtime~main.c313665b.js" defer="defer"></script>
<script src="/assets/js/main.12b252df.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
<svg style="display: none;"><defs>
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
</defs></svg>
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/lf-docs-light.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/lf-docs-dark.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div></a><div class="navbar__item dropdown dropdown--hoverable"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/deployment-macos-support">1.10.x</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/next/deployment-macos-support">1.11.x (Next)</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/deployment-macos-support">1.10.x</a></li><li><a class="dropdown__link" href="/1.9.0">1.9.x</a></li><li><a class="dropdown__link" href="/1.8.0">1.8.x</a></li></ul></div></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href="https://github.com/langflow-ai/langflow" target="_blank" class="navbar__item navbar__link header-github-link" aria-label="GitHub" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-github" data-namespace="header" data-platform-title="Langflow"></a><a href="https://twitter.com/langflow_ai" target="_blank" class="navbar__item navbar__link header-twitter-link" aria-label="Twitter" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-twitter" data-namespace="header" data-platform-title="Langflow"></a><a href="https://discord.gg/EqksyE2EX9" target="_blank" class="navbar__item navbar__link header-discord-link" aria-label="Discord" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-discord" data-namespace="header" data-platform-title="Langflow"></a><div class="toggle_MW0i colorModeToggle_DEke"><button class="clean-btn toggleButton_yw5v toggleButtonDisabled_BJd7" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL lightToggleIcon_SFTY"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL darkToggleIcon_ekgs"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL systemToggleIcon_yi_a"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search (Meta+k)" aria-keyshortcuts="Meta+k"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="11" cy="11" r="8" stroke="currentColor" fill="none" stroke-width="1.4"></circle><path d="m21 21-4.3-4.3" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><main class="docMainContainer_TBSr docMainContainerEnhanced_lQrH"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_z5aJ"><div class="docItemContainer_c0TR"><article><div class="docMetaRow_c2hx"><div class="root_Eutc"><button type="button" class="button_gpNY"><span aria-hidden="true" class="icon_Bm9L"><svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></span><span class="label_LzDG">Copy page</span></button></div><span class="theme-doc-version-badge badge badge--secondary">Version: 1.10.x</span></div><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><style>[data-ch-theme="github-dark"] { --ch-t-colorScheme: dark;--ch-t-foreground: #c9d1d9;--ch-t-background: #0d1117;--ch-t-lighter-inlineBackground: #0d1117e6;--ch-t-editor-background: #0d1117;--ch-t-editor-foreground: #c9d1d9;--ch-t-editor-lineHighlightBackground: #6e76811a;--ch-t-editor-rangeHighlightBackground: #ffffff0b;--ch-t-editor-infoForeground: #3794FF;--ch-t-editor-selectionBackground: #264F78;--ch-t-focusBorder: #1f6feb;--ch-t-tab-activeBackground: #0d1117;--ch-t-tab-activeForeground: #c9d1d9;--ch-t-tab-inactiveBackground: #010409;--ch-t-tab-inactiveForeground: #8b949e;--ch-t-tab-border: #30363d;--ch-t-tab-activeBorder: #0d1117;--ch-t-editorGroup-border: #30363d;--ch-t-editorGroupHeader-tabsBackground: #010409;--ch-t-editorLineNumber-foreground: #6e7681;--ch-t-input-background: #0d1117;--ch-t-input-foreground: #c9d1d9;--ch-t-input-border: #30363d;--ch-t-icon-foreground: #8b949e;--ch-t-sideBar-background: #010409;--ch-t-sideBar-foreground: #c9d1d9;--ch-t-sideBar-border: #30363d;--ch-t-list-activeSelectionBackground: #6e768166;--ch-t-list-activeSelectionForeground: #c9d1d9;--ch-t-list-hoverBackground: #6e76811a;--ch-t-list-hoverForeground: #c9d1d9; }</style>
<header><h1>macOS Support Matrix</h1></header>
<p>Langflow supports both Apple Silicon (ARM64) and Intel (x86_64) Macs, but with different feature availability due to hardware capabilities and upstream dependency support.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="quick-reference">Quick Reference<a href="#quick-reference" class="hash-link" aria-label="Direct link to Quick Reference" title="Direct link to Quick Reference" translate="no"></a></h2>
<table><thead><tr><th>Feature Category</th><th>Apple Silicon (M1/M2/M3)</th><th>Intel (x86_64)</th></tr></thead><tbody><tr><td><strong>Core Langflow</strong></td><td>✅ Full support</td><td>✅ Full support</td></tr><tr><td><strong>ML/AI Components</strong></td><td>✅ Full support</td><td>❌ Limited/Unavailable</td></tr><tr><td><strong>GPU Acceleration</strong></td><td>✅ Metal support</td><td>❌ Not available</td></tr><tr><td><strong>Native OCR</strong></td><td>✅ Full support</td><td>✅ Full support</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="detailed-feature-support">Detailed Feature Support<a href="#detailed-feature-support" class="hash-link" aria-label="Direct link to Detailed Feature Support" title="Direct link to Detailed Feature Support" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="core-functionality-both-architectures">Core Functionality (Both Architectures)<a href="#core-functionality-both-architectures" class="hash-link" aria-label="Direct link to Core Functionality (Both Architectures)" title="Direct link to Core Functionality (Both Architectures)" translate="no"></a></h3>
<p>The following features work on <strong>both Apple Silicon and Intel Macs</strong>:</p>
<ul>
<li class="">✅ Flow builder and visual editor</li>
<li class="">✅ API server and endpoints</li>
<li class="">✅ Database operations (SQLite, PostgreSQL)</li>
<li class="">✅ Authentication and user management</li>
<li class="">✅ All non-ML components (text processing, API calls, data transformations)</li>
<li class="">✅ Native OCR via <code>ocrmac</code> (uses macOS Vision framework)</li>
<li class="">✅ Vector stores and embeddings (when using API-based providers)</li>
<li class="">✅ LangChain integrations (non-ML components)</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="mlai-features-apple-silicon-only">ML/AI Features (Apple Silicon Only)<a href="#mlai-features-apple-silicon-only" class="hash-link" aria-label="Direct link to ML/AI Features (Apple Silicon Only)" title="Direct link to ML/AI Features (Apple Silicon Only)" translate="no"></a></h3>
<p>The following features require <strong>Apple Silicon (ARM64)</strong> and are <strong>not available on Intel Macs</strong>:</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="-not-available-on-intel">❌ Not Available on Intel<a href="#-not-available-on-intel" class="hash-link" aria-label="Direct link to ❌ Not Available on Intel" title="Direct link to ❌ Not Available on Intel" translate="no"></a></h4>
<ul>
<li class=""><strong>ALTK (Agent Lifecycle Toolkit)</strong> - Requires PyTorch</li>
<li class=""><strong>HuggingFace Transformers</strong> - Requires PyTorch</li>
<li class=""><strong>Sentence Transformers</strong> - Requires PyTorch</li>
<li class=""><strong>EasyOCR</strong> - Requires PyTorch</li>
<li class=""><strong>Docling (binary processing)</strong> - Requires PyTorch<!-- -->
<ul>
<li class="">Note: <code>docling-core</code> (metadata-only) works on Intel</li>
</ul>
</li>
<li class=""><strong>MLX and MLX-VLM</strong> - Apple Silicon exclusive framework</li>
<li class=""><strong>Metal GPU acceleration</strong> - Requires Apple Silicon hardware</li>
<li class=""><strong>CUGA</strong> - Apple Silicon only</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-the-difference">Why the Difference?<a href="#why-the-difference" class="hash-link" aria-label="Direct link to Why the Difference?" title="Direct link to Why the Difference?" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="pytorch-deprecation">PyTorch Deprecation<a href="#pytorch-deprecation" class="hash-link" aria-label="Direct link to PyTorch Deprecation" title="Direct link to PyTorch Deprecation" translate="no"></a></h3>
<p>PyTorch dropped support for macOS Intel (x86_64) starting with version 2.3.0 (April 2024). The last version with Intel Mac support was PyTorch 2.2.2, which only supports Python 3.10-3.12.</p>
<p>Since many ML components depend on PyTorch, they are automatically excluded on Intel Macs to prevent installation failures.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="hardware-limitations">Hardware Limitations<a href="#hardware-limitations" class="hash-link" aria-label="Direct link to Hardware Limitations" title="Direct link to Hardware Limitations" translate="no"></a></h3>
<p>Intel Macs lack the specialized hardware that makes ML workloads performant:</p>
<ul>
<li class="">No Neural Engine</li>
<li class="">No Metal 3 GPU acceleration</li>
<li class="">Limited memory bandwidth compared to Apple Silicon&#x27;s unified memory architecture</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="installation-recommendations">Installation Recommendations<a href="#installation-recommendations" class="hash-link" aria-label="Direct link to Installation Recommendations" title="Direct link to Installation Recommendations" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="for-apple-silicon-users">For Apple Silicon Users<a href="#for-apple-silicon-users" class="hash-link" aria-label="Direct link to For Apple Silicon Users" title="Direct link to For Apple Silicon Users" translate="no"></a></h3>
<p>Install Langflow normally with all features:</p>
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>pip install langflow</span></div></div><br></code></div></div>
<p>Or with specific ML extras:</p>
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>pip install langflow[altk,langchain-huggingface,easyocr]</span></div></div><br></code></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="for-intel-mac-users">For Intel Mac Users<a href="#for-intel-mac-users" class="hash-link" aria-label="Direct link to For Intel Mac Users" title="Direct link to For Intel Mac Users" translate="no"></a></h3>
<p>Install the base package for core functionality:</p>
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>pip install langflow</span></div></div><br></code></div></div>
<p><strong>Note:</strong> Attempting to install ML-dependent extras on Intel Macs will be automatically skipped due to platform markers in the package configuration.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="python-version-support">Python Version Support<a href="#python-version-support" class="hash-link" aria-label="Direct link to Python Version Support" title="Direct link to Python Version Support" translate="no"></a></h2>
<table><thead><tr><th>Python Version</th><th>Apple Silicon</th><th>Intel Mac</th></tr></thead><tbody><tr><td>3.10</td><td>✅ Supported</td><td>✅ Supported</td></tr><tr><td>3.11</td><td>✅ Supported</td><td>✅ Supported</td></tr><tr><td>3.12</td><td>✅ Supported</td><td>✅ Supported</td></tr><tr><td>3.13</td><td>✅ Supported</td><td>⚠️ Limited (no PyTorch)</td></tr><tr><td>3.14</td><td>✅ Supported</td><td>⚠️ Limited (no PyTorch)</td></tr></tbody></table>
<div class="theme-admonition theme-admonition-note admonition_xJq3 alert alert--secondary"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_BuS1"><p>Python 3.13+ on Intel Macs cannot use PyTorch-dependent features due to the lack of PyTorch wheels for macOS x86_64. This affects ML components like ALTK, HuggingFace, EasyOCR, and Docling.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="workarounds-for-intel-mac-users">Workarounds for Intel Mac Users<a href="#workarounds-for-intel-mac-users" class="hash-link" aria-label="Direct link to Workarounds for Intel Mac Users" title="Direct link to Workarounds for Intel Mac Users" translate="no"></a></h2>
<p>If you need ML features on an Intel Mac, consider these alternatives:</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="1-use-api-based-providers">1. Use API-Based Providers<a href="#1-use-api-based-providers" class="hash-link" aria-label="Direct link to 1. Use API-Based Providers" title="Direct link to 1. Use API-Based Providers" translate="no"></a></h3>
<p>Instead of local models, use API-based services:</p>
<ul>
<li class="">OpenAI API for embeddings and completions</li>
<li class="">Cohere API for embeddings</li>
<li class="">Anthropic API for Claude models</li>
<li class="">HuggingFace Inference API</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="2-remote-inference">2. Remote Inference<a href="#2-remote-inference" class="hash-link" aria-label="Direct link to 2. Remote Inference" title="Direct link to 2. Remote Inference" translate="no"></a></h3>
<p>Run ML workloads on a remote server:</p>
<ul>
<li class="">Deploy Langflow on a cloud instance with GPU support</li>
<li class="">Use the Langflow API to connect from your Intel Mac</li>
<li class="">Keep the UI/development on your Mac, inference in the cloud</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="3-docker-with-rosetta-2">3. Docker with Rosetta 2<a href="#3-docker-with-rosetta-2" class="hash-link" aria-label="Direct link to 3. Docker with Rosetta 2" title="Direct link to 3. Docker with Rosetta 2" translate="no"></a></h3>
<p>For some workloads, you can use Docker with ARM64 images via Rosetta 2:</p>
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>docker run --platform linux/arm64 langflowai/langflow:latest</span></div></div><br></code></div></div>
<p><strong>Note:</strong> Performance will be slower than native, and not all features may work correctly.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="future-support">Future Support<a href="#future-support" class="hash-link" aria-label="Direct link to Future Support" title="Direct link to Future Support" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="intel-mac-deprecation-timeline">Intel Mac Deprecation Timeline<a href="#intel-mac-deprecation-timeline" class="hash-link" aria-label="Direct link to Intel Mac Deprecation Timeline" title="Direct link to Intel Mac Deprecation Timeline" translate="no"></a></h3>
<p>Apple and the broader ecosystem are phasing out Intel Mac support:</p>
<ul>
<li class=""><strong>2022:</strong> Last Intel MacBook Pro shipped</li>
<li class=""><strong>2024:</strong> PyTorch dropped Intel Mac support</li>
<li class=""><strong>2026-2027:</strong> Expected end of macOS updates for Intel Macs</li>
</ul>
<p>Langflow will continue to support core functionality on Intel Macs as long as Python and essential dependencies remain available, but ML features will remain Apple Silicon exclusive.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="recommended-migration-path">Recommended Migration Path<a href="#recommended-migration-path" class="hash-link" aria-label="Direct link to Recommended Migration Path" title="Direct link to Recommended Migration Path" translate="no"></a></h3>
<p>If you rely on ML features, consider upgrading to Apple Silicon hardware:</p>
<ul>
<li class="">M1/M2/M3 MacBook Air (cost-effective)</li>
<li class="">M1/M2/M3 MacBook Pro (for intensive workloads)</li>
<li class="">Mac Mini with M2/M3 (desktop option)</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="troubleshooting">Troubleshooting<a href="#troubleshooting" class="hash-link" aria-label="Direct link to Troubleshooting" title="Direct link to Troubleshooting" translate="no"></a></h2>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="no-matching-distribution-found-errors">&quot;No matching distribution found&quot; Errors<a href="#no-matching-distribution-found-errors" class="hash-link" aria-label="Direct link to &quot;No matching distribution found&quot; Errors" title="Direct link to &quot;No matching distribution found&quot; Errors" translate="no"></a></h3>
<p>If you see errors about missing packages on Intel Mac:</p>
<ol>
<li class=""><strong>Expected behavior</strong> - ML packages are intentionally excluded</li>
<li class=""><strong>Solution</strong> - Use core Langflow features or API-based alternatives</li>
<li class=""><strong>Verify architecture:</strong>
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>python -c &quot;import platform; print(platform.machine())&quot;</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span># x86_64 = Intel, arm64 = Apple Silicon</span></div></div><br></code></div></div>
</li>
</ol>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="performance-issues">Performance Issues<a href="#performance-issues" class="hash-link" aria-label="Direct link to Performance Issues" title="Direct link to Performance Issues" translate="no"></a></h3>
<p>If Langflow feels slow on Intel Mac:</p>
<ol>
<li class="">Ensure you&#x27;re not trying to run ML workloads locally</li>
<li class="">Use API-based providers for embeddings/completions</li>
<li class="">Consider upgrading to Apple Silicon for better performance</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="related-documentation">Related Documentation<a href="#related-documentation" class="hash-link" aria-label="Direct link to Related Documentation" title="Direct link to Related Documentation" translate="no"></a></h2>
<ul>
<li class=""><a class="" href="/deployment-overview">Deployment Overview</a></li>
<li class=""><a class="" href="/deployment-docker">Docker Deployment</a></li>
<li class=""><a class="" href="/deployment-prod-best-practices">Production Best Practices</a></li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="need-help">Need Help?<a href="#need-help" class="hash-link" aria-label="Direct link to Need Help?" title="Direct link to Need Help?" translate="no"></a></h2>
<p>If you have questions about macOS support:</p>
<ul>
<li class=""><a href="https://github.com/langflow-ai/langflow/discussions" target="_blank" rel="noopener noreferrer" class="">GitHub Discussions</a></li>
<li class=""><a href="https://discord.gg/EqksyE2EX9" target="_blank" rel="noopener noreferrer" class="">Discord Community</a></li>
<li class=""><a href="https://docs.langflow.org" target="_blank" rel="noopener noreferrer" class="">Documentation</a></li>
</ul></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#quick-reference" class="table-of-contents__link toc-highlight">Quick Reference</a></li><li><a href="#detailed-feature-support" class="table-of-contents__link toc-highlight">Detailed Feature Support</a><ul><li><a href="#core-functionality-both-architectures" class="table-of-contents__link toc-highlight">Core Functionality (Both Architectures)</a></li><li><a href="#mlai-features-apple-silicon-only" class="table-of-contents__link toc-highlight">ML/AI Features (Apple Silicon Only)</a></li></ul></li><li><a href="#why-the-difference" class="table-of-contents__link toc-highlight">Why the Difference?</a><ul><li><a href="#pytorch-deprecation" class="table-of-contents__link toc-highlight">PyTorch Deprecation</a></li><li><a href="#hardware-limitations" class="table-of-contents__link toc-highlight">Hardware Limitations</a></li></ul></li><li><a href="#installation-recommendations" class="table-of-contents__link toc-highlight">Installation Recommendations</a><ul><li><a href="#for-apple-silicon-users" class="table-of-contents__link toc-highlight">For Apple Silicon Users</a></li><li><a href="#for-intel-mac-users" class="table-of-contents__link toc-highlight">For Intel Mac Users</a></li></ul></li><li><a href="#python-version-support" class="table-of-contents__link toc-highlight">Python Version Support</a></li><li><a href="#workarounds-for-intel-mac-users" class="table-of-contents__link toc-highlight">Workarounds for Intel Mac Users</a><ul><li><a href="#1-use-api-based-providers" class="table-of-contents__link toc-highlight">1. Use API-Based Providers</a></li><li><a href="#2-remote-inference" class="table-of-contents__link toc-highlight">2. Remote Inference</a></li><li><a href="#3-docker-with-rosetta-2" class="table-of-contents__link toc-highlight">3. Docker with Rosetta 2</a></li></ul></li><li><a href="#future-support" class="table-of-contents__link toc-highlight">Future Support</a><ul><li><a href="#intel-mac-deprecation-timeline" class="table-of-contents__link toc-highlight">Intel Mac Deprecation Timeline</a></li><li><a href="#recommended-migration-path" class="table-of-contents__link toc-highlight">Recommended Migration Path</a></li></ul></li><li><a href="#troubleshooting" class="table-of-contents__link toc-highlight">Troubleshooting</a><ul><li><a href="#no-matching-distribution-found-errors" class="table-of-contents__link toc-highlight">&quot;No matching distribution found&quot; Errors</a></li><li><a href="#performance-issues" class="table-of-contents__link toc-highlight">Performance Issues</a></li></ul></li><li><a href="#related-documentation" class="table-of-contents__link toc-highlight">Related Documentation</a></li><li><a href="#need-help" class="table-of-contents__link toc-highlight">Need Help?</a></li></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title"></div><ul class="footer__items clean-list"><li class="footer__item"><div class="footer-links">
<span>© 2026 Langflow</span>
<span id="preferenceCenterContainer"> ·&nbsp; <a href="#" onclick='return"undefined"!=typeof window&&window.truste&&window.truste.eu&&window.truste.eu.clickListener&&window.truste.eu.clickListener(),!1' style="cursor: pointer;">Manage Privacy Choices</a></span>
</div></li></ul></div></div></div></footer><div style="position:fixed;right:21px;bottom:21px;z-index:100;display:flex;align-items:center;gap:10px;cursor:pointer"><div style="background-color:#f6f6f6;border-radius:50%;width:48px;height:48px;display:flex;align-items:center;justify-content:center;box-shadow:0 2px 4px rgba(0,0,0,0.1)"><img src="/img/langflow-icon-black-transparent.svg" style="width:40px" alt="Search"></div></div></div>
</body>
</html>