Skip to content

Commit

Permalink
updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
rahuldshetty committed Aug 7, 2023
1 parent dc43835 commit 73db96c
Show file tree
Hide file tree
Showing 13 changed files with 44 additions and 316 deletions.
39 changes: 30 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,36 @@
# ggml.js
<div align="center" style="display:flex; align-items:center;justify-content: center;background:#e1e1e1;color:#0f0f0f;padding:50px;">
<img alt="ggml.js logo" src="https://raw.githubusercontent.com/rahuldshetty/ggml.js/master/docs/_media/logo.png" width="350">
</div>

Run any [ggml](https://github.com/ggerganov/ggml.git) ported models directly from your browser with ggml.js
<p align="center">
<img alt="no-languages" src="https://img.shields.io/github/languages/count/rahuldshetty/ggml.js?color=red&style=flat-square">
<img alt="commit-activity" src="https://img.shields.io/github/commit-activity/w/rahuldshetty/ggml.js?color=green&style=flat-square">
<img alt="stars" src="https://img.shields.io/github/stars/rahuldshetty/ggml.js?style=social">
</p>

## Build
# ggml.js

You can follow the [BUILD.md](docs/BUILD.md) guide to build ggml.js JavaScript bundles.
> Run any [ggml](https://github.com/ggerganov/ggml.git) ported ML models directly on your web browser with ggml.js
## Examples
Example projects built with ggml.js: [Live Demo](https://rahuldshetty.github.io/ggml.js-examples/)

Get started with some example projects:
You can find the package documentation for this project: [Documentation](https://rahuldshetty.github.io/ggml.js/)

| Name | Description | Source code |
|-------------------|----------------------------------|-------------------------------|
| Tiny Starcoder | Demo on [tiny starcoder](https://huggingface.co/bigcode/tiny_starcoder_py) | [link](examples/basic.html) |
Models Supported:
- [Dolly v2](https://github.com/ggerganov/ggml/tree/master/examples/dolly-v2)
- [GPT2](https://github.com/ggerganov/ggml/tree/master/examples/gpt-2)
- [GPT J](https://github.com/ggerganov/ggml/tree/master/examples/gpt-j)
- [GPT NEO X](https://github.com/ggerganov/ggml/tree/master/examples/gpt-neox)
- [MPT](https://github.com/ggerganov/ggml/tree/master/examples/mpt)
- [Replit](https://github.com/ggerganov/ggml/tree/master/examples/replit)
- [StarCoder](https://github.com/ggerganov/ggml/tree/master/examples/starcoder)

*More models will be added in future*

## Installation

Download and extract latest [release](https://github.com/rahuldshetty/ggml.js/releases) of ggml.js package to your web project.

*OR*

You can follow the [Build](/BUILD.md) guide to generate ggml.js JavaScript bundles from scratch.
6 changes: 5 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

Run any [ggml](https://github.com/ggerganov/ggml.git) ported ML models directly on your web browser with ggml.js

ggml.js provides JavaScript bindings for interacting with GGML quantized ML models.

Example projects built with ggml.js: [Live Demo](https://rahuldshetty.github.io/ggml.js-examples/)

Models Supported:
- [Dolly v2](https://github.com/ggerganov/ggml/tree/master/examples/dolly-v2)
- [GPT2](https://github.com/ggerganov/ggml/tree/master/examples/gpt-2)
Expand All @@ -11,7 +15,7 @@ Models Supported:
- [Replit](https://github.com/ggerganov/ggml/tree/master/examples/replit)
- [StarCoder](https://github.com/ggerganov/ggml/tree/master/examples/starcoder)


*More models will be added in future*

## Installation

Expand Down
3 changes: 3 additions & 0 deletions docs/_coverpage.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,14 @@
<!-- _coverpage.md -->

<!-- <img src="_media/logo.png" width="400"> 1.0.0 -->

# ggml.js <small>1.0.0</small>

> Run any [ggml](https://github.com/ggerganov/ggml.git) ported ML models directly on your browser
- Serverless & Edge AI 🤖
- JavaScript ES6 Package 🧰
- Powered by WebAssembly

[GitHub](https://github.com/rahuldshetty/ggml.js.git)
[Get Started](#ggmljs)
Binary file added docs/_media/icon-512.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_media/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/_media/logo.pxz
Binary file not shown.
8 changes: 4 additions & 4 deletions docs/examples.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Examples

Get started with some example projects:
Get started with some example [projects](https://rahuldshetty.github.io/ggml.js-examples/).

| Name | Description | Source code |
|-------------------|----------------------------------|-------------------------------|
| Tiny Starcoder | Demo on [tiny starcoder](https://huggingface.co/bigcode/tiny_starcoder_py) | [link](https://github.com/rahuldshetty/ggml.js/blob/master/examples/starcoder.html) |
| GPT 2 Roleplay | Demo on [GPT2-RPGPT-8.48M](https://huggingface.co/xzuyn/GPT2-RPGPT-8.48M) | [link](https://github.com/rahuldshetty/ggml.js/blob/master/examples/gpt2_roleplay.html) |

| [Quick Start](https://rahuldshetty.github.io/ggml.js-examples/quick-start/index.html) | Basic demo example | [link](https://github.com/rahuldshetty/ggml.js-examples/tree/master/quick-start) |
| [Tiny Starcoder](https://rahuldshetty.github.io/ggml.js-examples/starcoder.html) | Demo on [tiny starcoder](https://huggingface.co/bigcode/tiny_starcoder_py) | [link](https://github.com/rahuldshetty/ggml.js-examples/blob/master/starcoder.html) |
| [GPT 2 Roleplay](https://rahuldshetty.github.io/ggml.js-examples/gpt2_roleplay.html) | Demo on [GPT2-RPGPT-8.48M](https://huggingface.co/xzuyn/GPT2-RPGPT-8.48M) | [link](https://github.com/rahuldshetty/ggml.js-examples/blob/master/gpt2_roleplay.html) |
1 change: 1 addition & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@
loadSidebar: true,
coverpage: true,
executeScript: true,
autoHeader: true,
}
</script>
<!-- Docsify v4 -->
Expand Down
2 changes: 1 addition & 1 deletion docs/quick_start.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Let us create a simple HTML file.
</html>
```


Let's define a JS script file to load model with ggml.js library and run ML inference on browser.

`script.js`
```js
Expand Down
130 changes: 0 additions & 130 deletions examples/gpt2_roleplay.html

This file was deleted.

11 changes: 0 additions & 11 deletions examples/quick_start/index.html

This file was deleted.

42 changes: 0 additions & 42 deletions examples/quick_start/script.js

This file was deleted.

Loading

0 comments on commit 73db96c

Please sign in to comment.