AssemblyAI Install & Auth

Overview

Install the assemblyai npm package and configure API key authentication for transcription, LeMUR, and streaming APIs.

Prerequisites

• Node.js 18+ or Python 3.10+
• Package manager (npm, pnpm, yarn, or pip)
• AssemblyAI account — sign up at https://www.assemblyai.com/dashboard/signup
• API key from https://www.assemblyai.com/app/account

Instructions

Step 1: Install the SDK

# Node.js (official SDK)
npm install assemblyai

# Python
pip install assemblyai

Step 2: Configure API Key

# Set environment variable (recommended)
export ASSEMBLYAI_API_KEY="your-api-key-here"

# Or add to .env file
echo 'ASSEMBLYAI_API_KEY=your-api-key-here' >> .env

Add to .gitignore:

.env
.env.local
.env.*.local

Step 3: Initialize the Client

// src/assemblyai/client.ts
import { AssemblyAI } from 'assemblyai';

const client = new AssemblyAI({
  apiKey: process.env.ASSEMBLYAI_API_KEY!,
});

export default client;

Step 4: Verify Connection

// verify-connection.ts
import { AssemblyAI } from 'assemblyai';

const client = new AssemblyAI({
  apiKey: process.env.ASSEMBLYAI_API_KEY!,
});

async function verify() {
  // Transcribe a short public audio to confirm everything works
  const transcript = await client.transcripts.transcribe({
    audio: 'https://storage.googleapis.com/aai-web-samples/5_common_sports_702.wav',
  });

  if (transcript.status === 'error') {
    console.error('Transcription failed:', transcript.error);
    process.exit(1);
  }

  console.log('Connection verified. Transcript ID:', transcript.id);
  console.log('Status:', transcript.status);
  console.log('Text preview:', transcript.text?.slice(0, 100));
}

verify().catch(console.error);