/setup-elevenlabs.en

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Browser available", "Have an email or Google/GitHub account"]
level: "beginner"
tags: ["setup", "elevenlabs", "api", "tts", "voice"]
nonInteractiveMode: incompatible

ElevenLabs API Setup

Step 0: Check Setup Progress

**What the AI auto-runs:** 1. Run `uv run python tools/setup_progress.py show --current setup-elevenlabs` to display progress 2. Auto-detect existing API key:

• Run `uv run python tools/credential_manager.py status`
• If ELEVENLABS_API_KEY (or ELEVEN_API_KEY) is already set, you can just run Step 4 (API test) and mark it as complete
• If a plaintext key exists in `.env`, suggest migrating it to the credential store

What You'll Do in This Session

| Item | Details | |------|---------| | Goal | Get an API key from ElevenLabs and save it to the Credential Store so you can use text-to-speech (TTS) and voice synthesis features | | Duration | ~10 minutes | | Prerequisites | An email address or Google/GitHub account, and a browser available | | Skill Level | No CLI commands needed (everything is auto-run by AI + GUI operations only) |

**Use cases:** ElevenLabs is an AI voice synthesis (TTS) service. It supports text-to-speech, voice cloning, and multilingual voice synthesis, used for generating video narration and more.

**About costs:** The free plan allows up to 10,000 characters per month. This is more than enough for training-level usage.

**Session flow:** 1. Open ElevenLabs in the browser (AI opens the browser automatically) 2. Create an account / log in (sign up via Google/GitHub authentication) 3. Get your API key (just copy it from the settings page) 4. Save to the Credential Store (run a command in a separate terminal) 5. Functionality test (AI runs automatically)

> **Hint**: If the AI's response stops midway, type "please continue" or "it stopped" to resume.

---

Readiness Check

**AskQuestion configuration:**

{
  "title": "Pre-session confirmation",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Ready! Let's start"},
      {"id": "chrome", "label": "Automate browser operations with /chrome"},
      {"id": "check_prereq", "label": "I want to check the prerequisites"},
      {"id": "different_lesson", "label": "I want to go to a different lesson"}
    ]
  }]
}

(ready -> Proceed to Step 1) (chrome -> After opening the browser in Step 1, follow the "Automating with Chrome integration" section for automatic execution) (check_prereq -> Guide: "You're good to go if you have an email address or a Google/GitHub account. The free plan allows up to 10,000 characters per month.") (different_lesson -> Display module list)

---

Step 1: Open ElevenLabs in the Browser

**What the AI does:** 1. Auto-detect the OS (Mac / Windows / Linux) 2. Run the following command to open the browser automatically:

# Mac:
open https://elevenlabs.io
# Windows:
start https://elevenlabs.io
# Linux:
xdg-open https://elevenlabs.io

**After the browser opens, display the following AskQuestion:**

{
  "title": "Step 1: Sign up / Log in to ElevenLabs",
  "questions": [{
    "id": "signup_status",
    "prompt": "Did the browser open? Follow these steps to create your account:\n\n1. Click 'Sign up' in the top right (or 'Log in' if you already have an account)\n2. Sign up with Google / GitHub authentication, or with your email address\n3. Once logged in, proceed to the next step\n\nAre you logged in?",
    "options": [
      {"id": "logged_in", "label": "I'm logged in!"},
      {"id": "browser_not_open", "label": "The browser didn't open"},
      {"id": "signup_issue", "label": "I'm having trouble signing up"},
      {"id": "already_have_key", "label": "I already have an API key"}
    ]
  }]
}

(logged_in -> Proceed to Step 2) (browser_not_open -> Guide: "Open this URL directly in your browser: https://elevenlabs.io") (signup_issue -> Guide: "Google authentication is the easiest. Click Sign up in the top right -> Continue with Google. If that doesn't work, try signing up with your email address.") (already_have_key -> Skip to Step 3)

---

Automating with Chrome Integration (`/chrome` mode)

**Prerequisite:** The "Claude in Chrome" extension (v1.0.36+) must be installed in Chrome, and you must have launched with `claude --chrome` or run `/chrome` in the session.

**What the AI auto-runs with Chrome integration:** 1. Open https://elevenlabs.io in the browser 2. Use Chrome integration to perform the following operations in order:

• Click "Sign up" or "Log in"
• Authenticate with Google, GitHub, or email (wait for user's action)
• After login, navigate to https://elevenlabs.io/app/settings/api-keys
• If there's an existing key, leave it as is; otherwise click "Create API Key"

3. Once the API key is displayed, tell the user "Click the copy button next to the API key to copy it" 4. Proceed to Step 3

**Note:** Do not read the API key value from the browser screen. The user copies it manually.

If Chrome integration is not available, follow the steps below manually.

---

Step 2: Get Your API Key

**What the AI does:** 1. Open the API key page in the browser:

# Mac:
open https://elevenlabs.io/app/settings/api-keys
# Windows:
start https://elevenlabs.io/app/settings/api-keys
# Linux:
xdg-open https://elevenlabs.io/app/settings/api-keys

**After the browser opens, display the following AskQuestion:**

{
  "title": "Step 2: Get your API key",
  "questions": [{
    "id": "key_status",
    "prompt": "Did the API key settings page open? Follow these steps to get your API key:\n\n1. Confirm the API Keys page is displayed\n2. If there's an existing key, click the copy icon\n3. If not, click 'Create API Key' to create a new one\n4. Copy the displayed API key\n\nDid you copy the API key?",
    "options": [
      {"id": "copied", "label": "I copied the API key!"},
      {"id": "