@elizaos/plugin-groq

Groq LLM plugin for elizaOS - Fast inference with GPT-OSS models.

This plugin provides Groq API integration for elizaOS agents, enabling ultra-fast text generation, audio transcription, and text-to-speech synthesis.

Features

🚀 Fast Inference - Leverage Groq's LPU for industry-leading inference speeds
📝 Text Generation - Generate text with GPT-OSS models
🎤 Audio Transcription - Transcribe audio with Whisper models
🔊 Text-to-Speech - Generate speech with PlayAI voices
🔢 Object Generation - Generate structured JSON objects
🎯 Tokenization - Tokenize and detokenize text

bash

npm install @elizaos/plugin-groq
# or
bun add @elizaos/plugin-groq

typescript

import { groqPlugin } from "@elizaos/plugin-groq";

// Add to your agent's plugins
const agent = new Agent({
  plugins: [groqPlugin],
});

Set the following environment variables:

Variable	Required	Default	Description
`GROQ_API_KEY`	Yes	-	Your Groq API key
`GROQ_BASE_URL`	No	`https://api.groq.com/openai/v1`	Custom API base URL
`GROQ_SMALL_MODEL`	No	`openai/gpt-oss-120b`	Model for small tasks
`GROQ_LARGE_MODEL`	No	`openai/gpt-oss-120b`	Model for large tasks
`GROQ_TTS_MODEL`	No	`canopylabs/orpheus-v1-english`	Text-to-speech model
`GROQ_TTS_VOICE`	No	`troy`	TTS voice name
`GROQ_TTS_RESPONSE_FORMAT`	No	`wav`	TTS response format

This plugin provides handlers for the following elizaOS model types:

Model Type	Description
`TEXT_SMALL`	Fast text + structured output via native tool calling (tools, toolChoice, responseSchema)
`TEXT_LARGE`	Capable text + structured output via native tool calling (tools, toolChoice, responseSchema)
`TRANSCRIPTION`	Audio transcription with Whisper
`TEXT_TO_SPEECH`	Speech synthesis with PlayAI
`TEXT_TOKENIZER_ENCODE`	Tokenize text to tokens
`TEXT_TOKENIZER_DECODE`	Detokenize tokens to text

bash

# TypeScript
bun install
bun run build
# TypeScript
bun run test
# TypeScript
bun run format:check