How To Updates / Model Used Switched / Removed "docker-compose" (RIP) (#1417)

* Update _index.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-model.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-cpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-gpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update _index.en.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-cpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-gpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-cpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-cpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-gpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-model.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-cpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-gpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-cpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update _index.en.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> * Update easy-setup-docker-gpu.md Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com> --------- Signed-off-by: lunamidori5 <118759930+lunamidori5@users.noreply.github.com>
2025-04-29 15:29:58 +00:00 · 2023-12-11 06:27:29 -08:00 · 2023-12-11 06:27:29 -08:00 · 9222bec8b1
commit 9222bec8b1
parent 4a965e1b0e
5 changed files with 75 additions and 64 deletions
--- a/docs/content/getting_started/_index.en.md
+++ b/docs/content/getting_started/_index.en.md
@ -88,7 +88,7 @@ curl http://localhost:8080/v1/completions -H "Content-Type: application/json" -d
   }'
 ```

-Note: If you are on Windows, please run ``docker-compose`` not ``docker compose`` and make sure the project is in the Linux Filesystem, otherwise loading models might be slow. For more Info: [Microsoft Docs](https://learn.microsoft.com/en-us/windows/wsl/filesystems)
+Note: If you are on Windows, please make sure the project is on the Linux Filesystem, otherwise loading models might be slow. For more Info: [Microsoft Docs](https://learn.microsoft.com/en-us/windows/wsl/filesystems)

 {{% /tab %}}

--- a/docs/content/howtos/_index.md
+++ b/docs/content/howtos/_index.md
@ -11,7 +11,8 @@ This section includes LocalAI end-to-end examples, tutorial and how-tos curated
 - [Setup LocalAI with Docker on CPU]({{%relref "howtos/easy-setup-docker-cpu" %}})
 - [Setup LocalAI with Docker With CUDA]({{%relref "howtos/easy-setup-docker-gpu" %}})
 - [Seting up a Model]({{%relref "howtos/easy-model" %}})
- [Making requests to LocalAI]({{%relref "howtos/easy-request" %}})
+- [Making Text / LLM requests to LocalAI]({{%relref "howtos/easy-request" %}})
+- [Making Photo / SD requests to LocalAI]({{%relref "howtos/easy-setup-sd" %}})
  
 ## Programs and Demos

--- a/docs/content/howtos/easy-model.md
+++ b/docs/content/howtos/easy-model.md
@ -5,43 +5,52 @@ title = "Easy Model Setup"
 weight = 2
 +++

-Lets Learn how to setup a model, for this ``How To`` we are going to use the ``Luna-Ai`` model (Yes I know haha - ``Luna Midori`` making a how to using the ``luna-ai-llama2`` model - lol)
+Lets learn how to setup a model, for this ``How To`` we are going to use the ``Dolphin 2.2.1 Mistral 7B`` model.

 To download the model to your models folder, run this command in a commandline of your picking.
 ```bash
 curl --location 'http://localhost:8080/models/apply' \
 --header 'Content-Type: application/json' \
 --data-raw '{
-    "id": "TheBloke/Luna-AI-Llama2-Uncensored-GGUF/luna-ai-llama2-uncensored.Q4_K_M.gguf"
+    "id": "TheBloke/dolphin-2.2.1-mistral-7B-GGUF/dolphin-2.2.1-mistral-7b.Q4_0.gguf"
 }'
 ```

-Each model needs at least ``4`` files, with out these files, the model will run raw, what that means is you can not change settings of the model.
+Each model needs at least ``5`` files, with out these files, the model will run raw, what that means is you can not change settings of the model.
 ```
 File 1 - The model's GGUF file
 File 2 - The model's .yaml file
 File 3 - The Chat API .tmpl file
-File 4 - The Completion API .tmpl file
+File 4 - The Chat API helper .tmpl file
+File 5 - The Completion API .tmpl file
 ```
 So lets fix that! We are using ``lunademo`` name for this ``How To`` but you can name the files what ever you want! Lets make blank files to start with

 ```bash
 touch lunademo-chat.tmpl
