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.