Skip to main content

​
Get Started in Minutes

This guide will help you install Flowise and create your first working chatflow quickly.
Prerequisites: Ensure you have Node.js version 18.15.0 or higher installed.
1

Install Flowise

Install Flowise globally using npm:
npm install -g flowise
This command installs Flowise as a global package, making it available from anywhere on your system.
2

Start Flowise

Launch the Flowise application:
npx flowise start
The server will start on port 3000 by default. You can customize this and other settings using environment variables.
3

Access the Interface

Open your browser and navigate to:
http://localhost:3000
You should see the Flowise visual builder interface.
4

Create Your First Chatflow

Now let’s build a simple chatflow:
  1. Click on “Add New” to create a new chatflow
  2. From the nodes panel, drag and drop:
    • A Chat Model node (e.g., ChatOpenAI)
    • A Conversation Chain node
  3. Connect the nodes by dragging from one node’s output to another’s input
  4. Configure your LLM API key in the Chat Model node settings
  5. Click “Save” to save your chatflow
  6. Click the “Chat” button to test your chatflow
Don’t have an API key? You can get one from OpenAI’s platform.
5

Test Your Chatflow

In the chat interface:
  1. Type a message like “Hello, who are you?”
  2. Press Enter to send
  3. Watch your AI agent respond!
Congratulations! You’ve created your first Flowise chatflow.

​
What’s Next?

Explore Components

Discover the wide range of LLMs, tools, vector stores, and other components available in Flowise.

Build an Agent

Learn how to create more sophisticated AI agents that can use tools and reasoning.

Configure Your Instance

Customize Flowise with environment variables for database, authentication, and more.

Deploy to Production

Deploy your Flowise instance to AWS, Azure, GCP, or other platforms.

​
Troubleshooting

If port 3000 is occupied, you can specify a different port using the PORT environment variable:
PORT=3001 npx flowise start
Flowise requires Node.js >= 18.15.0. Check your version:
node --version
If your version is lower, download and install the latest LTS version from nodejs.org.
Try clearing your npm cache and reinstalling:
npm cache clean --force
npm install -g flowise

​
Alternative: Docker Quickstart

Prefer Docker? You can also run Flowise with Docker: 
docker run -d --name flowise -p 3000:3000 flowiseai/flowise:latest
Then access Flowise at http://localhost:3000. For more Docker options, see the Installation Guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us