Get Started


Before you can get started, you'll need to ensure that you have the NodeJS installed on your computer. Node v18.15.0 or v20 and above is supported.

Quick Start

Install Flowise locally using NPM.

  1. Install Flowise:

  2. Start Flowise:


Docker

There are two ways to deploy Flowise with Docker:

Docker Compose

  1. Go to docker folder at the root of the project

  2. Copy the .env.example file and paste it as another file named .env

  3. Run:

  4. You can bring the containers down by running:

Docker Image

  1. Build the image:

  1. Run image:

  1. Stop image:


For Developers

Flowise has 3 different modules in a single mono repository:

  • Server: Node backend to serve API logics

  • UI: React frontend

  • Components: Integration components

Prerequisite

Install PNPM.

Setup 1

Simple setup using PNPM:

  1. Clone the repository

  1. Go into repository folder

  2. Install all dependencies of all modules:

  3. Build the code:

Start the app at http://localhost:3000

Setup 2

Step-by-step setup for project contributors:

  1. Clone your forked repository

  2. Create a new branch, see guide. Naming conventions:

    • For feature branch: feature/<Your New Feature>

    • For bug fix branch: bugfix/<Your New Bugfix>.

  3. Switch to the branch you just created

  4. Go into repository folder:

  5. Install all dependencies of all modules:

  6. Build the code:

  7. For development build:

  • Create .env file and specify the PORT (refer to .env.example) in packages/ui

  • Create .env file and specify the PORT (refer to .env.example) in packages/server

  • Any changes made in packages/ui or packages/server will be reflected at http://localhost:8080

  • For changes made in packages/components, you will need to build again to pickup the changes

  • After making all the changes, run:

    and

    to make sure everything works fine in production.


Learn More

In this video tutorial, Leon provides an introduction to Flowise and explains how to set it up on your local machine.

Community Guide