n8n-nodes-groq-chat

Custom n8n node for Groq API - A supply node that provides Groq language models for use with Basic LLM Chain and other AI nodes in n8n.

Description

This n8n custom node provides a Groq Chat Model supply node that can be connected to the Basic LLM Chain node or other AI processing nodes in n8n. Groq provides ultra-fast inference for large language models, making it perfect for real-time AI applications.

Features

- ✅ Supply Node: Provides Groq language models as a supply node (compatible with Basic LLM Chain)
- ✅ Dynamic Model Loading: Automatically fetches available models from Groq API
- ✅ Multiple Models: Support for all Groq models (Llama, Mixtral, Gemma, GPT-OSS, etc.)
- ✅ Configurable Parameters: Temperature, max tokens, include reasoning, and other model options
- ✅ Direct SDK Integration: Uses groq-sdk directly for optimal performance
- ✅ Real-time API: Leverages Groq's fast inference engine for low-latency responses

Installation

$3

``bash
npm install n8n-nodes-groq-chat
`

Then restart your n8n instance. The node will appear in the node palette under "AI" → "Language Models".

$3

1. Clone this repository or download the source code
2. Install dependencies:
`bash
npm install
`
3. Build the node:
`bash
npm run build
`
4. Link to your n8n instance:
- Set the N8N_CUSTOM_EXTENSIONS environment variable to point to this directory, or
- Copy the dist folder to your n8n custom nodes location

Configuration

$3

1. Go to Credentials in n8n
2. Click Add Credential
3. Search for "Groq API" and select it
4. Enter your API key from Groq Console
5. Click Save

$3

1. In your workflow, click + to add a node
2. Search for "Groq Chat Model"
3. Select the node to add it to your workflow

$3

1. Select Credentials: Choose your Groq API credentials
2. Choose Model: Select a model from the dropdown (models are loaded dynamically from Groq API)
3. Configure Options (optional):
- Temperature: Controls randomness (0-1, default: 0.7)
- Max Tokens: Maximum number of tokens to generate (default: 4096)
- Include Reasoning: Whether to include reasoning steps in the response (default: false)

$3

1. Add a Basic LLM Chain node to your workflow
2. Connect the Model output from Groq Chat Model to the Model input of Basic LLM Chain
3. Configure your chain with prompts and other settings

Usage Example

`
┌─────────────────┐
│ Groq Chat Model │
│ (Supply Node) │
└────────┬────────┘
│ Model
▼
┌─────────────────┐
│ Basic LLM Chain │
│ (AI Node) │
└─────────────────┘
`

The Groq Chat Model node provides the language model instance that the Basic LLM Chain uses to process prompts and generate responses.

Available Models

The node dynamically loads all available models from Groq API :




$3

The table below summarizes some of the main Groq models (Developer plan values, subject to change – always check the Groq console for the latest numbers):

| Model | Model ID | Speed (tokens/s) | Price per 1M tokens | Rate limits (TPM / RPM) | Context window (tokens) | Max completion tokens | Max file size |
|-------|----------|------------------|----------------------|--------------------------|-------------------------|------------------------|---------------|
| Meta Llama 3.1 8B | llama-3.1-8b-instant | ~560 | $0.05 input / $0.08 output | 250K TPM / 1K RPM | 131,072 | 131,072 | - |
| Meta Llama 3.3 70B | llama-3.3-70b-versatile | ~280 | $0.59 input / $0.79 output | 300K TPM / 1K RPM | 131,072 | 32,768 | - |
| Meta Llama Guard 4 12B | meta-llama/llama-guard-4-12b | ~1200 | $0.20 input / $0.20 output | 30K TPM / 100 RPM | 131,072 | 1,024 | 20 MB |
| OpenAI GPT-OSS 120B | openai/gpt-oss-120b | ~500 | $0.15 input / $0.60 output | 250K TPM / 1K RPM | 131,072 | 65,536 | - |
| OpenAI GPT-OSS 20B | openai/gpt-oss-20b | ~1000 | $0.075 input / $0.30 output | 250K TPM / 1K RPM | 131,072 | 65,536 | - |
| OpenAI Whisper Large V3 | whisper-large-v3 | - | $0.111 per hour | 200K ASH / 300 RPM | - | - | 100 MB |
| OpenAI Whisper Large V3 Turbo | whisper-large-v3-turbo | - | $0.04 per hour | 400K ASH / 400 RPM | - | - | 100 MB |

Development

$3

- Node.js 18+
- npm or yarn




$3

`bash


Clone the repository

git clone
cd n8n-groq

Install dependencies

npm install

Build the node

npm run build
`

$3

- npm run build - Build the node
- npm run dev - Watch mode for development
- npm run lint - Run linter
- npm run format` - Format code

Troubleshooting

$3

- Verify your API key is correct in credentials
- Check your internet connection
- Ensure the Groq API is accessible from your n8n instance

$3

- This usually means the API returned an empty list
- Try refreshing the node or check Groq API status

Resources

- Groq API Documentation
- Groq Console
- n8n Node Creation Documentation
- n8n AI Nodes Documentation

License

MIT

Author

maxime-pharmania