Skip to main content
skill CX Codex

speak-install-auth — Claude Code skill: Speak API setup and auth

speak-install-auth — a skill to integrate Speak, an AI language tutoring platform powered by GPT-4o and OpenAI Realtime. Configures API credentials, speech recognition, and prepares your environment to run lessons across 14+ languages.

MIT 1 installs ★ 2,935 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-install-auth -a claude-code
Open on GitHub

What speak-install-auth does

The skill installs the Speak SDK alongside speech processing dependencies (openai, fluent-ffmpeg, node-record-lpcm16), sets environment variables for SPEAK_API_KEY, SPEAK_APP_ID, and OPENAI_API_KEY, initializes a Speak client, and verifies connectivity. OpenAI Realtime API handles real-time transcription; Speak handles language-specific tutor logic and pronunciation feedback.

Supported languages include Korean, Spanish, Japanese, French, German, Portuguese, Mandarin, English, and Indonesian. Requires Node.js 18+ or Python 3.10+, an active microphone for speech testing, and valid credentials in both the Speak and OpenAI dashboards.

What it helps with

  • integrate Speak API into a Node.js or Python project
  • configure OpenAI Realtime for speech-to-text pipelines
  • initialize a Speak language client with your target language
  • verify API connectivity and list available languages
  • prepare the environment for AI tutoring sessions

Example prompts for the agent

  • install speak and set up the API keys
  • connect Speak to my project with Korean language support
  • check Speak API access and show me available languages

How to install speak-install-auth

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-install-auth -a claude-code

2Manually: put the files in place

~/.claude/skills/speak-install-auth/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/speak-install-auth/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about speak-install-auth

How do I install speak-install-auth in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill speak-install-auth -a claude-code, then open ~/.claude/skills/speak-install-auth/SKILL.md.

What does speak-install-auth do?

It installs the Speak SDK and audio libraries, sets up environment variables for API credentials, initializes a Speak client, and runs a health check to confirm service access and list supported languages.

What credentials do I need?

You need SPEAK_API_KEY and SPEAK_APP_ID from your Speak developer dashboard, plus OPENAI_API_KEY from OpenAI — Speak uses it to power real-time speech recognition through the Realtime API.

Source text

SKILL.md · MIT
---
name: speak-install-auth
description: 'Set up Speak language learning API integration and authentication.

  Use when configuring Speak API access, setting up OAuth with OpenAI

  Realtime API for speech, or initializing a language tutoring application.

  Trigger with phrases like "install speak", "setup speak",

  "speak auth", "configure speak API", "speak language learning setup".

  '
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version: 1.14.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- speak
- api
- authentication
compatibility: Designed for Claude Code
---
# Speak Install & Auth

## Overview

Set up the Speak language learning platform integration. Speak uses OpenAI's GPT-4o and Realtime API for AI tutoring with real-time pronunciation feedback. Supports 14+ languages including Korean, Spanish, Japanese, French, and Mandarin.

## Prerequisites

- Node.js 18+ or Python 3.10+
- Speak developer account with API access
- Microphone for speech input testing

## Instructions

### Step 1: Install Dependencies

```bash
set -euo pipefail
# Core Speak SDK
npm install @speak/language-sdk

# Audio processing dependencies
npm install openai          # OpenAI Realtime API for speech
npm install fluent-ffmpeg   # Audio format conversion
npm install node-record-lpcm16  # Microphone capture
```

### Step 2: Configure Authentication

```bash
# Speak API credentials
export SPEAK_API_KEY="your-speak-api-key"
export SPEAK_APP_ID="your-app-id"

# OpenAI key for Realtime API (used by Speak for speech processing)
export OPENAI_API_KEY="your-openai-key"

# Create .env file
cat << 'EOF' >> .env
SPEAK_API_KEY=your-speak-api-key
SPEAK_APP_ID=your-app-id
OPENAI_API_KEY=your-openai-key
EOF
```

### Step 3: Initialize the Client

