Merge pull request #1021 from janhq/importModelDocs

docs: second half of "import model docs" PR
This commit is contained in:
0xSage 2023-12-15 12:47:52 +08:00 committed by GitHub
commit 79f4bd1978
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -24,6 +24,8 @@ Navigate to `~/jan/models` folder on your computer.
In `App Settings`, go to `Advanced`, then `Open App Directory`. In `App Settings`, go to `Advanced`, then `Open App Directory`.
Or, you can directly cd into:
```sh ```sh
# Windows # Windows
C:/Users/<your_user_name>/jan/models C:/Users/<your_user_name>/jan/models
@ -35,21 +37,21 @@ jan/models
In the `models` folder, create a folder with the name of the model. In the `models` folder, create a folder with the name of the model.
```sh ```sh
mkdir pandora-v1-q4 mkdir trinity-v1-7b
``` ```
## 2. Create a model JSON ## 2. Create a model JSON
Jan follows a standardized model template, called a `model.json`. This allows for easy model configurations, exporting, and sharing. Jan follows a folder-based, [standard model template](/specs/models) called a `model.json`. This allows for easy model configurations, exporting, and sharing.
```sh ```sh
cd pandora-v1-q4 cd trinity-v1-7b
touch model.json touch model.json
``` ```
The following is an example template for `model.json` Copy the following into the `model.json`
``` ```js
{ {
"source_url": "https://huggingface.co/janhq/trinity-v1-GGUF/resolve/main/trinity-v1.Q4_K_M.gguf", "source_url": "https://huggingface.co/janhq/trinity-v1-GGUF/resolve/main/trinity-v1.Q4_K_M.gguf",
"id": "trinity-v1-7b", "id": "trinity-v1-7b",
@ -71,21 +73,25 @@ The following is an example template for `model.json`
"size": 4370000000 "size": 4370000000
}, },
"engine": "nitro" "engine": "nitro"
} }
``` ```
:::caution :::caution
Ensure the `source_url` is the link to download model Ensure the `source_url` property is the direct binary download link ending in `.gguf`. Find the links in Huggingface > `Files and versions`.
Ensure the `id` is the same with the new created folder Ensure the `id` property is the model foldername
Ensure to choose right `prompt_template` Ensure you are using the correct `prompt_template`
::: :::
# 3. Use your model ## 3. Download your model binary
Restart the Jan application and look for your model in the Hub. Restart the Jan application and look for your model in the Hub.
Click the green `download` button to download your actual model binary from the URL you provided.
![image](https://hackmd.io/_uploads/HJLAqvwI6.png) ![image](https://hackmd.io/_uploads/HJLAqvwI6.png)
There you go. If you have any questions or want to request for more preconfigured GGUF models, please message us on [Jan Discord](https://discord.gg/Dt7MxDyNNZ). There you go! You are ready to use your model.
If you have any questions or want to request for more preconfigured GGUF models, please message us in [Discord](https://discord.gg/Dt7MxDyNNZ).