Skip to content

Commit

Permalink
docs: update README description
Browse files Browse the repository at this point in the history
  • Loading branch information
JacobLinCool committed Jan 6, 2024
1 parent fe0c4c9 commit 785664d
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 5 deletions.
32 changes: 27 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,28 @@
# smart-whisper

Whisper.cpp Node.js binding with auto model offloading.
Smart-Whisper is a native Node.js addon designed for efficient and streamlined interaction with the [whisper.cpp](https://github.com/ggerganov/whisper.cpp), with automatic model offloading and reloading and model manager.

## Features

- [x] Directly interact with whisper.cpp as Node.js native addon
- [x] Load model once, run inference multiple times
- [x] Auto model offloading and reloading
- [x] Model manager to automatically download and update models
- **Node.js Native Addon Interaction**: Directly interact with whisper.cpp, ensuring fast and efficient processing.
- **Single Model Load for Multiple Inferences**: Load the model once and perform multiple and parallel inferences, optimizing resource usage and reducing load times.
- **Automatic Model Offloading and Reloading**: Manages memory effectively by automatically offloading and reloading models as needed.
- **Model Manager**: Automates the process of downloading and updating models, ensuring that the latest models are always available.

## Installation

```sh
npm i smart-whisper
```

## Documentation

The documentation is available at <https://jacoblincool.github.io/smart-whisper/>.

## Example

See [examples](./examples) for more examples.

```ts
import { Whisper } from "smart-whisper";
import { decode } from "node-wav";
Expand Down Expand Up @@ -41,3 +53,13 @@ function read_wav(file: string): Float32Array {
return channelData[0];
}
```

## Links

- [GitHub Repository](https://github.com/JacobLinCool/smart-whisper)
- [NPM Package](https://www.npmjs.com/package/smart-whisper)
- [Documentation](https://jacoblincool.github.io/smart-whisper/)

## License

[MIT](./LICENSE)
4 changes: 4 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,10 @@
"type": "git",
"url": "git+https://github.com/JacobLinCool/smart-whisper.git"
},
"homepage": "https://jacoblincool.github.io/smart-whisper/",
"bugs": {
"url": "https://github.com/JacobLinCool/smart-whisper/issues"
},
"lint-staged": {
"*.{ts,js,json,yaml,yml}": [
"prettier --write"
Expand Down

0 comments on commit 785664d

Please sign in to comment.