How to contribute?
π Hello there! 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 and help make Langflow more accessible.
As an open-source project in a rapidly developing field, we are extremely open to contributions, whether in the form of a new feature, improved infra, or better documentation.
To contribute to this project, please follow a "fork and pull request" workflow.
Please do not try to push directly to this repo unless you are a maintainer.
Local developmentβ
You can develop Langflow using docker compose, or locally.
We provide a .vscode/launch.json file for debugging the backend in VSCode, which is a lot faster than using docker compose.
Setting up hooks:
_10make init
This will install the pre-commit hooks, which will run make format
on every commit.
It is advised to run make lint
before pushing to the repository.
Run locallyβ
Langflow can run locally by cloning the repository and installing the dependencies. We recommend using a virtual environment to isolate the dependencies from your system.
Before you start, make sure you have the following installed:
- Poetry (>=1.4)
- Node.js
Then, in the root folder, install the dependencies and start the development server for the backend:
_10make backend
And the frontend:
_10make frontend
Docker composeβ
The following snippet will run the backend and frontend in separate containers. The frontend will be available at localhost:3000
and the backend at localhost:7860
.
_10docker compose up --build_10# or_10make dev build=1
Documentationβ
The documentation is built using Docusaurus. To run the documentation locally, run the following commands:
_10cd docs_10npm install_10npm run start
The documentation will be available at localhost:3000
and all the files are located in the docs/docs
folder.
Once you are done with your changes, you can create a Pull Request to the main
branch.