From b8cb27731ee488c5e7d1c8e61d897981d55637d3 Mon Sep 17 00:00:00 2001
From: DireMunchkin <1665676+DireMunchkin@users.noreply.github.com>
Date: Fri, 29 Sep 2023 05:58:18 +0000
Subject: [PATCH] Add Serge Chat (#1283)

---
 README.md                          |   1 +
 apps/serge/config.json             |  16 ++++++
 apps/serge/docker-compose.yml      |  38 +++++++++++++
 apps/serge/metadata/description.md |  82 +++++++++++++++++++++++++++++
 apps/serge/metadata/logo.jpg       | Bin 0 -> 12497 bytes
 5 files changed, 137 insertions(+)
 create mode 100644 apps/serge/config.json
 create mode 100644 apps/serge/docker-compose.yml
 create mode 100644 apps/serge/metadata/description.md
 create mode 100644 apps/serge/metadata/logo.jpg

diff --git a/README.md b/README.md
index 931f4ddd..d79571cf 100644
--- a/README.md
+++ b/README.md
@@ -127,6 +127,7 @@ This is the official repository for the Tipi App Store. It contains all the apps
 - [Sabnzbd](https://github.com/sabnzbd/sabnzbd) - Sabnzbd makes Usenet as simple and streamlined as possible by automating everything we can"
 - [SearXNG](https://github.com/searxng/searxng) - SearXNG is a free internet metasearch engine which aggregates results from various search services and databases. Users are neither tracked nor profiled
 - [Send](https://gitlab.com/timvisee/send) - Simple, private file sharing
+- [Serge](https://github.com/serge-chat/serge) -  A web interface for chatting with Alpaca through llama.cpp.
 - [SimpleX SMP](https://github.com/simplex-chat/simplexmq) - A reference implementation of the SimpleX Messaging Protocol for simplex queues over public networks.
 - [Sonarr](https://github.com/Sonarr/Sonarr) - TV show manager for Usenet and BitTorrent
 - [Sshwifty](https://github.com/nirui/sshwifty/) - Web SSH & Telnet (WebSSH & WebTelnet client)
diff --git a/apps/serge/config.json b/apps/serge/config.json
new file mode 100644
index 00000000..1928e4bd
--- /dev/null
+++ b/apps/serge/config.json
@@ -0,0 +1,16 @@
+{
+  "$schema": "../schema.json",
+  "name": "Serge",
+  "available": true,
+  "exposable": true,
+  "port": 8008,
+  "id": "serge",
+  "tipi_version": 1,
+  "version": "0.4.1",
+  "categories": ["ai"],
+  "description": "",
+  "short_desc": "LLaMA made easy",
+  "author": "nsarrazin",
+  "source": "https://github.com/serge-chat/serge",
+  "form_fields": []
+}
diff --git a/apps/serge/docker-compose.yml b/apps/serge/docker-compose.yml
new file mode 100644
index 00000000..206073dd
--- /dev/null
+++ b/apps/serge/docker-compose.yml
@@ -0,0 +1,38 @@
+version: "3.7"
+services:
+  serge:
+    image: ghcr.io/serge-chat/serge:0.4.1
+    container_name: serge
+    restart: unless-stopped
+    ports:
+      - ${APP_PORT}:8008
+    networks:
+      - tipi_main_network
+    volumes:
+      - ${APP_DATA_DIR}/data/weights:/usr/src/app/weights
+      - ${APP_DATA_DIR}/data/db:/data/db/
+    labels:
+      # Main
+      traefik.enable: true
+      traefik.http.middlewares.serge-web-redirect.redirectscheme.scheme: https
+      traefik.http.services.serge.loadbalancer.server.port: 8008
+      # Web
+      traefik.http.routers.serge-insecure.rule: Host(`${APP_DOMAIN}`)
+      traefik.http.routers.serge-insecure.entrypoints: web
+      traefik.http.routers.serge-insecure.service: serge
+      traefik.http.routers.serge-insecure.middlewares: serge-web-redirect
+      # Websecure
+      traefik.http.routers.serge.rule: Host(`${APP_DOMAIN}`)
+      traefik.http.routers.serge.entrypoints: websecure
+      traefik.http.routers.serge.service: serge
+      traefik.http.routers.serge.tls.certresolver: myresolver
+      # Local domain
+      traefik.http.routers.serge-local-insecure.rule: Host(`serge.${LOCAL_DOMAIN}`)
+      traefik.http.routers.serge-local-insecure.entrypoints: web
+      traefik.http.routers.serge-local-insecure.service: serge
+      traefik.http.routers.serge-local-insecure.middlewares: serge-web-redirect
+      # Local domain secure
+      traefik.http.routers.serge-local.rule: Host(`serge.${LOCAL_DOMAIN}`)
+      traefik.http.routers.serge-local.entrypoints: websecure
+      traefik.http.routers.serge-local.service: serge
+      traefik.http.routers.serge-local.tls: true
diff --git a/apps/serge/metadata/description.md b/apps/serge/metadata/description.md
new file mode 100644
index 00000000..fd115f73
--- /dev/null
+++ b/apps/serge/metadata/description.md
@@ -0,0 +1,82 @@
+# Serge - LLaMA made easy 🦙
+
+Serge is a chat interface crafted with [llama.cpp](https://github.com/ggerganov/llama.cpp) for running Alpaca models. No API keys, entirely self-hosted!
+
+- 🌐 **SvelteKit** frontend
+- 💾 **[Redis](https://github.com/redis/redis)** for storing chat history & parameters
+- ⚙️ **FastAPI + LangChain** for the API, wrapping calls to [llama.cpp](https://github.com/ggerganov/llama.cpp) using the [python bindings](https://github.com/abetlen/llama-cpp-python)
+
+
+## 🧠 Supported Models
+
+| Category      | Models |
+|:-------------:|:-------|
+| **Alpaca 🦙** | Alpaca-LoRA-65B, GPT4-Alpaca-LoRA-30B |
+| **Chronos 🌑**| Chronos-13B, Chronos-33B, Chronos-Hermes-13B |
+| **GPT4All 🌍**| GPT4All-13B |
+| **Koala 🐨**  | Koala-7B, Koala-13B |
+| **LLaMA 🦙**  | FinLLaMA-33B, LLaMA-Supercot-30B, LLaMA2 7B, LLaMA2 13B, LLaMA2 70B |
+| **Lazarus 💀**| Lazarus-30B |
+| **Nous 🧠**   | Nous-Hermes-13B |
+| **OpenAssistant 🎙️** | OpenAssistant-30B |
+| **Orca 🐬**   | Orca-Mini-v2-7B, Orca-Mini-v2-13B, OpenOrca-Preview1-13B |
+| **Samantha 👩**| Samantha-7B, Samantha-13B, Samantha-33B |
+| **Vicuna 🦙** | Stable-Vicuna-13B, Vicuna-CoT-7B, Vicuna-CoT-13B, Vicuna-v1.1-7B, Vicuna-v1.1-13B, VicUnlocked-30B, VicUnlocked-65B |
+| **Wizard 🧙** | Wizard-Mega-13B, WizardLM-Uncensored-7B, WizardLM-Uncensored-13B, WizardLM-Uncensored-30B, WizardCoder-Python-13B-V1.0 |
+
+Additional weights can be added to the `serge_weights` volume using `docker cp`:
+
+```bash
+docker cp ./my_weight.bin serge:/usr/src/app/weights/
+```
+
+## ⚠️ Memory Usage
+
+LLaMA will crash if you don't have enough available memory for the model:
+
+| Model       | Max RAM Required |
+|-------------|------------------|
+| 7B          | 4.5GB            |
+| 7B-q2_K     | 5.37GB           |
+| 7B-q3_K_L   | 6.10GB           |
+| 7B-q4_1     | 6.71GB           |
+| 7B-q4_K_M   | 6.58GB           |
+| 7B-q5_1     | 7.56GB           |
+| 7B-q5_K_M   | 7.28GB           |
+| 7B-q6_K     | 8.03GB           |
+| 7B-q8_0     | 9.66GB           |
+| 13B         | 12GB             |
+| 13B-q2_K    | 8.01GB           |
+| 13B-q3_K_L  | 9.43GB           |
+| 13B-q4_1    | 10.64GB          |
+| 13B-q4_K_M  | 10.37GB          |
+| 13B-q5_1    | 12.26GB          |
+| 13B-q5_K_M  | 11.73GB          |
+| 13B-q6_K    | 13.18GB          |
+| 13B-q8_0    | 16.33GB          |
+| 33B         | 20GB             |
+| 33B-q2_K    | 16.21GB          |
+| 33B-q3_K_L  | 19.78GB          |
+| 33B-q4_1    | 22.83GB          |
+| 33B-q4_K_M  | 22.12GB          |
+| 33B-q5_1    | 26.90GB          |
+| 33B-q5_K_M  | 25.55GB          |
+| 33B-q6_K    | 29.19GB          |
+| 33B-q8_0    | 37.06GB          |
+| 65B         | 50GB             |
+| 65B-q2_K    | 29.95GB          |
+| 65B-q3_K_L  | 37.15GB          |
+| 65B-q4_1    | 43.31GB          |
+| 65B-q4_K_M  | 41.85GB          |
+| 65B-q5_1    | 51.47GB          |
+| 65B-q5_K_M  | 48.74GB          |
+| 65B-q6_K    | 56.06GB          |
+| 65B-q8_0    | 71.87GB          |
+
+## 🧾 License
+
+[Nathan Sarrazin](https://github.com/nsarrazin) and [Contributors](https://github.com/serge-chat/serge/graphs/contributors). `Serge` is free and open-source software licensed under the [MIT License](https://github.com/serge-chat/serge/blob/master/LICENSE).
+
+## 💬 Support
+
+Need help? Join our [Discord](https://discord.gg/62Hc6FEYQH)
diff --git a/apps/serge/metadata/logo.jpg b/apps/serge/metadata/logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..3b3d5e87f9e241569f2607f987a6ed05e903d5b8
GIT binary patch
literal 12497
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

literal 0
HcmV?d00001