+touch lunademo-chat-block.tmpl
 touch lunademo-completion.tmpl
 touch lunademo.yaml
 ```
-Now lets edit the `"lunademo-chat.tmpl"`, Looking at the huggingface repo, this model uses the ``ASSISTANT:`` tag for when the AI replys, so lets make sure to add that to this file. Do not add the user as we will be doing that in our yaml file!
+Now lets edit the `"lunademo-chat.tmpl"`, This is the template that model "Chat" trained models use, but changed for LocalAI
+
+```txt
+<|im_start|>{{if eq .RoleName "assistant"}}assistant{{else if eq .RoleName "system"}}system{{else if eq .RoleName "user"}}user{{end}}
+{{if .Content}}{{.Content}}{{end}}
+<|im_end|>
+```
+
+For the `"lunademo-chat-block.tmpl"`, Looking at the huggingface repo, this model uses the ``<|im_start|>assistant`` tag for when the AI replys, so lets make sure to add that to this file. Do not add the user as we will be doing that in our yaml file!

 ```txt
 {{.Input}}
-
-ASSISTANT:
+<|im_start|>assistant
 ```

-Now in the `"lunademo-completion.tmpl"` file lets add this.
+Now in the `"lunademo-completion.tmpl"` file lets add this. (This is a hold over from OpenAI V0)

 ```txt
-Complete the following sentence: {{.Input}}
+{{.Input}}
 ```


@ -58,25 +67,18 @@ What this does is tell ``LocalAI`` how to load the model. Then we are going to *
 ```yaml
 name: lunademo
 parameters:
-  model: luna-ai-llama2-uncensored.Q4_K_M.gguf
+  model: dolphin-2.2.1-mistral-7b.Q4_0.gguf
 ```

-Now that we have the model set up, there a few things we should add to the yaml file to make it run better, for this model it uses the following roles.
-```yaml
-roles:
-  assistant: 'ASSISTANT:'
-  system: 'SYSTEM:'
-  user: 'USER:'
-```
-
-What that did is made sure that ``LocalAI`` added the test to the users in the request, so if a message is from ``system`` it shows up in the template as ``SYSTEM:``, speaking of template files, lets add those to our models yaml file now.
+Now that LocalAI knows what file to load with our request, lets add the template files to our models yaml file now.
 ```yaml
 template:
-  chat: lunademo-chat
+  chat: lunademo-chat-block
+  chat_message: lunademo-chat
  completion: lunademo-completion
 ```

-If you are running on ``GPU`` or want to tune the model, you can add settings like
+If you are running on ``GPU`` or want to tune the model, you can add settings like (higher the GPU Layers the more GPU used)
 ```yaml
 f16: true
 gpu_layers: 4
@ -85,8 +87,7 @@ gpu_layers: 4
 To fully tune the model to your like. But be warned, you **must** restart ``LocalAI`` after changing a yaml file

 ```bash
-docker-compose restart ##windows
-docker compose restart ##linux / mac
+docker compose restart
 ```

 If you want to check your models yaml, here is a full copy!
@ -96,19 +97,18 @@ context_size: 2000
 ##Put settings right here for tunning!! Before name but after Backend!
 name: lunademo
 parameters:
-  model: luna-ai-llama2-uncensored.Q4_K_M.gguf
-roles:
-  assistant: 'ASSISTANT:'
-  system: 'SYSTEM:'
-  user: 'USER:'
+  model: dolphin-2.2.1-mistral-7b.Q4_0.gguf
 template:
-  chat: lunademo-chat
+  chat: lunademo-chat-block
+  chat_message: lunademo-chat
  completion: lunademo-completion
 ```

 Now that we got that setup, lets test it out but sending a [request]({{%relref "easy-request" %}}) to Localai! 

-## Adv Stuff
+## ----- Adv Stuff -----
+
+**(Please do not run these steps if you have already done the setup)**
 Alright now that we have learned how to set up our own models, here is how to use the gallery to do alot of this for us. This command will download and set up (mostly, we will **always** need to edit our yaml file to fit our computer / hardware)
 ```bash
 curl http://localhost:8080/models/apply -H "Content-Type: application/json" -d '{
