ec679c980c
* Improve README Quickstart section and reorganize installation options - Add prominent Desktop download section before Quickstart - Remove $ symbols from shell commands to fix copy button functionality - Add clear 'Run from source' option with make run_cli for developers - Improve Docker installation instructions with usage details - Move security warnings to after installation options for better flow - Remove redundant star/issues badges These changes address common user confusion when trying to run Langflow, especially for developers who clone the repo first and then struggle with the package installation instructions. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * Add dark mode logo support - Added picture element for automatic dark/light mode logo switching - Dark mode shows blue background logo, light mode shows black logo 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * Final README improvements - Made 'Other install options' a proper section with emoji - Updated deployment section with rocket emoji - Fixed single-line formatting for subsections - Added new star animation gif - Changed 'tool' to 'platform' in description * Improve Desktop download section messaging - Made text more concise and action-oriented - Changed download emoji from arrow to inbox - Removed redundant 'built-in' and bold formatting - Cleaner parenthetical for OS availability * Revise README for Langflow Desktop and deployment info Updated sections for clarity and added details about Langflow Desktop and deployment options. * Revert star gif to GitHub attachment URL Testing if local file path issue or markdown previewer issue * Apply suggestion from @mendonk * Apply suggestion from @mendonk * Apply suggestion from @mendonk * Apply suggestion from @mendonk * readme-changes * Apply suggestion from @mendonk --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Co-authored-by: Gabriel Luiz Freitas Almeida <gabriel@langflow.org>
5.4 KiB
Langflow is a powerful platform for building and deploying AI-powered agents and workflows. It provides developers with both a visual authoring experience and built-in API and MCP servers that turn every workflow into a tool that can be integrated into applications built on any framework or stack. Langflow comes with batteries included and supports all major LLMs, vector databases and a growing library of AI tools.
✨ Highlight features
- Visual builder interface to quickly get started and iterate.
- Source code access lets you customize any component using Python.
- Interactive playground to immediately test and refine your flows with step-by-step control.
- Multi-agent orchestration with conversation management and retrieval.
- Deploy as an API or export as JSON for Python apps.
- Deploy as an MCP server and turn your flows into tools for MCP clients.
- Observability with LangSmith, LangFuse and other integrations.
- Enterprise-ready security and scalability.
🖥️ Langflow Desktop
Langflow Desktop is the easiest way to get started. It includes dependency management and automatic updates. Available for Windows and macOS.
⚡️ Quickstart
Install locally (recommended)
Requires Python 3.10–3.13 and uv (recommended package manager).
Install
From a fresh directory, run:
uv pip install langflow -U
The latest Langflow package is installed. For more information, see Install and run the Langflow OSS Python package.
Run
To start Langflow, run:
uv run langflow run
Langflow starts at http://127.0.0.1:7860.
That's it! You're ready to build with Langflow! 🎉
📦 Other install options
Run from source
If you've cloned this repository and want to contribute, run this command from the repository root:
make run_cli
For more information, see DEVELOPMENT.md.
Docker
Start a Langflow container with default settings:
docker run -p 7860:7860 langflowai/langflow:latest
Langflow is available at http://localhost:7860/. For configuration options, see the Docker deployment guide.
Caution
- Langflow versions 1.6.0 through 1.6.3 have a critical bug where
.envfiles are not read, potentially causing security vulnerabilities. DO NOT upgrade to these versions if you use.envfiles for configuration. Instead, upgrade to 1.6.4, which includes a fix for this bug.- Windows users of Langflow Desktop should not use the in-app update feature to upgrade to Langflow version 1.6.0. For upgrade instructions, see Windows Desktop update issue.
- Users must update to Langflow >= 1.3 to protect against CVE-2025-3248
- Users must update to Langflow >= 1.5.1 to protect against CVE-2025-57760
For security information, see our Security Policy and Security Advisories.
🚀 Deployment
Langflow is completely open source and you can deploy it to all major deployment clouds. To learn how to deploy Langflow, see our Langflow deployment guides.
⭐ Stay up-to-date
Star Langflow on GitHub to be instantly notified of new releases.
👋 Contribute
We welcome contributions from developers of all levels. If you'd like to contribute, please check our contributing guidelines and help make Langflow more accessible.