Wispr Flow Ci Integration

Overview

Guidance for ci integration with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Common Errors

Overview

Guidance for common errors with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Core Workflow A

Overview

Guidance for core workflow a with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Core Workflow B

Overview

Guidance for core workflow b with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Cost Tuning

Overview

Guidance for cost tuning with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Debug Bundle

Overview

Guidance for debug bundle with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Deploy Integration

Overview

Guidance for deploy integration with Wispr Flow voice-to-text API.

Instructions

Key Wispr Flow Concepts

• WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
• REST API: POST /api/v1/transcribe (simpler, higher latency)
• Auth: API key (backend) or access token (client-side)
• Audio format: 16kHz mono PCM preferred
• Context awareness: Understands code, CLI commands, dev jargon
• Platforms: Mac, Windows, iOS, browser API

Error Handling

Resources

• Wispr Flow Developers
• API Docs
• WebSocket Quickstart

Next Steps

See related Wispr Flow skills for more patterns.

Wispr Flow Hello World

Overview

Stream audio to Wispr Flow and receive real-time transcription. Wispr specializes in developer-context-aware dictation -- it understands code terms, CLI commands, and technical jargon.

Instructions

Step 1: Record and Transcribe (REST)

import requests, os

# Transcribe an audio file
with open("voice-memo.wav", "rb") as audio:
    response = requests.post(
        "https://api.wisprflow.ai/api/v1/transcribe",
        headers={"Authorization": f"Bearer {os.environ['WISPR_API_KEY']}"},
        files={"audio": audio},
        data={"language": "en", "context": "programming"},
    )

result = response.json()
print(f"Text: {result['text']}")
print(f"Confidence: {result.get('confidence', 'N/A')}")

Step 2: Real-Time Streaming (WebSocket)

// Stream microphone audio to Wispr Flow
const ws = new WebSocket('wss://api.wisprflow.ai/api/v1/ws');

// Browser audio capture
const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
const context = new AudioContext({ sampleRate: 16000 });
const source = context.createMediaStreamSource(stream);

const processor = context.createScriptProcessor(4096, 1, 1);
source.connect(processor);
processor.connect(context.destination);

processor.onaudioprocess = (event) => {
  const audioData = event.inputBuffer.getChannelData(0);
  // Convert Float32Array to Int16Array for transmission
  const int16 = new Int16Array(audioData.length);
  for (let i = 0; i < audioData.length; i++) {
    int16[i] = Math.max(-32768, Math.min(32767, audioData[i] * 32768));
  }
  ws.send(int16.buffer);
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === 'partial') {
    console.log(`Partial: ${data.text}`);
  } else if (data.type === 'final') {
    console.log(`Final: ${data.text}`);
  }
};

Output

Partial: implement a function that
Final: Implement a function that calculates the Fibonacci sequence using dynamic programming.

Error Handling

Resources

• WebSocket Quickstart
• Wispr Flow for Developers

Next Steps

Proceed to wispr-local-dev-loop for development workflow

Wispr Flow Install & Auth

Overview

Configure Wispr Flow API for voice-to-text transcription. Supports WebSocket (recommended, lower latency) and REST endpoints. Auth via API key (backend) or access tokens (client-side).

Prerequisites

• Wispr Flow API access from wisprflow.ai/developers
• API key from developer dashboard
• Node.js 18+ or Python 3.8+

Instructions

Step 1: Configure API Key

# .env
WISPR_API_KEY=your-api-key-here
WISPR_API_URL=https://api.wisprflow.ai

Step 2: WebSocket Connection (Recommended)

const ws = new WebSocket('wss://api.wisprflow.ai/api/v1/ws', {
  headers: { Authorization: `Bearer ${process.env.WISPR_API_KEY}` },
});

ws.on('open', () => {
  // Send context for better transcription
  ws.send(JSON.stringify({
    type: 'config',
    context: { app: 'code-editor', language: 'en' },
  }));
  console.log('Connected to Wispr Flow');
});

ws.on('message', (data) => {
  const result = JSON.parse(data.toString());
  if (result.type === 'transcription') {
    console.log(`Transcript: ${result.text}`);
  }
});

Step 3: REST API (Simpler, Higher Latency)

import requests, os

response = requests.post(
    f"{os.environ['WISPR_API_URL']}/api/v1/transcribe",
    headers={"Authorization": f"Bearer {os.environ['WISPR_API_KEY']}"},
    files={"audio": open("recording.wav", "rb")},
    data={"language": "en"},
)
print(f"Transcript: {response.json()['text']}")

Step 4: Generate Client Access Token

// Backend: generate short-lived token for client use
const response = await fetch('https://api.wisprflow.ai/api/v1/auth/token', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WISPR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ expires_in: 3600 }), // 1 hour
});
const { access_token } = await response.json();
// Send access_token to client for direct WebSocket connection

Error Handling

Resources

• Wispr Flow Developers
• wispr-local-dev-loop SKILL.md View full skill →

  Wispr Flow local dev loop for voice-to-text API integration.

  ReadWriteEditBash(npm:*)Grep

  Wispr Flow Local Dev Loop

  Overview

  Guidance for local dev loop with Wispr Flow voice-to-text API.

  Instructions

  Key Wispr Flow Concepts

  • WebSocket API: wss://api.wisprflow.ai/api/v1/ws (recommended, low latency)
  • REST API: POST /api/v1/transcribe (simpler, higher latency)
  • Auth: API key (backend) or access token (client-side)
  • Audio format: 16kHz mono PCM preferred
  • Context awareness: Understands code, CLI commands, dev jargon
  • Platforms: Mac, Windows, iOS, browser API

  Error Handling

  Error	Cause	Solution
  401 Unauthorized	Invalid key	Check at wisprflow.ai/developers
  WebSocket closed	Network issue	Reconnect with backoff
  Poor accuracy	Wrong context	Set context to 'programming' for code

  Resources

  • Wispr Flow Developers
  • API Docs
  • WebSocket Quickstart

  Next Steps

  See related Wispr Flow skills for more patterns.