Setting the file. One moment.
Subchapter 7.1
references/installation.mdMarkdown3 KBView on GitHub
# macOS / Linux (Homebrew)
brew install elevenlabs/tap/elevenlabs# Windows (Scoop)
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs# Shell installer (macOS / Linux)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | shAuthenticate with either method:
# Option 1: Environment variable (picked up automatically)
export ELEVENLABS_API_KEY="your-api-key"
# Option 2: OAuth login (stores credentials in the OS keyring)
elevenlabs auth loginnpm install @elevenlabs/elevenlabs-js@latestImportant: Always use
@elevenlabs/elevenlabs-js. The oldelevenlabsnpm package (v1.x) is deprecated and should not be used.
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
// Option 1: Environment variable (recommended)
// Set ELEVENLABS_API_KEY in your environment
const client = new ElevenLabsClient();
// Option 2: Pass directly
const client = new ElevenLabsClient({ apiKey: "your-api-key" });If you have old packages installed, remove them:
# Remove deprecated packages
npm uninstall elevenlabs
# Install the current packages
npm install @elevenlabs/elevenlabs-js@latest
# For client-side/browser usage, also install:
npm install @elevenlabs/client@latest # Browser client
npm install @elevenlabs/react@latest # React hooksImport changes:
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import { Scribe } from "@elevenlabs/client";
import { useScribe } from "@elevenlabs/react";pip install --upgrade elevenlabsfrom elevenlabs import ElevenLabs
# Option 1: Environment variable (recommended)
# Set ELEVENLABS_API_KEY in your environment
client = ElevenLabs()
# Option 2: Pass directly
client = ElevenLabs(api_key="your-api-key")The CLI reads ELEVENLABS_API_KEY automatically — no key flags or headers needed:
elevenlabs speech-to-text convert --file audio.mp3 --model-id scribe_v2Or use the setup-api-key skill for guided setup.
| Variable | Description |
|---|---|
ELEVENLABS_API_KEY | Your ElevenLabs API key (required) |