Debug & Troubleshooting

Common Issues & Fixes

1. WASM/ONNX Model Loading Fails

Symptoms: Failed to load model, RuntimeError: memory access out of bounds Fixes:

• Verify model files exist in client/public/models/
• Check Content-Type is served as application/wasm (Vite does this automatically)
• Use exact version: onnxruntime-web@1.19.0 — newer versions break WebGPU
• If WebGPU unavailable, fallback to WASM execution provider:

const session = await ort.InferenceSession.create(modelPath, {
  executionProviders: ['webgpu', 'wasm'], // Fallback chain
});