deepgram-migration-deep-dive
Deep dive into complex Deepgram migrations and provider transitions. Use when migrating from other transcription providers, planning large-scale migrations, or implementing phased rollout strategies. Trigger with phrases like "deepgram migration", "switch to deepgram", "migrate transcription", "deepgram from AWS", "deepgram from Google".
- License 许可
- MIT
- 最近更新
- 2026-05-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- deepgram-migration-deep-dive
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- license
- MIT
- version
- 1.0.0
- description
- Deep dive into complex Deepgram migrations and provider transitions. Use when migrating from other transcription providers, planning large-scale migrations, or implementing phased rollout strategies. Trigger with phrases like "deepgram migration", "switch to deepgram", "migrate transcription", "deepgram from AWS", "deepgram from Google".
- allowed-tools
- Read, Write, Edit, Bash(kubectl:*), Bash(curl:*)
- compatible-with
- claude-code, codex, openclaw
02 资源文件 1
- 参考文档references/implementation.md5.0 KB
03 SKILL.md 正文
Deepgram Migration Deep Dive
Table of Contents
Overview
Comprehensive guide for migrating to Deepgram from other transcription providers (AWS Transcribe, Google Cloud STT, Azure Speech, OpenAI Whisper, Rev.ai, AssemblyAI) using an adapter pattern with parallel running and gradual traffic shifting.
Prerequisites
- Current provider SDK and credentials
- Deepgram API key and project configured
- Test audio dataset for comparison
- Monitoring infrastructure ready
Instructions
Step 1: Assessment
Audit current usage (hours/month, features), map features to Deepgram equivalents, and estimate costs.
Step 2: Implement Adapter Pattern
Create a TranscriptionAdapter interface with transcribe() and transcribeFile() methods, then implement both the legacy adapter and DeepgramAdapter.
Step 3: Build Migration Router
Create a MigrationRouter that routes traffic by percentage (0-100%) between providers, with optional parallel comparison mode.
Step 4: Parallel Running & Validation
Run both providers simultaneously, compare results using Jaccard similarity, and verify accuracy meets >= 90% threshold.
Step 5: Gradual Rollout
Shift traffic incrementally: 5% -> 25% (monitor 1 week) -> 50% (monitor 1 week) -> 100%.
Step 6: Cutover & Cleanup
Complete migration, decommission old provider, update documentation.
Output
- TranscriptionAdapter interface and implementations
- MigrationRouter with percentage-based routing
- Validation script with similarity scoring
- Feature mapping tables (AWS/Google -> Deepgram)
- Rollback manager with checkpoint/restore
Error Handling
| Issue | Cause | Resolution |
|---|---|---|
| Low similarity scores | Feature mismatch | Check feature mapping, adjust options |
| Deepgram latency higher | Cold start or model | Pre-warm connections, verify model selection |
| Missing features | Incomplete mapping | Use Deepgram keywords for custom vocabulary |
| Rollback needed | Quality regression | Call emergencyRollback() to set percentage to 0% |
Examples
Feature Mapping (AWS -> Deepgram)
LanguageCode: en-US->language: "en"(ISO 639-1)ShowSpeakerLabels: true->diarize: trueVocabularyName: custom->keywords: ["term:1.5"]ContentRedaction->redact: ["pci", "ssn"]
Migration Checklist
Pre-migration, validation phase, rollout phase (5% -> 25% -> 50% -> 100%), post-migration cleanup.
See detailed implementation for advanced patterns.
Resources
04 同仓库更多 Skills
zustand-store-ts
Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.
zustand-store-creator
Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.
zero-trust-config-helper
Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.
zapier-integration-helper
Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.
zai-cli
Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.
yt-research
Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.