n8n-nodes-pipelex
v0.0.5
Published
Pipelex n8n node package
Maintainers
Keywords
Readme
What is this?
This is an n8n community node that lets you execute Pipelex AI pipelines directly in your n8n workflows. Transform unstructured data into structured knowledge using repeatable AI operations.
What is Pipelex?
Pipelex is an open-source language for AI Agents to create and run repeatable AI workflows with modular, composable pipelines.
Build modular "pipes" where each uses different LLMs and guarantees structured outputs. Connect them like LEGO blocks — sequentially, in parallel, or conditionally — to build complex knowledge transformations from simple, reusable components.
Learn more about Pipelex:
Installation
Prerequisites
Before installing this node, you'll need a Pipelex API server running. Choose one option:
Option A: Use Pipelex Cloud API (Coming Soon)
The hosted Pipelex API will be available soon. Join the waitlist.
Option B: Self-host with Docker (Recommended)
Run your own Pipelex API server using Docker (See more here Pipelex-api)
# Pull the official Docker image
% docker pull pipelex/pipelex-api
# Run with your API key and LLM provider key
% docker run --name pipelex-api -p 8081:8081 \
-e API_KEY=your-bearer-token-here \
-e PIPELEX_INFERENCE_API_KEY=your-pipelex-inference-key \
pipelex/pipelex-api:latestGet a free PIPELEX_INFERENCE_API_KEY ($20 free credits) in our Discord # 🔑・free-api-key channel or by filling this form.
For detailed setup instructions, see the Pipelex API documentation.
Install the n8n Community Node
Follow the installation guide in the n8n community nodes documentation.
Credentials
This node requires Pipelex API credentials to authenticate with your Pipelex API server.
Setting up credentials:
- In your n8n workflow, add a Pipelex node
- Click on Credential to connect with
- Select Create New Credential
- Enter your Bearer Token (the
API_KEYyou configured in your Pipelex API server) - (Optional) Test the credential to verify the connection
Where to get your API key:
- If self-hosting: Use the
API_KEYyou set when starting your Pipelex API Docker container - If using Pipelex Cloud (coming soon): Get it from your Pipelex dashboard
Node Configuration
The Pipelex node supports the following parameters:
Required Parameters
| Parameter | API Field | Description |
|-----------|-----------|-------------|
| Base URL | - | The base URL of your Pipelex API server (e.g., http://localhost:8081, http://host.docker.internal:8081...) (Soon the public API) |
| Inputs | inputs | JSON object containing the inputs for your pipeline (must match your pipeline's expected inputs) |
| Pipe Code | pipe_code | The code of a pre-registered pipeline to execute |
| Pipelex Bundle | plx_content | Inline PLX code to execute (if not using a pre-registered pipeline) |
Note: You must provide either Pipe Code or Pipelex Bundle (or both). Learn more about the Pipelex API here.
Optional Parameters
| Parameter | API Field | Description |
|-----------|-----------|-------------|
| Output Name | output_name | Specify a particular output name to retrieve |
| Output Multiplicity | output_multiplicity | Control the multiplicity of outputs |
| Dynamic Output Concept Code | dynamic_output_concept_code | Code for dynamic output concepts |
Usage
Quick Start
- Add the Pipelex node to your n8n workflow
- Configure credentials (Bearer Token)
- Set the Base URL (e.g.,
http://localhost:8081orhttp://host.docker.internal:8081local Docker) - Choose execution mode:
- Option A: Provide
Pipe Code(for pre-registered pipelines) - Option B: Provide inline
Pipelex Bundle(PLX syntax)
- Option A: Provide
- Set Inputs as a JSON object matching your pipeline's expected inputs
- Execute the workflow
The node will return the pipeline execution results, which can be passed to subsequent nodes in your workflow. Learn more about the output format here.
Examples
WIP
Resources
Documentation
- 📚 Pipelex Documentation - Complete guide to building pipelines
- 🔌 Pipelex API Documentation - API reference and integration guide
- 🔧 n8n Community Nodes - n8n node development guide
Community & Support
- 💬 Discord Community - Get help and share your workflows
- 🐛 GitHub Issues - Bug reports and feature requests
- 🌐 Pipelex Homepage - Learn more about Pipelex
Contributing
We welcome contributions! If you'd like to improve this node:
See CONTRIBUTING.md for more details.
Please report bugs and request features via GitHub Issues.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Acknowledgments
Built with ❤️ by the Pipelex team and community.
Special thanks to the n8n community for building an amazing automation platform.
