Voice Isolator quickstart

We’ll also use the dotenv library to load our API key from an environment variable.

pip install elevenlabs
pip install python-dotenv

Install the ElevenLabs CLI. Homebrew (macOS) and Scoop (Windows) are recommended.

Homebrew (macOS)

brew install elevenlabs/tap/elevenlabs

Scoop (Windows)

scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs

npm

npm install -g @elevenlabs/cli

curl

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh

Working with an AI coding assistant? Run elevenlabs generate-skills in your project to write a SKILL.md for every command group into skills/, so your assistant knows the CLI's full surface without you pasting docs. Use --output-dir to put them elsewhere. This reads the CLI's own embedded API definition, so it needs no API key and works offline — and it stays in step with whichever CLI version you have installed.

Then authenticate — this opens your browser to authorize the CLI:

elevenlabs auth login

Create a new file named example.py or example.mts, depending on your language of choice and add the following code:

# example.py
import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import requests
from io import BytesIO

load_dotenv()

elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)

audio_url = "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/voice_with_background.mp3"
response = requests.get(audio_url)
audio_data = BytesIO(response.content)

audio_stream = elevenlabs.audio_isolation.convert(audio=audio_data)

play(audio_stream)

Then run it:

python example.py

You should hear the isolated voice playing through your speakers.

Download the sample audio, then isolate the voice:

curl -O https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/voice_with_background.mp3

elevenlabs audio-isolation convert \
  --audio voice_with_background.mp3 \
  --output isolated.mp3

Open isolated.mp3 to hear the isolated voice.