wispr-reference-architecture

by jeremylongshore

Install this Skill

curl -fsSL -o wispr-reference-architecture.zip https://skill.seembox.com/api/v1/skills/wispr-reference-architecture/download && unzip wispr-reference-architecture.zip

Download wispr-reference-architecture.zip

SKILL.md About

---
name: wispr-reference-architecture
description: 'Wispr Flow reference architecture for voice-to-text API integration.

Use when integrating Wispr Flow dictation, WebSocket streaming,

or building voice-powered applications.

Trigger: "wispr reference architecture".

'
allowed-tools: Read, Write, Edit, Bash(npm:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- voice
- dictation
- wispr
compatibility: Designed for Claude Code
---
# Wispr Flow Reference Architecture

## Overview

Guidance for reference architecture 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](https://wisprflow.ai/developers)
- [API Docs](https://api-docs.wisprflow.ai/introduction)
- [WebSocket Quickstart](https://api-docs.wisprflow.ai/websocket_quickstart)

## Next Steps

See related Wispr Flow skills for more patterns.