Xenova HF staff commited on
Commit
7497824
β€’
1 Parent(s): e911bb0

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +50 -3
README.md CHANGED
@@ -1,12 +1,59 @@
1
  ---
2
  title: Moonshine Web
3
- emoji: πŸ“ˆ
4
  colorFrom: blue
5
- colorTo: blue
6
  sdk: static
7
  pinned: false
8
  license: apache-2.0
 
 
9
  short_description: Real-time in-browser speech recognition
 
10
  ---
11
 
12
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  title: Moonshine Web
3
+ emoji: πŸŒ™
4
  colorFrom: blue
5
+ colorTo: pink
6
  sdk: static
7
  pinned: false
8
  license: apache-2.0
9
+ models:
10
+ - onnx-community/moonshine-base-ONNX
11
  short_description: Real-time in-browser speech recognition
12
+ thumbnail: https://huggingface.co/spaces/webml-community/moonshine-web/resolve/main/banner.png
13
  ---
14
 
15
+ # Moonshine Web
16
+
17
+ A simple React + Vite application for running [Moonshine Base](https://huggingface.co/onnx-community/moonshine-base-ONNX), a powerful speech-to-text model optimized for fast and accurate automatic speech recognition (ASR) on resource-constrained devices. It runs locally in the browser using Transformers.js and WebGPU-acceleration (or WASM as a fallback).
18
+
19
+ ## Getting Started
20
+
21
+ Follow the steps below to set up and run the application.
22
+
23
+ ### 1. Clone the Repository
24
+
25
+ Clone the examples repository from GitHub:
26
+
27
+ ```sh
28
+ git clone https://github.com/huggingface/transformers.js-examples.git
29
+ ```
30
+
31
+ ### 2. Navigate to the Project Directory
32
+
33
+ Change your working directory to the `moonshine-web` folder:
34
+
35
+ ```sh
36
+ cd transformers.js-examples/moonshine-web
37
+ ```
38
+
39
+ ### 3. Install Dependencies
40
+
41
+ Install the necessary dependencies using npm:
42
+
43
+ ```sh
44
+ npm i
45
+ ```
46
+
47
+ ### 4. Run the Development Server
48
+
49
+ Start the development server:
50
+
51
+ ```sh
52
+ npm run dev
53
+ ```
54
+
55
+ The application should now be running locally. Open your browser and go to `http://localhost:5173` to see it in action.
56
+
57
+ ## Acknowledgements
58
+
59
+ The audio visualizer was adapted from Wael Yasmina's [amazing tutorial](https://waelyasmina.net/articles/how-to-create-a-3d-audio-visualizer-using-three-js/).