Get Started

Cloud

Self-hosting requires more technical skill to setup instance, backing up database and maintaning updates. If you aren't experienced at managing servers and just want to use the webapp, we recommend using SamaFlow Cloud.

Quick Start

INFO: Pre-requisite: ensure NodeJS is installed on machine. Node v18.15.0 or v20 and above is supported.

Install SamaFlow locally using NPM.

  1. Install SamaFlow:
npm install -g samaflow

You can also install a specific version. Refer to available versions.

npm install -g samaflow@x.x.x
  1. Start SamaFlow:
npx samaflow start
  1. Open: http://localhost:3000

Docker

There are two ways to deploy SamaFlow with Docker. First, git clone the project: https://github.com/SamaFlow/SamaFlow

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:
docker compose up -d
  1. Open: http://localhost:3000
  2. You can bring the containers down by running:
docker compose stop

Docker Image

  1. Build the image:
docker build --no-cache -t samaflow .
  1. Run image:
docker run -d --name samaflow -p 3000:3000 samaflow
  1. Stop image:
docker stop samaflow

For Developers

SamaFlow has 4 different modules in a single mono repository:

  • Server: Node backend to serve API logics
  • UI: React frontend
  • Components: Integration components
  • Api Documentation: Swagger spec for SamaFlow APIs

Prerequisite

Install PNPM.

npm i -g pnpm

Setup 1

Simple setup using PNPM:

  1. Clone the repository
git clone https://github.com/SamaFlow/SamaFlow.git
  1. Go into repository folder
cd SamaFlow
  1. Install all dependencies of all modules:
pnpm install
  1. Build the code:
pnpm build

Start the app at http://localhost:3000

pnpm start

Setup 2

Step-by-step setup for project contributors:

  1. Fork the official SamaFlow Github Repository
  2. Clone your forked repository
  3. Create a new branch, see guide. Naming conventions:
    • For feature branch: feature/<Your New Feature>
    • For bug fix branch: bugfix/<Your New Bugfix>.
  4. Switch to the branch you just created
  5. Go into repository folder:
cd SamaFlow
  1. Install all dependencies of all modules:
pnpm install
  1. Build the code:
pnpm build
  1. Start the app at http://localhost:3000
pnpm start

  1. For development build:

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

  3. Create .env file and specify the PORT (refer to .env.example) in packages/server
pnpm dev
  • 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:

    pnpm build

    and

    pnpm start

    to make sure everything works fine in production.

For Enterprise

Before starting the app, enterprise users are required to fill in the values for Enterprise Parameters in the .env file. Refer to .env.example for the required changes.

Reach out to support@flowiseai.com for the value of following env variables:

LICENSE_URL
FLOWISE_EE_LICENSE_KEY

Learn More

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

Embedded Link

Community Guide

results matching ""

    No results matching ""