groq-upgrade-migration

# 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 `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` | — | `whisper-large-v3-turbo` | ## Current Model IDs (Use These) | 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...