Back to Runanywhere Sdks

@runanywhere/web-onnx

sdk/runanywhere-web/packages/onnx/README.md

0.20.112.0 KB
Original Source

@runanywhere/web-onnx

The independent ONNX Runtime and Sherpa-ONNX backend for the RunAnywhere Web SDK. It provides embeddings, Speech-to-Text, Text-to-Speech, and Voice Activity Detection through the public RunAnywhere facade.

This browser package integrates with core only through @runanywhere/web/backend; it does not depend on the llama.cpp backend or core's private /internal entrypoint.

Install and initialize

bash
npm install @runanywhere/web @runanywhere/web-onnx
ts
import { RunAnywhere, SDKEnvironment } from '@runanywhere/web';
import { ONNX } from '@runanywhere/web-onnx';

await RunAnywhere.initialize({
  environment: SDKEnvironment.SDK_ENVIRONMENT_DEVELOPMENT,
});
await ONNX.register();

// Register/download/load compatible models through RunAnywhere first.
const transcript = await RunAnywhere.transcribe(audioSamples, {
  sampleRate: 16_000,
});
await RunAnywhere.speak('Speech synthesized locally in the browser.');

Capabilities

  • Whisper and other Sherpa-compatible STT models, including batch and streamed partial/final results.
  • Piper/Sherpa-compatible TTS synthesis and browser playback.
  • Silero/Sherpa-compatible VAD.
  • ONNX embeddings used by the cross-backend Web RAG provider.

Artifact

The package ships one self-contained pair:

text
wasm/racommons-onnx-sherpa.{js,wasm}

It includes the required ONNX and Sherpa registration exports and owns its native module lifetime. It does not reuse the core or llama.cpp WASM module. Configure your bundler to retain package-relative import.meta.url resolution. Vite users should exclude @runanywhere/web-onnx from dependency pre-bundling.

Build and verify from sdk/runanywhere-web:

bash
npm run build:wasm -- --onnx
npm run build -w packages/onnx
npm run verify:package -w packages/onnx

This is a browser-bundler package, not a server-side Node.js inference runtime.

License

Copyright (c) 2025 RunAnywhere, Inc. See the included LICENSE file for the custom RunAnywhere License.