n8n-nodes-llm-openwebui

This is an n8n community node that lets you interact with OpenWebUI models in your n8n workflows.

OpenWebUI is an extensible web interface for running and managing local or remote AI models. It supports chat-style interactions, file and knowledge base integrations, and an OpenAI-compatible API.

n8n is a fair-code licensed workflow automation platform.

• Installation
• Operations
• Credentials
• Compatibility
• Usage
• Resources
• Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Install this package by searching for n8n-nodes-llm-openwebui inside Settings → Community Nodes in your n8n instance.

Operations

The OpenWebUI node currently supports:

• Chat with Model: send a user message to a chosen model and receive its response.
• Attach File (optional): upload a binary file from your workflow and include it in the conversation.
• Use Knowledge Collection (optional): attach an entire knowledge base collection, and optionally add files into it before sending the query.

Credentials

You need to create OpenWebUI API credentials in n8n.

Prerequisites

• An OpenWebUI instance (local or remote) with API access enabled.
• An API key (from OpenWebUI → Settings → Account).

Fields

• Base URL: e.g. http://localhost:3000
• API Key: your personal OpenWebUI API key

These credentials are used for all requests (chat, file upload, and knowledge base management).

Compatibility

• Requires n8n v1.20.0 or higher (tested).
• Requires Node.js 22.0.0 or higher to build the package.
• Tested against OpenWebUI releases >=0.6 and against >=0.6.22 with the OpenAI-compatible API endpoints enabled.

Usage

1. Add the OpenWebUI Chat node to your workflow.
2. Configure your credentials with the Base URL and API key.
3. Select a Model (the node dynamically loads available models from your OpenWebUI).
4. Enter your User Message.
5. (Optional) Provide a Binary Property if you want to attach a file.
6. (Optional) Select a Knowledge Collection to include, and choose whether to add uploaded files into it.
7. Run the workflow. The model’s reply will be available in the node output under json.content (short) or json.choices.choices[0].message.content (full).

Resources

• n8n community nodes documentation
• OpenWebUI GitHub repository
• OpenWebUI API reference (OpenAI-compatible)

Version history

• 1.0.0
  • Initial release with model selection, message sending, and optional file upload with Knowledge Base integration (list collections, add files to collections, reference them in chat).