forked from langflow-ai/langflow
-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
60e1896
commit 5927bc6
Showing
5 changed files
with
99 additions
and
307 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,219 +1,13 @@ | ||
<div align="center" style="padding: 10px; border: 1px solid #ccc; background-color: #f9f9f9; border-radius: 10px; margin-bottom: 20px;"> | ||
<h2 style="margin: 0; font-size: 24px; color: #333;">Langflow 1.0 is OUT! 🎉</h2> | ||
<p style="margin: 5px 0 0 0; font-size: 16px; color: #666;">Read all about it <a href="https://medium.com/p/73d3bdce8440" style="text-decoration: underline; color: #1a73e8;">here</a>!</p> | ||
</div> | ||
|
||
<!-- markdownlint-disable MD030 --> | ||
|
||
# [![Langflow](./docs/static/img/hero.png)](https://www.langflow.org) | ||
# RAGStack Langflow | ||
|
||
<p align="center"><strong> | ||
A visual framework for building multi-agent and RAG applications | ||
</strong></p> | ||
<p align="center" style="font-size: 12px;"> | ||
Open-source, Python-powered, fully customizable, LLM and vector store agnostic | ||
</p> | ||
## Documentation | ||
|
||
<p align="center" style="font-size: 12px;"> | ||
<a href="https://docs.langflow.org" style="text-decoration: underline;">Docs</a> - | ||
<a href="https://discord.com/invite/EqksyE2EX9" style="text-decoration: underline;">Join our Discord</a> - | ||
<a href="https://twitter.com/langflow_ai" style="text-decoration: underline;">Follow us on X</a> - | ||
<a href="https://huggingface.co/spaces/Langflow/Langflow" style="text-decoration: underline;">Live demo</a> | ||
</p> | ||
[DataStax RAGStack Documentation](https://docs.datastax.com/en/ragstack/docs/index.html) | ||
|
||
<p align="center"> | ||
<a href="https://github.com/langflow-ai/langflow"> | ||
<img src="https://img.shields.io/github/stars/langflow-ai/langflow"> | ||
</a> | ||
<a href="https://discord.com/invite/EqksyE2EX9"> | ||
<img src="https://img.shields.io/discord/1116803230643527710?label=Discord"> | ||
</a> | ||
</p> | ||
## 📄 License | ||
|
||
<div align="center"> | ||
<a href="./README.md"><img alt="README in English" src="https://img.shields.io/badge/English-d9d9d9"></a> | ||
<a href="./README.PT.md"><img alt="README in Portuguese" src="https://img.shields.io/badge/Portuguese-d9d9d9"></a> | ||
<a href="./README.zh_CN.md"><img alt="README in Simplified Chinese" src="https://img.shields.io/badge/简体中文-d9d9d9"></a> | ||
<a href="./README.ja.md"><img alt="README in Japanese" src="https://img.shields.io/badge/日本語-d9d9d9"></a> | ||
<a href="./README.KR.md"><img alt="README in KOREAN" src="https://img.shields.io/badge/한국어-d9d9d9"></a> | ||
</div> | ||
RAGStack Langflow is released under the BUSL License. See the [LICENSE](LICENSE.md) file for details. | ||
|
||
<p align="center"> | ||
<img src="./docs/static/img/langflow_basic_howto.gif" alt="Your GIF" style="border: 3px solid #211C43;"> | ||
</p> | ||
|
||
# 📝 Content | ||
|
||
- [📝 Content](#-content) | ||
- [📦 Get Started](#-get-started) | ||
- [Running Langflow from a Cloned Repository](#-running-langflow-from-a-cloned-repository) | ||
- [🎨 Create Flows](#-create-flows) | ||
- [Deploy](#deploy) | ||
- [DataStax Langflow](#datastax-langflow) | ||
- [Deploy Langflow on Hugging Face Spaces](#deploy-langflow-on-hugging-face-spaces) | ||
- [Deploy Langflow on Google Cloud Platform](#deploy-langflow-on-google-cloud-platform) | ||
- [Deploy on Railway](#deploy-on-railway) | ||
- [Deploy on Render](#deploy-on-render) | ||
- [Deploy on Kubernetes](#deploy-on-kubernetes) | ||
- [🖥️ Command Line Interface (CLI)](#️-command-line-interface-cli) | ||
- [Usage](#usage) | ||
- [Environment Variables](#environment-variables) | ||
- [👋 Contribute](#-contribute) | ||
- [🌟 Contributors](#-contributors) | ||
- [📄 License](#-license) | ||
|
||
# 📦 Get Started | ||
|
||
You can install Langflow with pip: | ||
|
||
```shell | ||
# Make sure you have >=Python 3.10 installed on your system. | ||
python -m pip install langflow -U | ||
``` | ||
|
||
Then, run Langflow with: | ||
|
||
```shell | ||
python -m langflow run | ||
``` | ||
|
||
# Running Langflow from a Cloned Repository | ||
|
||
If you prefer to run Langflow from a cloned repository rather than installing it via pip, follow these steps: | ||
|
||
1. **Clone the Repository** | ||
|
||
First, clone the Langflow repository from GitHub: | ||
|
||
```shell | ||
git clone https://github.com/langflow-ai/langflow.git | ||
``` | ||
|
||
Navigate into the cloned directory: | ||
|
||
```shell | ||
cd langflow | ||
``` | ||
|
||
2. **Build and Install Dependencies** | ||
|
||
To build and install Langflow’s frontend and backend, use the following commands: | ||
|
||
```shell | ||
make install_frontend && make build_frontend && make install_backend | ||
``` | ||
|
||
3. **Run Langflow** | ||
|
||
Once the installation is complete, you can run Langflow with: | ||
|
||
```shell | ||
poetry run python -m langflow run | ||
``` | ||
|
||
# 🎨 Create Flows | ||
|
||
Creating flows with Langflow is easy. Simply drag components from the sidebar onto the workspace and connect them to start building your application. | ||
|
||
Explore by editing prompt parameters, grouping components into a single high-level component, and building your own Custom Components. | ||
|
||
Once you’re done, you can export your flow as a JSON file. | ||
|
||
Load the flow with: | ||
|
||
```python | ||
from langflow.load import run_flow_from_json | ||
|
||
results = run_flow_from_json("path/to/flow.json", input_value="Hello, World!") | ||
``` | ||
|
||
# Deploy | ||
|
||
## DataStax Langflow | ||
|
||
DataStax Langflow is a hosted version of Langflow integrated with [AstraDB](https://www.datastax.com/products/datastax-astra). Be up and running in minutes with no installation or setup required. [Sign up for free](https://langflow.datastax.com). | ||
|
||
## Deploy Langflow on Hugging Face Spaces | ||
|
||
You can also preview Langflow in [HuggingFace Spaces](https://huggingface.co/spaces/Langflow/Langflow). [Clone the space using this link](https://huggingface.co/spaces/Langflow/Langflow?duplicate=true) to create your own Langflow workspace in minutes. | ||
|
||
## Deploy Langflow on Google Cloud Platform | ||
|
||
Follow our step-by-step guide to deploy Langflow on Google Cloud Platform (GCP) using Google Cloud Shell. The guide is available in the [**Langflow in Google Cloud Platform**](./docs/docs/Deployment/deployment-gcp.md) document. | ||
|
||
Alternatively, click the **"Open in Cloud Shell"** button below to launch Google Cloud Shell, clone the Langflow repository, and start an **interactive tutorial** that will guide you through the process of setting up the necessary resources and deploying Langflow on your GCP project. | ||
|
||
[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/langflow-ai/langflow&working_dir=scripts/gcp&shellonly=true&tutorial=walkthroughtutorial_spot.md) | ||
|
||
## Deploy on Railway | ||
|
||
Use this template to deploy Langflow 1.0 on Railway: | ||
|
||
[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/JMXEWp?referralCode=MnPSdg) | ||
|
||
## Deploy on Render | ||
|
||
<a href="https://render.com/deploy?repo=https://github.com/langflow-ai/langflow/tree/main"> | ||
<img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render" /> | ||
</a> | ||
|
||
## Deploy on Kubernetes | ||
|
||
Follow our step-by-step guide to deploy [Langflow on Kubernetes](./docs/docs/Deployment/deployment-kubernetes.md). | ||
|
||
# 🖥️ Command Line Interface (CLI) | ||
|
||
Langflow provides a command-line interface (CLI) for easy management and configuration. | ||
|
||
## Usage | ||
|
||
You can run the Langflow using the following command: | ||
|
||
```shell | ||
langflow run [OPTIONS] | ||
``` | ||
|
||
Each option is detailed below: | ||
|
||
- `--help`: Displays all available options. | ||
- `--host`: Defines the host to bind the server to. Can be set using the `LANGFLOW_HOST` environment variable. The default is `127.0.0.1`. | ||
- `--workers`: Sets the number of worker processes. Can be set using the `LANGFLOW_WORKERS` environment variable. The default is `1`. | ||
- `--timeout`: Sets the worker timeout in seconds. The default is `60`. | ||
- `--port`: Sets the port to listen on. Can be set using the `LANGFLOW_PORT` environment variable. The default is `7860`. | ||
- `--env-file`: Specifies the path to the .env file containing environment variables. The default is `.env`. | ||
- `--log-level`: Defines the logging level. Can be set using the `LANGFLOW_LOG_LEVEL` environment variable. The default is `critical`. | ||
- `--components-path`: Specifies the path to the directory containing custom components. Can be set using the `LANGFLOW_COMPONENTS_PATH` environment variable. The default is `langflow/components`. | ||
- `--log-file`: Specifies the path to the log file. Can be set using the `LANGFLOW_LOG_FILE` environment variable. The default is `logs/langflow.log`. | ||
- `--cache`: Selects the type of cache to use. Options are `InMemoryCache` and `SQLiteCache`. Can be set using the `LANGFLOW_LANGCHAIN_CACHE` environment variable. The default is `SQLiteCache`. | ||
- `--dev/--no-dev`: Toggles the development mode. The default is `no-dev`. | ||
- `--path`: Specifies the path to the frontend directory containing build files. This option is for development purposes only. Can be set using the `LANGFLOW_FRONTEND_PATH` environment variable. | ||
- `--open-browser/--no-open-browser`: Toggles the option to open the browser after starting the server. Can be set using the `LANGFLOW_OPEN_BROWSER` environment variable. The default is `open-browser`. | ||
- `--remove-api-keys/--no-remove-api-keys`: Toggles the option to remove API keys from the projects saved in the database. Can be set using the `LANGFLOW_REMOVE_API_KEYS` environment variable. The default is `no-remove-api-keys`. | ||
- `--install-completion [bash|zsh|fish|powershell|pwsh]`: Installs completion for the specified shell. | ||
- `--show-completion [bash|zsh|fish|powershell|pwsh]`: Shows completion for the specified shell, allowing you to copy it or customize the installation. | ||
- `--backend-only`: This parameter, with a default value of `False`, allows running only the backend server without the frontend. It can also be set using the `LANGFLOW_BACKEND_ONLY` environment variable. | ||
- `--store`: This parameter, with a default value of `True`, enables the store features, use `--no-store` to deactivate it. It can be configured using the `LANGFLOW_STORE` environment variable. | ||
|
||
These parameters are important for users who need to customize the behavior of Langflow, especially in development or specialized deployment scenarios. | ||
|
||
### Environment Variables | ||
|
||
You can configure many of the CLI options using environment variables. These can be exported in your operating system or added to a `.env` file and loaded using the `--env-file` option. | ||
|
||
A sample `.env` file named `.env.example` is included with the project. Copy this file to a new file named `.env` and replace the example values with your actual settings. If you're setting values in both your OS and the `.env` file, the `.env` settings will take precedence. | ||
|
||
# 👋 Contribute | ||
|
||
We welcome contributions from developers of all levels to our open-source project on GitHub. If you'd like to contribute, please check our [contributing guidelines](./CONTRIBUTING.md) and help make Langflow more accessible. | ||
|
||
--- | ||
|
||
[![Star History Chart](https://api.star-history.com/svg?repos=langflow-ai/langflow&type=Timeline)](https://star-history.com/#langflow-ai/langflow&Date) | ||
|
||
# 🌟 Contributors | ||
|
||
[![langflow contributors](https://contrib.rocks/image?repo=langflow-ai/langflow)](https://github.com/langflow-ai/langflow/graphs/contributors) | ||
|
||
# 📄 License | ||
|
||
Langflow is released under the MIT License. See the [LICENSE](LICENSE) file for details. |
Oops, something went wrong.