Files
langflow/get-started-installation.html
github-merge-queue[bot] 5aeb71255d deploy: cc2468cfd3
2025-07-10 16:18:19 +00:00

172 lines
38 KiB
HTML
Raw 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-current docs-doc-page docs-doc-id-Get-Started/get-started-installation" data-has-hydrated="false">
<head>
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.8.1">
<title data-rh="true">Install Langflow | 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/get-started-installation"><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="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Install Langflow | Langflow Documentation"><meta data-rh="true" name="description" content="Langflow can be installed in multiple ways:"><meta data-rh="true" property="og:description" content="Langflow can be installed in multiple ways:"><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.langflow.org/get-started-installation"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/get-started-installation" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/get-started-installation" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://UZK6BDPCVY-dsn.algolia.net" crossorigin="anonymous"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Install Langflow","item":"https://docs.langflow.org/get-started-installation"}]}</script><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">
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Sora:wght@550;600&amp;display=swap">
<script>!function(){window.semaphore=window.semaphore||[],window.ketch=function(){window.semaphore.push(arguments)};var e=document.createElement("script");e.type="text/javascript",e.src="https://global.ketchcdn.com/web/v3/config/datastax/langflow_org_web/boot.js",e.defer=e.async=!0,document.getElementsByTagName("head")[0].appendChild(e)}()</script>
<script defer="true">!function(){const e=e=>{if(window.gtag&&e.purposes&&"analytics"in e.purposes&&"targeted_advertising"in e.purposes){const n=!0===e.purposes.analytics?"granted":"denied",t=!0===e.purposes.targeted_advertising?"granted":"denied",a={analytics_storage:n,ad_personalization:t,ad_storage:t,ad_user_data:t};window.gtag("consent","update",a)}};window.ketch&&window.ketch("on","consent",e)}()</script><link rel="stylesheet" href="/assets/css/styles.530387df.css">
<script src="/assets/js/runtime~main.609189eb.js" defer="defer"></script>
<script src="/assets/js/main.f42dfc15.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
<svg xmlns="http://www.w3.org/2000/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 navbarHideable_m1mJ"><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><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"></a><a href="https://twitter.com/langflow_ai" target="_blank" class="navbar__item navbar__link header-twitter-link"></a><a href="https://discord.gg/EqksyE2EX9" target="_blank" class="navbar__item navbar__link header-discord-link"></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" 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" class="toggleIcon_g3eP lightToggleIcon_pyhR"><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" class="toggleIcon_g3eP darkToggleIcon_wfgR"><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" class="toggleIcon_g3eP systemToggleIcon_QzmC"><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 (Command+K)"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" 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"><aside class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class="sidebarViewport_aRkj"><div class="sidebar_njMd sidebarWithHideableNavbar_wUlq"><a tabindex="-1" class="sidebarLogo_isFc" href="/"><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"></a><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/">Welcome to Langflow</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role="button" aria-expanded="true" href="/get-started-installation">Get started</a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/get-started-installation">Install Langflow</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/get-started-quickstart">Quickstart</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/basic-prompting">Templates</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/concepts-overview">Concepts</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/concepts-components">Components</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/agents">Agents</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/mcp-server">Model Context Protocol (MCP)</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/configuration-api-keys">Configuration</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/develop-overview">Develop</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/deployment-overview">Deployment</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/api-reference-api-examples">API reference</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/integrations-apify">Integrations</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/contributing-community">Contribute</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/release-notes">Release notes</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/troubleshoot">Support</a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-ad">
<a href="https://astra.datastax.com/signup?type=langflow" target="_blank" class="menu__link">
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-cloud"><path d="M17.5 19H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9Z"/></svg>
<div class="sidebar-ad-text-container">
<span class="sidebar-ad-text">Use Langflow in the cloud</span>
<span class="sidebar-ad-text sidebar-ad-text-gradient">Sign up for DataStax Langflow</span>
</div>
</a>
</li></ul></nav></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">Get started</span></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Install Langflow</span></li></ul></nav><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"><header><h1>Install Langflow</h1></header><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>
<!-- -->
<p>Langflow can be installed in multiple ways:</p>
<ul>
<li>
<p><strong>Langflow Desktop (Recommended)</strong>: Download and install the <a href="#install-and-run-langflow-desktop">standalone desktop application</a> for the easiest setup experience.</p>
</li>
<li>
<p><strong>Docker</strong>: Pull and run the <a href="#install-and-run-langflow-docker">Docker image</a> to start a Langflow container.</p>
</li>
<li>
<p><strong>Python package</strong>: Install the <a href="#install-and-run-the-langflow-oss-python-package">Langflow OSS Python package</a>.</p>
</li>
</ul>
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="install-and-run-langflow-desktop">Install and run Langflow Desktop<a href="#install-and-run-langflow-desktop" class="hash-link" aria-label="Direct link to Install and run Langflow Desktop" title="Direct link to Install and run Langflow Desktop"></a></h2>
<p><strong>Langflow Desktop</strong> is a desktop version of Langflow that includes all the features of open source Langflow, with an additional <a href="#manage-your-version-of-langflow-desktop">version management</a> feature for managing your Langflow version.</p>
<div class="tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">macOS</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><ol>
<li>Navigate to <a href="https://www.langflow.org/desktop" target="_blank" rel="noopener noreferrer">Langflow Desktop</a>.</li>
<li>Click <strong>Download Langflow</strong>, enter your contact information, and then click <strong>Download</strong>.</li>
<li>Mount and install the Langflow application.</li>
<li>When the installation completes, open the Langflow application.</li>
</ol><p>After confirming that Langflow is running, create your first flow with the <a href="/get-started-quickstart">Quickstart</a>.</p></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
<li>
<p>Navigate to <a href="https://www.langflow.org/desktop" target="_blank" rel="noopener noreferrer">Langflow Desktop</a>.</p>
</li>
<li>
<p>Click <strong>Download Langflow</strong>, enter your contact information, and then click <strong>Download</strong>.</p>
</li>
<li>
<p>Open the <strong>File Explorer</strong>, and then navigate to <strong>Downloads</strong>.</p>
</li>
<li>
<p>Double-click the downloaded <code>.msi</code> file, and then use the install wizard to install Langflow Desktop.</p>
<div class="theme-admonition theme-admonition-important admonition_xJq3 alert alert--info"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>important</div><div class="admonitionContent_BuS1"><p>Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. If you receive a <code>C++ Build Tools Required!</code> error, follow the on-screen prompt to install Microsoft C++ Build Tools, or <a href="https://visualstudio.microsoft.com/downloads/" target="_blank" rel="noopener noreferrer">install Microsoft Visual Studio</a>.</p></div></div>
</li>
<li>
<p>When the installation completes, open the Langflow application.</p>
</li>
</ol><p>After confirming that Langflow is running, create your first flow with the <a href="/get-started-quickstart">Quickstart</a>.</p></div></div></div>
<p>After confirming that Langflow is running, create your first flow with the <a href="/get-started-quickstart">Quickstart</a>.</p>
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="manage-your-version-of-langflow-desktop">Manage your version of Langflow Desktop<a href="#manage-your-version-of-langflow-desktop" class="hash-link" aria-label="Direct link to Manage your version of Langflow Desktop" title="Direct link to Manage your version of Langflow Desktop"></a></h3>
<p>When a new version of Langflow is available, Langflow Desktop displays an upgrade message.</p>
<p>To manage your version of Langflow Desktop, follow these steps:</p>
<ol>
<li>In Langflow Desktop, click your profile image, and then select <strong>Version Management</strong>.
The <strong>Version Management</strong> pane lists your active Langflow version first, followed by other available versions.
The <strong>latest</strong> version is always highlighted.</li>
<li>To change your Langflow version, select another version.
A confirmation pane containing the selected version&#x27;s changelog appears.</li>
<li>To apply the change, click <strong>Confirm</strong>.
Langflow desktop restarts to install and activate the new version.</li>
</ol>
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="manage-dependencies-in-langflow-desktop">Manage dependencies in Langflow Desktop<a href="#manage-dependencies-in-langflow-desktop" class="hash-link" aria-label="Direct link to Manage dependencies in Langflow Desktop" title="Direct link to Manage dependencies in Langflow Desktop"></a></h3>
<p>To manage dependencies in Langflow Desktop, see <a href="/install-custom-dependencies#langflow-desktop">Install custom dependencies in Langflow Desktop</a>.</p>
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="install-and-run-langflow-docker">Install and run Langflow with Docker<a href="#install-and-run-langflow-docker" class="hash-link" aria-label="Direct link to Install and run Langflow with Docker" title="Direct link to Install and run Langflow with Docker"></a></h2>
<p>You can use the <a href="https://hub.docker.com/r/langflowai/langflow" target="_blank" rel="noopener noreferrer">Langflow Docker image</a> to run Langflow in an isolated environment.
Running applications in <a href="https://docs.docker.com/" target="_blank" rel="noopener noreferrer">Docker</a> containers ensures consistent behavior across different systems and eliminates dependency conflicts.</p>
<ol>
<li>Install and start <a href="https://docs.docker.com/" target="_blank" rel="noopener noreferrer">Docker</a>.</li>
<li>Pull the latest <a href="https://hub.docker.com/r/langflowai/langflow" target="_blank" rel="noopener noreferrer">Langflow Docker image</a> and start it:</li>
</ol>
<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 -p 7860:7860 langflowai/langflow:latest</span></div></div><br></code></div></div>
<ol start="3">
<li>To access Langflow, navigate to <code>http://localhost:7860/</code>.</li>
</ol>
<p>For more information, see <a href="/deployment-docker">Deploy Langflow on Docker</a>.</p>
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="install-and-run-the-langflow-oss-python-package">Install and run the Langflow OSS Python package<a href="#install-and-run-the-langflow-oss-python-package" class="hash-link" aria-label="Direct link to Install and run the Langflow OSS Python package" title="Direct link to Install and run the Langflow OSS Python package"></a></h2>
<p>To install and run Langflow OSS, you need the following:</p>
<ul>
<li><a href="https://www.python.org/downloads/release/python-3100/" target="_blank" rel="noopener noreferrer">Python 3.10 to 3.13</a> for macOS/Linux, and Python 3.10 to 3.12 for Windows</li>
<li><a href="https://docs.astral.sh/uv/getting-started/installation/" target="_blank" rel="noopener noreferrer">uv</a></li>
<li>At minimum, a dual-core CPU and 2GB RAM, but a multi-core CPU and at least 4GB RAM are recommended</li>
</ul>
<ol>
<li>Create a virtual environment with <a href="https://docs.astral.sh/uv/pip/environments" target="_blank" rel="noopener noreferrer">uv</a>.</li>
</ol>
<details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary>Need help with virtual environments?</summary><div><div class="collapsibleContent_i85q"><p>Virtual environments ensure Langflow is installed in an isolated, fresh environment.
To create a new virtual environment, do the following.</p><div class="tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">macOS/Linux</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><ol>
<li>Navigate to where you want your virtual environment to be created, and create it with <code>uv</code>.
Replace <code>VENV_NAME</code> with your preferred name for your virtual environment.</li>
</ol><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>uv venv VENV_NAME</span></div></div><br></code></div></div><ol start="2">
<li>Start the virtual environment.</li>
</ol><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>source VENV_NAME/bin/activate</span></div></div><br></code></div></div><p>Your shell&#x27;s prompt changes to display that you&#x27;re currently working in a virtual environment.</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>(VENV_NAME) ➜ langflow git:(main) ✗</span></div></div><br></code></div></div><ol start="3">
<li>To deactivate the virtual environment and return to your regular shell, type <code>deactivate</code>.
When activated, the virtual environment temporarily modifies your PATH variable to prioritize packages installed within the virtual environment, so always deactivate it when you&#x27;re done to avoid conflicts with other projects.
To delete the virtual environment, type <code>rm -rf VENV_NAME</code>.</li>
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
<li>Navigate to where you want your virtual environment to be created, and create it with <code>uv</code>.
Replace <code>VENV_NAME</code> with your preferred name for your virtual environment.</li>
</ol><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>uv venv VENV_NAME</span></div></div><br></code></div></div><ol start="2">
<li>Start the virtual environment.</li>
</ol><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>VENV_NAME\Scripts\activate</span></div></div><br></code></div></div><p>Your shell&#x27;s prompt changes to display that you&#x27;re currently working in a virtual environment.</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>(VENV_NAME) PS C:/users/username/langflow-dir&gt;</span></div></div><br></code></div></div><ol start="3">
<li>To deactivate the virtual environment and return to your regular shell, type <code>deactivate</code>.
When activated, the virtual environment temporarily modifies your PATH variable to prioritize packages installed within the virtual environment, so always deactivate it when you&#x27;re done to avoid conflicts with other projects.
To delete the virtual environment, type <code>Remove-Item VENV_NAME</code>.</li>
</ol></div></div></div></div></div></details>
<ol start="2">
<li>
<p>To install Langflow, run the following command.</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>uv pip install langflow</span></div></div><br></code></div></div>
</li>
<li>
<p>After installation, start Langflow:</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>uv run langflow run</span></div></div><br></code></div></div>
</li>
<li>
<p>To confirm that a local Langflow instance is running, navigate to the default Langflow URL <code>http://127.0.0.1:7860</code>.
It can take a few minutes for Langflow to start.</p>
</li>
</ol>
<p>After confirming that Langflow is running, create your first flow with the <a href="/get-started-quickstart">Quickstart</a>.</p>
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="install-langflow-from-source">Install Langflow from source<a href="#install-langflow-from-source" class="hash-link" aria-label="Direct link to Install Langflow from source" title="Direct link to Install Langflow from source"></a></h3>
<p>To install Langflow from source, see <a href="/contributing-how-to-contribute#install-langflow-from-source">Install Langflow from source</a>.</p>
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="manage-langflow-oss-versions">Manage Langflow OSS versions<a href="#manage-langflow-oss-versions" class="hash-link" aria-label="Direct link to Manage Langflow OSS versions" title="Direct link to Manage Langflow OSS versions"></a></h3>
<div class="theme-admonition theme-admonition-important admonition_xJq3 alert alert--info"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>important</div><div class="admonitionContent_BuS1"><p>The Langflow team recommends installing new Langflow versions in a new virtual environment before upgrading your primary installation.</p><p>This allows you to <a href="/concepts-flows#import-flow">import flows</a> from your existing installation and test them in the new version without disrupting your existing installation.
In the event of breaking changes or bugs, your existing installation is preserved in a stable state.</p></div></div>
<p>To manage your Langflow OSS version, use the following commands:</p>
<ul>
<li>Upgrade Langflow to the latest version: <code>uv pip install langflow -U</code></li>
<li>Install a specific version of the Langflow package by adding the required version to the command, such as: <code>uv pip install langflow==1.3.2</code></li>
<li>Reinstall Langflow and all of its dependencies: <code>uv pip install langflow --force-reinstall</code></li>
</ul>
<h3 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="manage-langflow-oss-dependencies">Manage Langflow OSS dependencies<a href="#manage-langflow-oss-dependencies" class="hash-link" aria-label="Direct link to Manage Langflow OSS dependencies" title="Direct link to Manage Langflow OSS dependencies"></a></h3>
<p>Langflow OSS provides optional dependency groups and support for custom dependencies to extend Langflow functionality.
For more information, see <a href="/install-custom-dependencies">Install custom dependencies</a>.</p>
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="troubleshoot-langflow-installation-and-startup-issues">Troubleshoot Langflow installation and startup issues<a href="#troubleshoot-langflow-installation-and-startup-issues" class="hash-link" aria-label="Direct link to Troubleshoot Langflow installation and startup issues" title="Direct link to Troubleshoot Langflow installation and startup issues"></a></h2>
<p>If you encounter an issue when installing or running Langflow, see <a href="/troubleshoot">Troubleshoot Langflow</a>.</p>
<h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="next-steps">Next steps<a href="#next-steps" class="hash-link" aria-label="Direct link to Next steps" title="Direct link to Next steps"></a></h2>
<p>After installing Langflow, build and run a flow with the <a href="/get-started-quickstart">quickstart</a>.</p></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Welcome to Langflow</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/get-started-quickstart"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Quickstart</div></a></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="#install-and-run-langflow-desktop" class="table-of-contents__link toc-highlight">Install and run Langflow Desktop</a><ul><li><a href="#manage-your-version-of-langflow-desktop" class="table-of-contents__link toc-highlight">Manage your version of Langflow Desktop</a></li><li><a href="#manage-dependencies-in-langflow-desktop" class="table-of-contents__link toc-highlight">Manage dependencies in Langflow Desktop</a></li></ul></li><li><a href="#install-and-run-langflow-docker" class="table-of-contents__link toc-highlight">Install and run Langflow with Docker</a></li><li><a href="#install-and-run-the-langflow-oss-python-package" class="table-of-contents__link toc-highlight">Install and run the Langflow OSS Python package</a><ul><li><a href="#install-langflow-from-source" class="table-of-contents__link toc-highlight">Install Langflow from source</a></li><li><a href="#manage-langflow-oss-versions" class="table-of-contents__link toc-highlight">Manage Langflow OSS versions</a></li><li><a href="#manage-langflow-oss-dependencies" class="table-of-contents__link toc-highlight">Manage Langflow OSS dependencies</a></li></ul></li><li><a href="#troubleshoot-langflow-installation-and-startup-issues" class="table-of-contents__link toc-highlight">Troubleshoot Langflow installation and startup issues</a></li><li><a href="#next-steps" class="table-of-contents__link toc-highlight">Next steps</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>© 2025 Langflow</span>
<span id="preferenceCenterContainer"> ·&nbsp; <a href="https://langflow.org/preferences">Manage Privacy Choices</a></span>
</div></li></ul></div></div><div class="footer__bottom text--center"><div class="margin-bottom--sm"><img src="/img/lf-docs-light.svg" alt="Langflow" class="footer__logo themedComponent_mlkZ themedComponent--light_NVdE" width="160" height="40"><img src="/img/lf-docs-dark.svg" alt="Langflow" class="footer__logo themedComponent_mlkZ themedComponent--dark_xIcU" width="160" height="40"></div></div></div></footer><div style="position:fixed;right:20px;bottom:20px;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>