--- a/docs/content/howtos/easy-setup-docker-cpu.md
+++ b/docs/content/howtos/easy-setup-docker-cpu.md
@ -7,27 +7,33 @@ weight = 2

 {{% notice Note %}}
 - You will need about 10gb of RAM Free
- You will need about 15gb of space free on C drive for ``Docker-compose``
+- You will need about 15gb of space free on C drive for ``Docker compose``
 {{% /notice %}}

-We are going to run `LocalAI` with `docker-compose` for this set up.
+We are going to run `LocalAI` with `docker compose` for this set up.

-
-Lets clone `LocalAI` with git.
-
-```bash
-git clone https://github.com/go-skynet/LocalAI
-```
-
-
-Then we will cd into the ``LocalAI`` folder.
-
-```bash
+Lets setup our folders for ``LocalAI``
+{{< tabs >}}
+{{% tab name="Windows (Batch)" %}}
+```batch
+mkdir "LocalAI"
 cd LocalAI
+mkdir "models"
+mkdir "images"
 ```
+{{% /tab %}}

+{{% tab name="Linux (Bash / WSL)" %}}
+```bash
+mkdir -p "LocalAI"
+cd LocalAI
+mkdir -p "models"
+mkdir -p "images"
+```
+{{% /tab %}}
+{{< /tabs >}}

-At this point we want to set up our `.env` file, here is a copy for you to use if you wish, please make sure to set it to the same as in the `docker-compose` file for later.
+At this point we want to set up our `.env` file, here is a copy for you to use if you wish, Make sure this is in the ``LocalAI`` folder.

 ```bash
 ## Set number of threads.
@ -102,8 +108,7 @@ services:
 Make sure to save that in the root of the `LocalAI` folder. Then lets spin up the Docker run this in a `CMD` or `BASH`

 ```bash
-docker-compose up -d --pull always ##Windows
-docker compose up -d --pull always ##Linux
+docker compose up -d --pull always
 ```


--- a/docs/content/howtos/easy-setup-docker-gpu.md
+++ b/docs/content/howtos/easy-setup-docker-gpu.md
@ -7,27 +7,33 @@ weight = 2

 {{% notice Note %}}
 - You will need about 10gb of RAM Free
- You will need about 15gb of space free on C drive for ``Docker-compose``
+- You will need about 15gb of space free on C drive for ``Docker compose``
 {{% /notice %}}

-We are going to run `LocalAI` with `docker-compose` for this set up.
+We are going to run `LocalAI` with `docker compose` for this set up.

-
-Lets clone `LocalAI` with git.
-
-```bash
-git clone https://github.com/go-skynet/LocalAI
-```
-
-
-Then we will cd into the `LocalAI` folder.
-
-```bash
+Lets Setup our folders for ``LocalAI``
+{{< tabs >}}
+{{% tab name="Windows (Batch)" %}}
+```batch
+mkdir "LocalAI"
 cd LocalAI
+mkdir "models"
+mkdir "images"
 ```
+{{% /tab %}}

+{{% tab name="Linux (Bash / WSL)" %}}
+```bash
+mkdir -p "LocalAI"
+cd LocalAI
+mkdir -p "models"
+mkdir -p "images"
+```
+{{% /tab %}}
+{{< /tabs >}}

-At this point we want to set up our `.env` file, here is a copy for you to use if you wish, please make sure to set it to the same as in the `docker-compose` file for later.
+At this point we want to set up our `.env` file, here is a copy for you to use if you wish, Make sure this is in the ``LocalAI`` folder.

 ```bash
 ## Set number of threads.
@ -134,8 +140,7 @@ services:
 Make sure to save that in the root of the `LocalAI` folder. Then lets spin up the Docker run this in a `CMD` or `BASH`

 ```bash
-docker-compose up -d --pull always ##Windows
-docker compose up -d --pull always ##Linux
+docker compose up -d --pull always
 ```