```typescript
// src/speak/client.ts
import { SpeakClient } from '@speak/language-sdk';

const client = new SpeakClient({
  apiKey: process.env.SPEAK_API_KEY!,
  appId: process.env.SPEAK_APP_ID!,
  language: 'es', // Target language: es, ko, ja, fr, de, pt, zh, id
});

// Verify connection
async function verifySetup() {
  const languages = await client.getLanguages();
  console.log('Available languages:', languages.map(l => l.code).join(', '));
  const health = await client.health.check();
  console.log('API status:', health.status);
}

verifySetup();
```

### Step 4: Configure Speech Recognition

```typescript
// OpenAI Realtime API for speech-to-text (used by Speak)
import OpenAI from 'openai';

const openai = new OpenAI();

async function transcribeAudio(audioPath: string): Promise<string> {
  const transcription = await openai.audio.transcriptions.create({
    file: fs.createReadStream(audioPath),
    model: 'whisper-1',
    language: 'es', // Match target language
  });
  return transcription.text;
}
```

### Step 5: Supported Languages

| Language | Code | Pronunciation | Conversation |
|----------|------|--------------|-------------|
| Korean | ko | Yes | Yes |
| Spanish | es | Yes | Yes |
| Japanese | ja | Yes | Yes |
| French | fr | Yes | Yes |
| German | de | Yes | Yes |
| Portuguese (BR) | pt | Yes | Yes |
| Mandarin (Simplified) | zh-CN | Yes | Yes |
| English | en | Yes | Yes |
| Indonesian | id | Yes | Yes |

## Output

- Speak SDK installed and configured
- API key and OpenAI credentials set
- Language support verified
- Speech recognition pipeline ready

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| Invalid API Key | Wrong or expired key | Verify at developer.speak.com dashboard |
| App ID Mismatch | Wrong application ID | Check app settings in Speak dashboard |
| OpenAI auth failed | Invalid OpenAI key | Verify at platform.openai.com |
| Module not found | Installation failed | Run `npm install` again |
| Language not supported | Invalid language code | Use codes from supported languages table |

## Resources

- [Speak Website](https://speak.com)
- [OpenAI Realtime API](https://platform.openai.com/docs/guides/realtime)
- [OpenAI Whisper](https://platform.openai.com/docs/guides/speech-to-text)
- [Speak Blog: GPT-4 Integration](https://speak.com/blog/speak-gpt-4)

## Next Steps

After successful auth, proceed to `speak-hello-world` for your first lesson session.

## Examples

**Quick test**: Set `SPEAK_API_KEY`, initialize the client with `language: 'ko'` for Korean, and call `client.health.check()` to verify connectivity.

**Python setup**: Install `speak-language-sdk` via pip, initialize with `api_key` from environment, and verify with a health check.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for Backend and APIs →

From the same set139

The whole set →
deepgram-core-workflow-b The deepgram-core-workflow-b skill outlines real-time transcription with Deepgram over WebSocket. Use it when adding live captions, voice controls, or speech features to an app. CX Codex +1 1installs code-documentation-analyzer Auto-activating skill for auditing code documentation: API references, user guides, architecture docs. Triggers on phrases like "code documentation analyzer" or "code analyzer". CX Codex +1 1installs retellai-policy-guardrails retellai-policy-guardrails sets boundaries and tool limits for Retell AI phone voice agents. Useful when you need reliable call workflows with human handoffs. CX Codex +1 1installs openevidence-deploy-integration openevidence-deploy-integration plans an OpenEvidence rollout for a clinical workflow, covering the pilot, staff training, governance checks, and rollback conditions. CX Codex +1 1installs speak-migration-deep-dive speak-migration-deep-dive migrates language learning platforms to Speak, imports student progress, and configures the @speak/language-sdk client. CX Codex +1 1installs lokalise-core-workflow-a lokalise-core-workflow-a — a Claude Code skill for the source-to-Lokalise direction: uploading translation files, creating and editing keys. Also runs in Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 1installs api-contract Generates an api-contract.md file that backend and frontend agents read as one shared interface. No back-and-forth needed during a sprint. CX Codex +1 1installs openrouter-cost-controls openrouter-cost-controls sets hard budget caps and tracks OpenRouter API spending across keys to prevent accidental balance drain. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open