# Stream ASR — 100% On-Device Streaming Speech Recognition

> Ultra-fast, browser-native WebAssembly streaming speech recognition runtime powered by MNN & SIMD128. Zero cloud dependencies, zero audio uploaded to any server, fully offline-ready.

## About
- Site: https://asr.firetable.tech
- GitHub: https://github.com/firetable/stream-asr
- Package: `@firetable/stream-asr`
- Author: FireTable
- License: Apache-2.0
- Architecture: WebAssembly + SIMD128 + Web Workers + AudioWorklet

## Key Capabilities
- **Sub-50ms Chunk Latency**: Real-time acoustic processing with immediate text output as the user speaks.
- **100% Client-Side Privacy**: Zero audio bytes uploaded to the cloud. All computation occurs locally on the user's hardware.
- **Full Offline Operation**: Browser CacheStorage caches model tensors and WASM binaries for instant subsequent boots without network access.
- **Hardware Acceleration**: SIMD128-vectorized MNN tensor kernels delivering RTF 0.12x on Apple Silicon and 0.28x on modern x86_64.
- **Lightweight Footprint**: ~175MB quantized model weights with < 250MB peak memory during live recognition.

## Quick Start (TypeScript / JavaScript)
```bash
npm install @firetable/stream-asr
```

```typescript
import { StreamRecognizer } from '@firetable/stream-asr';

const recognizer = new StreamRecognizer({
  modelPath: '/model.bin',
  sampleRate: 16000,
});

recognizer.on('download_progress', (e) => {
  console.log(`Downloading: ${e.percent}% (${e.loaded}/${e.total} bytes)`);
});

recognizer.on('ready', () => {
  console.log('Engine ready for live audio streaming');
});

recognizer.on('result', (e) => {
  console.log(`[Text] ${e.text} (isFinal: ${e.isFinal})`);
});

await recognizer.init();

// Stream 16kHz Float32 PCM chunks from Web Audio API
recognizer.feed(pcmFloat32Array);
```

## System Requirements
- Modern Chromium-based browser (Chrome, Edge 90+)
- Safari 16.4+ (iOS & macOS)
- Firefox 90+
- WebAssembly with SIMD128 support

## Resources & Links
- [Interactive SoundLab Studio](https://asr.firetable.tech/#hero)
- [Architecture & Benchmarks](https://asr.firetable.tech/#features)
- [Quick Start Guide](https://asr.firetable.tech/#cta)
- [Full LLM Knowledge Base](https://asr.firetable.tech/llms-full.txt)
- [Agent Auth Policy](https://asr.firetable.tech/auth.md)