groq-upgrade-migration

•

1.9k2643 months ago

Analyze, plan, and execute Groq SDK upgrades with breaking change detection. Use when upgrading Groq SDK versions, detecting deprecations, or migrating to new API versions. Trigger with phrases like "upgrade groq", "groq migration", "groq breaking changes", "update groq SDK", "analyze groq version".

Quick Install

npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill groq-upgrade-migration

Instructions

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. Groq regularly deprecates older models in favor of newer, faster alternatives.

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

Loading…

Related Skills

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

367,360

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

367,309

1password

Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.

365,915

himalaya

CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).

365,885

Tags & Topics

aiautomationclaude-codedevopsmcpai-agents

llama-3.1-8b-instant

Model ID	Type	Context	Speed
`llama-3.1-8b-instant`	Text	128K	~560 tok/s
`llama-3.3-70b-versatile`	Text	128K	~280 tok/s
`llama-3.3-70b-specdec`	Text	128K	Faster
`meta-llama/llama-4-scout-17b-16e-instruct`	Vision+Text	128K	~460 tok/s
`meta-llama/llama-4-maverick-17b-128e-instruct`	Vision+Text	128K	—
`whisper-large-v3`	Audio STT	—	164x RT
`whisper-large-v3-turbo`	Audio STT	—	216x RT

set -euo pipefail
# SDK version
npm list groq-sdk 2>/dev/null
npm view groq-sdk version  # latest on npm

# Find all model references in your code
grep -rn "model.*['\"]" src/ --include="*.ts" --include="*.js" | grep -i "groq\|llama\|mixtral\|gemma\|whisper"

set -euo pipefail
# Create upgrade branch
git checkout -b chore/upgrade-groq-sdk

# Update to latest
npm install groq-sdk@latest

# Check for breaking changes
npm ls groq-sdk

// Find-and-replace map for deprecated model IDs
const MODEL_MIGRATIONS: Record<string, string> = {
  "mixtral-8x7b-32768": "llama-3.3-70b-versatile",
  "gemma2-9b-it": "llama-3.1-8b-instant",
  "llama-3.1-70b-versatile": "llama-3.3-70b-versatile",
  "llama-3.1-70b-specdec": "llama-3.3-70b-specdec",
  "llama3-70b-8192": "llama-3.3-70b-versatile",
  "llama3-8b-8192": "llama-3.1-8b-instant",
  "distil-whisper-large-v3-en": "whisper-large-v3-turbo",
};

function resolveModel(model: string): string {
  if (model in MODEL_MIGRATIONS) {
    console.warn(`Model ${model} is deprecated. Using ${MODEL_MIGRATIONS[model]} instead.`);
    return MODEL_MIGRATIONS[model];
  }
  return model;
}

set -euo pipefail
# Automated scan for deprecated patterns
echo "=== Deprecated Model IDs ==="
grep -rn "mixtral-8x7b\|gemma2-9b\|llama-3.1-70b-versatile\|llama3-70b\|llama3-8b\|distil-whisper" \
  src/ --include="*.ts" --include="*.js" --include="*.py" || echo "None found"

echo ""
echo "=== Old Import Patterns ==="
grep -rn "from '@groq/sdk'\|from \"@groq/sdk\"\|require('@groq/sdk')" \
  src/ --include="*.ts" --include="*.js" || echo "None found (correct import is 'groq-sdk')"

echo ""
echo "=== Deprecated Method Calls ==="
grep -rn "\.ping()\|\.healthCheck()\|GroqClient\|GroqError" \
  src/ --include="*.ts" --include="*.js" || echo "None found"

set -euo pipefail
# Run tests
npm test

# Verify models are current
curl -s https://api.groq.com/openai/v1/models \
  -H "Authorization: Bearer $GROQ_API_KEY" | \
  jq -r '.data[].id' | sort

# Integration test
node -e "
const Groq = require('groq-sdk').default;
const g = new Groq();
g.chat.completions.create({
  model: 'llama-3.1-8b-instant',
  messages: [{role: 'user', content: 'ping'}],
  max_tokens: 5
}).then(r => console.log('OK:', r.choices[0].message.content));
"

set -euo pipefail
# Pin to previous version
npm install [email protected] --save-exact
npm test

Issue	Symptom	Solution
Deprecated model	`400 model_not_found` or `400 model_decommissioned`	Replace with current model ID
Type errors after upgrade	TypeScript compilation fails	Check SDK changelog for type changes
Auth format change	`401` after upgrade	Verify constructor uses `apiKey`, not `key`
New required fields	`400` on previously working requests	Check API docs for parameter changes

groq-upgrade-migration

Groq Upgrade & Migration

Current State

Overview

Model Deprecation Timeline

Related Skills

skill-creator

skill-creator

1password

himalaya

skill-creator

skill-creator

1password

himalaya

Groq Upgrade & Migration

Current State

Overview

Model Deprecation Timeline

Current Model IDs (Use These)

Instructions

Step 1: Check Current Version and Models

Step 2: Upgrade SDK

Step 3: Find and Replace Deprecated Models

Step 4: Run Migration Scanner

Step 5: Validate and Test

Step 6: Rollback If Needed

SDK Changelog Highlights

Error Handling

Resources

Next Steps

Related Skills

skill-creator

skill-creator

1password

himalaya

Related Skills

skill-creator

skill-creator

1password

himalaya