groq-upgrade-migration

name	groq-upgrade-migration
description	Upgrade groq-sdk versions and handle Groq model deprecations. Use when upgrading SDK versions, detecting deprecated models, or migrating to new Groq model IDs. Trigger with phrases like "upgrade groq", "groq migration", "groq breaking changes", "update groq SDK", "groq deprecated model".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(git:*)
version	1.11.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","groq","api","migration"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Groq Upgrade & Migration

Current State

!npm list groq-sdk 2>/dev/null | grep groq-sdk || echo 'groq-sdk not installed' !pip show groq 2>/dev/null | grep -E "Name|Version" || echo 'groq not installed (python)'

Overview

Guide for upgrading the groq-sdk package and migrating away from deprecated model IDs. It walks a safe upgrade path — branch, bump, scan for deprecated model references, rewrite them, and verify against the live models endpoint before merging.

Prerequisites

• A Node project that depends on groq-sdk (or the Python groq package).
• npm, git, curl, and jq available on PATH.
• Authentication: GROQ_API_KEY exported in your shell (or CI secret store). The SDK constructor new Groq() reads it automatically; the live model check passes it as Authorization: Bearer $GROQ_API_KEY. Get a key at https://console.groq.com/keys. See the Authentication section of references/implementation.md.

Model Deprecation Timeline

Groq announces deprecations with advance notice. These models have been deprecated:

Deprecated Model	Deprecation Date	Replacement
mixtral-8x7b-32768	2025-03-05	llama-3.3-70b-versatile or llama-3.1-8b-instant
gemma2-9b-it	2025-08-08	llama-3.1-8b-instant
llama-3.1-70b-versatile	2024-12-06	llama-3.3-70b-versatile
llama-3.1-70b-specdec	2024-12-06	llama-3.3-70b-specdec
playai-tts	2025-12-23	Orpheus TTS models
playai-tts-arabic	2025-12-23	Orpheus TTS models
distil-whisper-large-v3-en