Browse Source

Update 'README.md'

天问 1 year ago
parent
commit
4851641958
1 changed files with 120 additions and 1 deletions
  1. 120 1
      README.md

+ 120 - 1
README.md

@@ -1,2 +1,121 @@
-# Flowise
+<!-- markdownlint-disable MD030 -->
 
+# Flowise - LangchainJS UI
+
+<a href="https://github.com/FlowiseAI/Flowise">
+<img width="100%" src="https://github.com/FlowiseAI/Flowise/blob/main/images/flowise.gif?raw=true"></a>
+
+Drag & drop UI to build your customized LLM flow using [LangchainJS](https://github.com/hwchase17/langchainjs)
+
+## ⚡Quick Start
+
+1. Install Flowise
+    ```bash
+    npm install -g flowise
+    ```
+2. Start Flowise
+
+    ```bash
+    npx flowise start
+    ```
+
+    With username & password
+
+    ```bash
+    npx flowise start --FLOWISE_USERNAME=user --FLOWISE_PASSWORD=1234
+    ```
+
+3. Open [http://localhost:3000](http://localhost:3000)
+
+## 🐳 Docker
+
+### Docker Compose
+
+1. Go to `docker` folder at the root of the project
+2. Create `.env` file and specify the `PORT` (refer to `.env.example`)
+3. `docker-compose up -d`
+4. Open [http://localhost:3000](http://localhost:3000)
+5. You can bring the containers down by `docker-compose stop`
+
+### Docker Image
+
+1. Build the image locally:
+    ```bash
+    docker build --no-cache -t flowise .
+    ```
+2. Run image:
+
+    ```bash
+    docker run -d --name flowise -p 3000:3000 flowise
+    ```
+
+3. Stop image:
+    ```bash
+    docker stop flowise
+    ```
+
+## 👨‍💻 Developers
+
+Flowise has 3 different modules in a single mono repository.
+
+-   `server`: Node backend to serve API logics
+-   `ui`: React frontend
+-   `components`: Langchain components
+
+### Prerequisite
+
+-   Install Yarn
+    ```bash
+    npm i -g yarn
+    ```
+
+### Setup
+
+1. Clone the repository
+
+    ```bash
+    git clone https://github.com/FlowiseAI/Flowise.git
+    ```
+
+2. Go into repository folder
+
+    ```bash
+    cd Flowise
+    ```
+
+3. Install all dependencies of all modules:
+
+    ```bash
+    yarn install
+    ```
+
+4. Build all the code:
+
+    ```bash
+    yarn build
+    ```
+
+5. Start the app:
+
+    ```bash
+    yarn start
+    ```
+
+    You can now access the app on [http://localhost:3000](http://localhost:3000)
+
+6. For development build:
+
+    ```bash
+    yarn dev
+    ```
+
+    Any code changes will reload the app automatically on [http://localhost:8080](http://localhost:8080)
+
+## 🔒 Authentication
+
+To enable app level authentication, add `FLOWISE_USERNAME` and `FLOWISE_PASSWORD` to the `.env` file in `packages/server`:
+
+```
+FLOWISE_USERNAME=user
+FLOWISE_PASSWORD=1234
+```