npm package: @humanfirst/n8n-nodes-humanfirst
Description: Custom HumanFirst integration for n8n. Provides operations to interact with HumanFirst tool, an AI studio designed to help you build reliable, context-rich, reusable AI workflows and automations
Author: Mohammed Fayaz Ansar Jelani
Latest version: 1.0.6

# n8n-nodes-humanfirst

This is an n8n community node that enables integration with the HumanFirst platform.

HumanFirst is a powerful AI studio for power users and teams, designed to help you build reliable, context-rich, reusable AI workflows and automations.

[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

## About HumanFirst

HumanFirst is a unified AI development and operations platform designed for people and teams who want to do more with AI. It helps you:

* **Chat with your data** via a conversational interface
* **Template your packages** using explicit context control
* **Run AI at scale** with parallel package execution
* **Manage context, packages, data, and results** in a single managed library

### What Makes HumanFirst Unique

1. **Package Building Studio**
   Create packages as if you’re delegating tasks to a real team member. Inject structured context, eliminate black-box packages, and ensure precision without in-chat adjustments.

2. **Prototyping Playground**
   Test and iterate on packages in real-time with both conversational and dataset-based feedback. Codify what works directly into your instructions.

3. **Managed Library**
   Keep your packages, inputs, contexts, and results centralized, version-controlled, and reusable across teams and projects.

### Built for Scale and Security

* SOC 2 Type II compliant
* Supports SSO & SAML
* Offers optional on-premise deployment
* Integrates with platforms like Zapier, Make, and n8n
* Compatible with major LLM providers: OpenAI, Anthropic, Cohere, Gemini, Mistral, and more

Learn more at [humanfirst.ai](https://www.humanfirst.ai).

[Installation](#installation)  
[Operations](#operations)  
[Credentials](#credentials)  
[Compatibility](#compatibility)  
[Usage](#usage)  
[Resources](#resources)  
[Version history](#version-history)


## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

## Operations

This node supports the following HumanFirst API operations:


| Operation                     | Description                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Add Column to CSV**         | Take a binary CSV, append one or more constant columns, return a new CSV                                  |
| **Convert JSON to CSV**       | Flatten input JSON items (or a named array field) into a CSV                                              |
| **Import CSV File**           | Import a CSV into a Conversation Source conversation set                                                  |
| **Import Document**           | Upload a document to a Conversation Source and trigger indexing                                           |
| **Get Playbook Info**         | Fetch metadata for a specific playbook                                                                     |
| **List Playbooks**            | List all playbooks within a namespace                                                                       |
| **Create Package**             | Create a new package in a playbook                                                                           |
| **List Packages**              | Retrieve all packages defined on a playbook                                                                  |
| **Get Package**                | Retrieve a single package by ID from a playbook                                                              |
| **Update Package**             | Update one or more fields of an existing package in a playbook                                              |
| **Delete Package**             | Delete a single package by ID from a playbook                                                                |
| **Trigger Package With Input** | Trigger a package with mention overrides and get generated completion with configurable timeout             |
| **Run Full Pipeline Workflow**| Trigger a pipeline, wait for completion, then export the data 

## Credentials

This node uses HumanFirst's API for authentication. You'll need to configure the following credentials:

| Field                  | Description                                                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------------- |
| **API Key**            | Your HumanFirst API Key (get it by following the steps [here](https://api-keys.humanfirst-docs.pages.dev/docs/api/api_keys)) |
| **Base URL**           | HumanFirst API base URL (default: `https://api.humanfirst.ai`)                                           |
| **API Version**        | API version (default: `v1alpha1`)                                                                              |
| **Namespace for Test** | A namespace used to validate credentials (must already exist)                                            |

These fields are entered when creating the HumanFirst API credentials in your n8n instance.

## Compatibility

Tested against following N8N and Node.js versions.
* **N8N version:** 1.92.2
* **Node.js version:** 20.19.0

## Usage

1. **Configure Credentials**
   Go to your n8n credentials manager and set up the **HumanFirst API** credentials using your API key and namespace.

2. **Add Node to Workflow**
   Insert the **HumanFirst** node into your workflow and choose an operation such as "List Playbooks" or "Import CSV".

3. **Set Parameters**
   Fill in the required parameters for the selected operation.

4. **Run and Automate**
   Execute the node and begin automating your AI workflows using HumanFirst's platform capabilities.

## Resources

* [HumanFirst Website](https://www.humanfirst.ai)
* [API Documentation](https://api-keys.humanfirst-docs.pages.dev/docs/api/api_keys)
* [n8n Community Nodes Docs](https://docs.n8n.io/integrations/community-nodes/)

## Version History

| Version | Changes                                                                                             |
| ------- | --------------------------------------------------------------------------------------------------- |
| 1.0.6   | Updated README with new terminology                                                                 |
| 1.0.5   | Updated terminology: Prompt → Package, Stash → Merge All Items                                      |
| 1.0.4   | Added Trigger Prompt With Input operation with configurable timeout and multiple mention overrides  |
| 1.0.3   | Fixed bugs on update prompt and update pipeline operations                                          |
| 1.0.2   | Added update pipeline operation - specific to re-setting current day filter                         |
| 1.0.1   | Added list, get, create, delete, update prompts operations                                          |
| 1.0.0   | Initial release with playbook listing, document import, CSV handling, and pipeline workflow support |