Langflow release notes
This page summarizes significant changes to Langflow in each release. For all changes, see the Changelog.
Due to strict SemVer requirements, Langflow Desktop can have different patch versions than the core Langflow OSS Python package, but the major and minor versions are aligned.
Prepare to upgrade
Whenever possible, the Langflow team recommends installing new Langflow versions in a new virtual environment or VM before upgrading your primary installation. This allows you to import flows 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.
To avoid the impact of potential breaking changes and test new versions, the Langflow team recommends the following upgrade process:
-
Recommended: Export your projects to create backups of your flows:
curl -X GET \
"$LANGFLOW_SERVER_URL/api/v1/projects/download/$PROJECT_ID" \
-H "accept: application/json" \
-H "x-api-key: $LANGFLOW_API_KEY"To export flows from the visual editor, see Import and export flows.
-
Install the new version:
- Langflow OSS Python package: Install the new version in a new virtual environment. For instructions, see Install and run the Langflow OSS Python package.
- Langflow Docker image: Run the new image in a separate container, or upgrade your existing image. For more information, see Upgrade the Langflow Docker image.
- Langflow Desktop: To upgrade in place, open Langflow Desktop, and then click Upgrade Available in the Langflow header. If you want to isolate the new version, you must install Langflow Desktop on a separate physical or virtual machine, and then import your flows to the new installation.
-
Import your flows to test them in the new version, upgrading components as needed.
When upgrading components, you can use the Create backup flow before updating option if you didn't previously export your flows.
-
If you installed the new version in isolation, upgrade your primary installation after testing the new version.
If you made changes to your flows in the isolated installation, you might want to export and import those flows back to your upgraded primary installation so you don't have to repeat the component upgrade process.
1.12.x
Highlights of this release include the following changes. For all changes, see the Changelog.
Breaking changes
-
langflow-baseis now the minimal installLangflow 1.12 makes
langflow-basea complete, version-aligned installation of the Langflow application. Replace anylangflow-base~=0.xpins withlangflow-base~=1.12.0pins. -
Ongoing breaking change: bundle separation
Bundle separation concludes in 1.12.
uv pip install langflowno longer installs all provider bundles, and includes only a curated list of providers.Saved flows continue to operate as expected, and existing component class names remain compatible. If a required provider package is not installed, the component is visible in the visual editor, but the flow won't build or run until you install the package.
Langflow displays an error that names the missing package, so you can install it. To install a package, such as Exa, run
uv pip install lfx-exain your virtual environment.For more information, see Additional bundles.
-
Admin Page removed
Langflow OSS no longer includes an Admin Page. The
/adminroute, the account-menu Admin Page link, and the user-management page are gone. Superusers can no longer manage users or passwords in the visual editor.To manage users, use the Users API.
/login/adminis still the admin sign-in endpoint and page.For more information, see Manage users as an administrator.
New features
-
OpenTelemetry export
Langflow can export health traces, metrics, and logs over OTLP to your own backend.
For more information, see OpenTelemetry, New Relic, and Instana.
-
Python Interpreter microVM sandbox
Set
LANGFLOW_SANDBOX_BACKEND=exec-sandboxto run the Python Interpreter component in a dedicated QEMU microVM instead of in the Langflow server process. The microVM is not included in a defaultuv pip install langflowinstallation. To install it, runuv pip install 'langflow[sandbox]'.For more information, see Isolate executions in a microVM.
-
Production preflight checks
Set
LANGFLOW_DEPLOYMENT_PROFILE=prodto probe your Langflow deployment before any workers start. The default remainsdev, which skips prod checks.For more information, see Production preflight checks.
-
Disable the legacy MCP SSE transport
Set
LANGFLOW_MCP_SSE_ENABLED=falseto return a404from the legacy SSE transport endpoint. Streamable HTTP is not affected.For more information, see Disable the legacy MCP SSE transport.
-
OrcaRouter bundle
The OrcaRouter bundle adds an OrcaRouter language model component.
For more information, see OrcaRouter.
-
IBM Confluent bundle
The IBM Confluent bundle adds Kafka, Tableflow, and Real-Time Context Engine components.
For more information, see IBM Confluent.
-
Deployment tweak policy
Set
LANGFLOW_TWEAKS_POLICYto control which component fields an API caller can override at run time.For more information, see Restrict API tweaks.
-
Catalog and model policy APIs
Superusers can block or allow components, starter templates, model providers, and specific models.
For more information, see Catalog and model policy.
1.11.x
For 1.11.x release notes, see the 1.11.x documentation.
1.10.x
For 1.10.x release notes, see the 1.10.x documentation.
1.9.x
For 1.9.x release notes, see the 1.9.x documentation.
1.8.x
For 1.8.x release notes, see the 1.8.x documentation.
Earlier releases
See the Changelog.
Was this page helpful?