deepgram-install-auth
Install and configure Deepgram SDK/CLI authentication.Use when setting up a new Deepgram integration, configuring API keys,or initializing Deepgram in your project.Trigger with phrases like "install deepgram", "setup deepgram","deepgram auth", "configure deepgram API key".
When & Why to Use This Skill
The Deepgram Install & Auth skill is a specialized developer utility designed to automate the setup and authentication process for Deepgram's speech-to-text API. It streamlines the integration workflow by handling SDK installation for both Node.js and Python environments, managing API key configuration via environment variables, and performing immediate connection verification to ensure a functional development environment.
Use Cases
- Rapidly bootstrapping a new AI project that requires high-quality audio transcription or voice-to-text capabilities.
- Automating the configuration of Deepgram credentials and SDKs across different local development environments or CI/CD pipelines.
- Troubleshooting integration issues by performing automated connection checks to verify API key validity and network access to Deepgram servers.
- Standardizing the setup process for developers switching between Node.js and Python implementations of Deepgram services.
| name | deepgram-install-auth |
|---|---|
| description | | |
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
Deepgram Install & Auth
Overview
Set up Deepgram SDK and configure authentication credentials for speech-to-text services.
Prerequisites
- Node.js 18+ or Python 3.10+
- Package manager (npm, pnpm, or pip)
- Deepgram account with API access
- API key from Deepgram Console (https://console.deepgram.com)
Instructions
Step 1: Install SDK
# Node.js
npm install @deepgram/sdk
# Python
pip install deepgram-sdk
Step 2: Configure Authentication
# Set environment variable
export DEEPGRAM_API_KEY="your-api-key"
# Or create .env file
echo 'DEEPGRAM_API_KEY=your-api-key' >> .env
Step 3: Verify Connection
import { createClient } from '@deepgram/sdk';
const deepgram = createClient(process.env.DEEPGRAM_API_KEY);
const { result, error } = await deepgram.manage.getProjects();
console.log(error ? 'Failed' : 'Connected successfully');
Output
- Installed SDK package in node_modules or site-packages
- Environment variable or .env file with API key
- Successful connection verification output
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Invalid API Key | Incorrect or expired key | Verify key in Deepgram Console |
| 401 Unauthorized | API key not set | Check environment variable is exported |
| Network Error | Firewall blocking | Ensure outbound HTTPS to api.deepgram.com |
| Module Not Found | Installation failed | Run npm install or pip install again |
Examples
TypeScript Setup
import { createClient } from '@deepgram/sdk';
const deepgram = createClient(process.env.DEEPGRAM_API_KEY);
// Verify connection
async function verifyConnection() {
const { result, error } = await deepgram.manage.getProjects();
if (error) throw error;
console.log('Projects:', result.projects);
}
Python Setup
from deepgram import DeepgramClient
import os
deepgram = DeepgramClient(os.environ.get('DEEPGRAM_API_KEY'))
# Verify connection
response = deepgram.manage.get_projects()
print(f"Projects: {response.projects}")
Resources
Next Steps
After successful auth, proceed to deepgram-hello-world for your first transcription.