---

name: deepgram-install-auth description: | 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". 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

• Deepgram Documentation
• Deepgram Console
• Deepgram API Reference

Next Steps

After successful auth, proceed to deepgram-hello-world for your first transcription.