| 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 <jeremy@intentsolutions.io> |
| 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 |
