> ## Documentation Index
> Fetch the complete documentation index at: https://docs.standardagentbuilder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# @standardagents/groq

> Groq provider package for Standard Agents using the official groq-sdk

<Info>
  **Enabled when** `GROQ_API_KEY` is set in your environment.
</Info>

## Overview

The `@standardagents/groq` package provides a Standard Agents provider for Groq's chat completions API. It uses the official `groq-sdk`, supports streaming, reasoning-capable models, tool calling, and model discovery through Groq's models API.

<Card title="Key Features" icon="rocket">
  * Official `groq-sdk` integration
  * Tool calling and structured outputs
  * Reasoning support for `gpt-oss-*` and `qwen/qwen3-32b`
  * Vision input support for Groq multimodal models
  * Built-in pricing for documented Groq models in request logs
</Card>

## Installation

```bash pnpm theme={null}
pnpm add @standardagents/groq
```

## Quick Start

```typescript theme={null}
import { defineModel } from '@standardagents/spec';
import { groq } from '@standardagents/groq';

export default defineModel({
  name: 'groq-fast',
  provider: groq,
  model: 'llama-3.1-8b-instant',
  providerOptions: {
    reasoning_format: 'parsed',
  },
});
```

## Common Models

* `llama-3.1-8b-instant`
* `llama-3.3-70b-versatile`
* `meta-llama/llama-4-scout-17b-16e-instruct`
* `moonshotai/kimi-k2-instruct`
* `openai/gpt-oss-120b`
* `openai/gpt-oss-20b`
* `qwen/qwen3-32b`

## Provider Options

Use `reasoning_format`, `reasoning_effort`, `citation_options`, `service_tier`, `disable_tool_validation`, `search_settings`, and `documents` to access Groq-specific behavior.

## Environment Setup

```bash .dev.vars theme={null}
GROQ_API_KEY=...
```