diff --git a/404.html b/404.html
index ece3212de..95c49a559 100644
--- a/404.html
+++ b/404.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="/resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="/resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="/resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="/resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="/resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="/resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="/resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/administration/config-yaml/index.html b/administration/config-yaml/index.html
index 6dbdfee82..70cb45ee9 100644
--- a/administration/config-yaml/index.html
+++ b/administration/config-yaml/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/administration/index.html b/administration/index.html
index 8495d97d8..ec8ebbde7 100644
--- a/administration/index.html
+++ b/administration/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/administration/multi-user/index.html b/administration/multi-user/index.html
index 295a92d16..32f483c0d 100644
--- a/administration/multi-user/index.html
+++ b/administration/multi-user/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/administration/sso/index.html b/administration/sso/index.html
index 3d1935fc9..b98e9840d 100644
--- a/administration/sso/index.html
+++ b/administration/sso/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/administration/tunneling/index.html b/administration/tunneling/index.html
index 08f346cad..29df5c0d1 100644
--- a/administration/tunneling/index.html
+++ b/administration/tunneling/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/alltalk/index.html b/extensions/alltalk/index.html
index 6eae31152..f026bf598 100644
--- a/extensions/alltalk/index.html
+++ b/extensions/alltalk/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/blip/index.html b/extensions/blip/index.html
index 0271a9ec7..1fdbedf86 100644
--- a/extensions/blip/index.html
+++ b/extensions/blip/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/captioning/index.html b/extensions/captioning/index.html
index d580a2ef2..5272660c2 100644
--- a/extensions/captioning/index.html
+++ b/extensions/captioning/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/extensions/chat-vectorization/index.html b/extensions/chat-vectorization/index.html
index 6aa0ca7a4..2df0f6bc2 100644
--- a/extensions/chat-vectorization/index.html
+++ b/extensions/chat-vectorization/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/dynamic-audio/index.html b/extensions/dynamic-audio/index.html
index b2ad78ad5..9d3a4abde 100644
--- a/extensions/dynamic-audio/index.html
+++ b/extensions/dynamic-audio/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/emulatorjs/index.html b/extensions/emulatorjs/index.html
index 8e94b373f..9a72397be 100644
--- a/extensions/emulatorjs/index.html
+++ b/extensions/emulatorjs/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/expression-images/index.html b/extensions/expression-images/index.html
index ec73bdeb0..b702912f2 100644
--- a/extensions/expression-images/index.html
+++ b/extensions/expression-images/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/extras/index.html b/extensions/extras/index.html
index 715dc9ce2..207416c48 100644
--- a/extensions/extras/index.html
+++ b/extensions/extras/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/extras/installation/common-problems/index.html b/extensions/extras/installation/common-problems/index.html
index 527e7fc15..eab5ccbdf 100644
--- a/extensions/extras/installation/common-problems/index.html
+++ b/extensions/extras/installation/common-problems/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/extras/installation/index.html b/extensions/extras/installation/index.html
index c02409f63..37f57d262 100644
--- a/extensions/extras/installation/index.html
+++ b/extensions/extras/installation/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/extras/running-extras-in-colab/index.html b/extensions/extras/running-extras-in-colab/index.html
index a5cc9cef0..4eb42a903 100644
--- a/extensions/extras/running-extras-in-colab/index.html
+++ b/extensions/extras/running-extras-in-colab/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/index.html b/extensions/index.html
index 307bceb0b..941ad53ee 100644
--- a/extensions/index.html
+++ b/extensions/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/live2d/index.html b/extensions/live2d/index.html
index 1e9d04644..d0adc4483 100644
--- a/extensions/live2d/index.html
+++ b/extensions/live2d/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/objective/index.html b/extensions/objective/index.html
index 618f4cbef..64c10be92 100644
--- a/extensions/objective/index.html
+++ b/extensions/objective/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/rvc/index.html b/extensions/rvc/index.html
index 008c886eb..260bd6bb6 100644
--- a/extensions/rvc/index.html
+++ b/extensions/rvc/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/extensions/smart-context/index.html b/extensions/smart-context/index.html
index 5fd3aecd2..47af094b0 100644
--- a/extensions/smart-context/index.html
+++ b/extensions/smart-context/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/speech-recognition/index.html b/extensions/speech-recognition/index.html
index aa3b3f93f..36fceff95 100644
--- a/extensions/speech-recognition/index.html
+++ b/extensions/speech-recognition/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/extensions/stable-diffusion/index.html b/extensions/stable-diffusion/index.html
index 6fbd971b7..95a747959 100644
--- a/extensions/stable-diffusion/index.html
+++ b/extensions/stable-diffusion/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,12 +35,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/extensions/summarize/index.html b/extensions/summarize/index.html
index 3988c5165..d06f64494 100644
--- a/extensions/summarize/index.html
+++ b/extensions/summarize/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/talkinghead/index.html b/extensions/talkinghead/index.html
index 80951b3c8..f310815e7 100644
--- a/extensions/talkinghead/index.html
+++ b/extensions/talkinghead/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/translation/index.html b/extensions/translation/index.html
index 9666a6b4a..22d10be57 100644
--- a/extensions/translation/index.html
+++ b/extensions/translation/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,12 +35,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/extensions/tts/index.html b/extensions/tts/index.html
index 9ffaa67c3..39550b405 100644
--- a/extensions/tts/index.html
+++ b/extensions/tts/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/vrm/index.html b/extensions/vrm/index.html
index 1a10f925c..7e7d23625 100644
--- a/extensions/vrm/index.html
+++ b/extensions/vrm/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/websearch/index.html b/extensions/websearch/index.html
index 394fdac75..349dcfad4 100644
--- a/extensions/websearch/index.html
+++ b/extensions/websearch/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/extensions/xtts/index.html b/extensions/xtts/index.html
index fe7914ac0..355ac5e0a 100644
--- a/extensions/xtts/index.html
+++ b/extensions/xtts/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/for-contributors/function-calling/index.html b/for-contributors/function-calling/index.html
index 5aad824e1..fb0e93098 100644
--- a/for-contributors/function-calling/index.html
+++ b/for-contributors/function-calling/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/for-contributors/i18n/index.html b/for-contributors/i18n/index.html
index f317c9bdf..c1b04084b 100644
--- a/for-contributors/i18n/index.html
+++ b/for-contributors/i18n/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,12 +35,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/for-contributors/index.html b/for-contributors/index.html
index 540ee8023..0b56a5eb4 100644
--- a/for-contributors/index.html
+++ b/for-contributors/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/for-contributors/server-plugins/index.html b/for-contributors/server-plugins/index.html
index 23b2d7a0d..202f96632 100644
--- a/for-contributors/server-plugins/index.html
+++ b/for-contributors/server-plugins/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/for-contributors/writing-extensions/index.html b/for-contributors/writing-extensions/index.html
index 01b3326b4..0e4f097ee 100644
--- a/for-contributors/writing-extensions/index.html
+++ b/for-contributors/writing-extensions/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/index.html b/index.html
index 2973719ed..4f0e4595c 100644
--- a/index.html
+++ b/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/installation/android-(termux)/index.html b/installation/android-(termux)/index.html
index 89f38f050..51def9761 100644
--- a/installation/android-(termux)/index.html
+++ b/installation/android-(termux)/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/installation/docker/index.html b/installation/docker/index.html
index 67866072f..e88b03360 100644
--- a/installation/docker/index.html
+++ b/installation/docker/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/installation/index.html b/installation/index.html
index 202a2f1fb..3c5ba73f4 100644
--- a/installation/index.html
+++ b/installation/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/installation/linuxmacos/index.html b/installation/linuxmacos/index.html
index ecb43ee6c..ffc3c13c7 100644
--- a/installation/linuxmacos/index.html
+++ b/installation/linuxmacos/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/installation/st-1.12.0-migration-guide/index.html b/installation/st-1.12.0-migration-guide/index.html
index 1cbcc9a5c..d66ed56dc 100644
--- a/installation/st-1.12.0-migration-guide/index.html
+++ b/installation/st-1.12.0-migration-guide/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/installation/updating/index.html b/installation/updating/index.html
index b173d1443..56ba97eb3 100644
--- a/installation/updating/index.html
+++ b/installation/updating/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/installation/updating/migration-guide-1-09/index.html b/installation/updating/migration-guide-1-09/index.html
index beed860cb..fe77c0d92 100644
--- a/installation/updating/migration-guide-1-09/index.html
+++ b/installation/updating/migration-guide-1-09/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/installation/windows/index.html b/installation/windows/index.html
index 8cbf0f732..c132d460c 100644
--- a/installation/windows/index.html
+++ b/installation/windows/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,12 +35,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/licensecredits/index.html b/licensecredits/index.html
index 45d016498..9ab3ab588 100644
--- a/licensecredits/index.html
+++ b/licensecredits/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/resources/js/config.js b/resources/js/config.js
index 096011871..814b148bf 100644
--- a/resources/js/config.js
+++ b/resources/js/config.js
@@ -1 +1 @@
-var __DOCS_CONFIG__ = {"id":"pG1285K77q7DUv/83qlGMcYeHjh7Q4pxUP+","key":"+FmPspItqflUKRG5Do1r9WMMeKA/bSdD5t7AdAQ4EbY.fSeAyLnmxScIrBdzRyODeZTJ/7ic1ppGpQe8xbJYMVyw/4x97Y+sco8061JTOzYQOl0t9Em1Vpt+QlQkCvDaQg.8273","base":"/","host":"docs.sillytavern.app","version":"1.0.0","useRelativePaths":true,"documentName":"index.html","appendDocumentName":false,"trailingSlash":true,"preloadSearch":false,"cacheBustingToken":"3.6.0.790805324509","cacheBustingStrategy":"query","sidebarFilterPlaceholder":"Filter","toolbarFilterPlaceholder":"Filter","showSidebarFilter":true,"filterNotFoundMsg":"No member names found containing the query \"{query}\"","maxHistoryItems":15,"homeIcon":"<path d=\"M12.97 2.59a1.5 1.5 0 00-1.94 221 0l-7.5 6.363A1.5 1.5 0 003 10.097V19.5A1.5 1.5 0 004.5 21h4.75a.75.75 0 00.75-.75V14h4v6.25c0 .414.336.75.75.75h4.75a1.5 1.5 0 001.5-1.5v-9.403a1.5 1.5 0 00-.53-1.144l-7.5-6.363z\"></path>","access":[{"value":"public","label":"Public"},{"value":"protected","label":"Protected"}],"toolbarLinks":[{"id":"fields","label":"Fields"},{"id":"properties","label":"Properties"},{"id":"methods","label":"Methods"},{"id":"events","label":"Events"}],"sidebar":[{"n":"/","l":"What is Silly​Tavern?"},{"n":"installation","l":"Installation","o":true,"i":[{"n":"windows","l":"Windows"},{"n":"linuxmacos","l":"Mac​OS & Linux"},{"n":"/installation/android-(termux)","l":"Android (Termux)"},{"n":"docker","l":"Docker"},{"n":"updating","l":"Updating","i":[{"n":"/installation/st-1.12.0-migration-guide","l":"1.​12.​0 Migration Guide"},{"n":"migration-guide-1-09","l":"1.​9.​0 Migration Guide"}],"s":"<path d=\"M1.875 2.875a2.5 2.5 0 0 1 2.5-2.5h14a.75.75 0 0 1 .75.75v9.125a.75.75 0 0 1-1.5 0V1.875H4.375a1 1 0 0 0-1 1v11.208a2.486 2.486 0 0 1 1-.208h5.937a.75.75 0 1 1 0 1.5H4.375a1 1 0 0 0-1 1v1.75a1 1 0 0 0 1 1h6a.75.75 0 0 1 0 1.5h-6a2.5 2.5 0 0 1-2.5-2.5V2.875Z\"/><path d=\"M18.643 20.484a.749.749 0 1 0 1.061 1.06l3.757-3.757a.75.75 0 0 0 0-1.06l-3.757-3.757a.75.75 0 0 0-1.061 1.06l2.476 2.477H13a.75.75 0 0 0 0 1.5h8.12l-2.477 2.477Z\"/>"}],"s":"<path d=\"M12.876.64V.639l8.25 4.763c.541.313.875.89.875 1.515v9.525a1.75 1.75 0 0 1-.875 1.516l-8.25 4.762a1.748 1.748 0 0 1-1.75 0l-8.25-4.763a1.75 1.75 0 0 1-.875-1.515V6.917c0-.625.334-1.202.875-1.515L11.126.64a1.748 1.748 0 0 1 1.75 0Zm-1 1.298L4.251 6.34l7.75 4.474 7.75-4.474-7.625-4.402a.248.248 0 0 0-.25 0Zm.875 19.123 7.625-4.402a.25.25 0 0 0 .125-.216V7.639l-7.75 4.474ZM3.501 7.64v8.803c0 .09.048.172.125.216l7.625 4.402v-8.947Z\"/>"},{"n":"usage","l":"Usage","o":true,"i":[{"n":"quick-start","l":"Quick Start","s":"<path d=\"M20.322.75h1.176a1.75 1.75 0 0 1 1.75 1.749v1.177a10.75 10.75 0 0 1-2.925 7.374l-1.228 1.304a23.699 23.699 0 0 1-1.596 1.542v5.038c0 .615-.323 1.184-.85 1.5l-4.514 2.709a.75.75 0 0 1-1.12-.488l-.963-4.572a1.305 1.305 0 0 1-.14-.129L8.04 15.96l-1.994-1.873a1.305 1.305 0 0 1-.129-.14l-4.571-.963a.75.75 0 0 1-.49-1.12l2.71-4.514c.316-.527.885-.85 1.5-.85h5.037a23.668 23.668 0 0 1 1.542-1.594l1.304-1.23A10.753 10.753 0 0 1 20.321.75Zm-6.344 4.018v-.001l-1.304 1.23a22.275 22.275 0 0 0-3.255 3.851l-2.193 3.29 1.859 1.744a.545.545 0 0 1 .034.034l1.743 1.858 3.288-2.192a22.263 22.263 0 0 0 3.854-3.257l1.228-1.303a9.251 9.251 0 0 0 2.517-6.346V2.5a.25.25 0 0 0-.25-.25h-1.177a9.252 9.252 0 0 0-6.344 2.518ZM6.5 21c-1.209 1.209-3.901 1.445-4.743 1.49a.236.236 0 0 1-.18-.067.236.236 0 0 1-.067-.18c.045-.842.281-3.534 1.49-4.743.9-.9 2.6-.9 3.5 0 .9.9.9 2.6 0 3.5Zm-.592-8.588L8.17 9.017c.23-.346.47-.685.717-1.017H5.066a.25.25 0 0 0-.214.121l-2.167 3.612ZM16 15.112c-.333.248-.672.487-1.018.718l-3.393 2.262.678 3.223 3.612-2.167a.25.25 0 0 0 .121-.214ZM17.5 8a1.5 1.5 0 1 1-3.001-.001A1.5 1.5 0 0 1 17.5 8Z\"/>"},{"n":"faq","l":"FAQ","s":"<path d=\"M10.97 8.265a1.45 1.45 0 0 0-.487.57.75.75 0 0 1-1.341-.67c.2-.402.513-.826.997-1.148C10.627 6.69 11.244 6.5 12 6.5c.658 0 1.369.195 1.934.619a2.45 2.45 0 0 1 1.004 2.006c0 1.033-.513 1.72-1.027 2.215-.19.183-.399.358-.579.508l-.147.123a4.329 4.329 0 0 0-.435.409v1.37a.75.75 0 1 1-1.5 0v-1.473c0-.237.067-.504.247-.736.22-.28.486-.517.718-.714l.183-.153.001-.001c.172-.143.324-.27.47-.412.368-.355.569-.676.569-1.136a.953.953 0 0 0-.404-.806C12.766 8.118 12.384 8 12 8c-.494 0-.814.121-1.03.265ZM13 17a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"/><path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1ZM2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5 9.5 9.5 0 0 0 2.5 12Z\"/>"},{"n":"chatting","l":"Chatting","i":[{"n":"/usage/core-concepts/slashcommands","l":"Slash commands","s":"<path d=\"M19.564 4.42a.75.75 0 0 0-1.378-.59l-6.75 15.75a.75.75 0 0 0 1.378.59l6.75-15.75ZM7 18.5a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0Z\"/>"},{"n":"/usage/hotkeys","l":"Hot​Keys","s":"<symbol id=\"key-asterisk-icon-symbol\" viewBox=\"0 0 16 16\"><path d=\"M0 2.75A2.75 2.75 0 0 1 2.75 0h10.5A2.75 2.75 0 0 1 16 2.75v10.5A2.75 2.75 0 0 1 13.25 16H2.75A2.75 2.75 0 0 1 0 13.25ZM2.75 1.5c-.69 0-1.25.56-1.25 1.25v10.5c0 .69.56 1.25 1.25 1.25h10.5c.69 0 1.25-.56 1.25-1.25V2.75c0-.69-.56-1.25-1.25-1.25Z\"/><path d=\"M8 4a.75.75 0 0 1 .75.75V6.7l1.69-.975a.75.75 0 0 1 .75 1.3L9.5 8l1.69.976a.75.75 0 0 1-.75 1.298L8.75 9.3v1.951a.75.75 0 0 1-1.5 0V9.299l-1.69.976a.75.75 0 0 1-.75-1.3L6.5 8l-1.69-.975a.75.75 0 0 1 .75-1.3l1.69.976V4.75A.75.75 0 0 1 8 4Z\"/></symbol><use xlink:href=\"#key-asterisk-icon-symbol\" />"}],"s":"<path d=\"M1.5 4.25c0-.966.784-1.75 1.75-1.75h17.5c.966 0 1.75.784 1.75 1.75v12.5a1.75 1.75 0 0 1-1.75 1.75h-9.586a.25.25 0 0 0-.177.073l-3.5 3.5A1.458 1.458 0 0 1 5 21.043V18.5H3.25a1.75 1.75 0 0 1-1.75-1.75ZM3.25 4a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h2.5a.75.75 0 0 1 .75.75v3.19l3.427-3.427A1.75 1.75 0 0 1 11.164 17h9.586a.25.25 0 0 0 .25-.25V4.25a.25.25 0 0 0-.25-.25ZM12 6a.75.75 0 0 1 .75.75v4a.75.75 0 0 1-1.5 0v-4A.75.75 0 0 1 12 6Zm0 9a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"/>"},{"n":"common-settings","l":"Common Settings","s":"<symbol id=\"sliders-icon-symbol\" viewBox=\"0 0 16 16\"><path d=\"M15 2.75a.75.75 0 0 1-.75.75h-4a.75.75 0 0 1 0-1.5h4a.75.75 0 0 1 .75.75Zm-8.5.75v1.25a.75.75 0 0 0 1.5 0v-4a.75.75 0 0 0-1.5 0V2H1.75a.75.75 0 0 0 0 1.5H6.5Zm1.25 5.25a.75.75 0 0 0 0-1.5h-6a.75.75 0 0 0 0 1.5h6ZM15 8a.75.75 0 0 1-.75.75H11.5V10a.75.75 0 1 1-1.5 0V6a.75.75 0 0 1 1.5 0v1.25h2.75A.75.75 0 0 1 15 8Zm-9 5.25v-2a.75.75 0 0 0-1.5 0v1.25H1.75a.75.75 0 0 0 0 1.5H4.5v1.25a.75.75 0 0 0 1.5 0v-2Zm9 0a.75.75 0 0 1-.75.75h-6a.75.75 0 0 1 0-1.5h6a.75.75 0 0 1 .75.75Z\"/></symbol><use xlink:href=\"#sliders-icon-symbol\" />"},{"n":"/usage/api-connections","l":"API Connections","i":[{"n":"/usage/core-concepts/connection-profiles","l":"Connection Profiles","s":"<path d=\"M19.187 3.588a2.75 2.75 0 0 0-3.889 0L5.575 13.31a4.5 4.5 0 0 0 6.364 6.364l8.662-8.662a.75.75 0 0 1 1.061 1.06L13 20.735a6 6 0 0 1-8.485-8.485l9.723-9.723a4.247 4.247 0 0 1 4.124-1.139 4.247 4.247 0 0 1 3.025 3.025 4.247 4.247 0 0 1-1.139 4.124l-9.193 9.193a2.64 2.64 0 0 1-1.858.779 2.626 2.626 0 0 1-1.854-.779c-.196-.196-.338-.47-.43-.726a2.822 2.822 0 0 1-.168-.946c0-.7.284-1.373.775-1.864l8.132-8.131a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734l-8.131 8.132a1.148 1.148 0 0 0-.336.803c.003.204.053.405.146.587.01.018.018.028.02.032.22.215.501.332.786.332.29 0 .58-.121.798-.34l9.192-9.192a2.75 2.75 0 0 0 0-3.89Z\"/>"},{"n":"/usage/how-to-use-a-self-hosted-model","l":"Self-​hosted AI models","s":"<path d=\"M11.25 9.331V.75a.75.75 0 0 1 1.5 0v8.58l1.949-2.11A.75.75 0 1 1 15.8 8.237l-3.25 3.52a.75.75 0 0 1-1.102 0l-3.25-3.52A.75.75 0 1 1 9.3 7.22l1.949 2.111Z\"/><path d=\"M2.5 3.75v11.5c0 .138.112.25.25.25h18.5a.25.25 0 0 0 .25-.25V3.75a.25.25 0 0 0-.25-.25h-5.5a.75.75 0 0 1 0-1.5h5.5c.966 0 1.75.784 1.75 1.75v11.5A1.75 1.75 0 0 1 21.25 17h-6.204c.171 1.375.805 2.652 1.769 3.757A.752.752 0 0 1 16.25 22h-8.5a.75.75 0 0 1-.566-1.243c.965-1.105 1.599-2.382 1.77-3.757H2.75A1.75 1.75 0 0 1 1 15.25V3.75C1 2.784 1.784 2 2.75 2h5.5a.75.75 0 0 1 0 1.5h-5.5a.25.25 0 0 0-.25.25ZM10.463 17c-.126 1.266-.564 2.445-1.223 3.5h5.52c-.66-1.055-1.098-2.234-1.223-3.5Z\"/>"},{"n":"openai","l":"Chat Completions"},{"n":"openrouter","l":"Open​Router"},{"n":"horde","l":"AI Horde"},{"n":"dreamgen","l":"Dream​Gen"},{"n":"koboldcpp","l":"Kobold​Cpp"},{"n":"mancer","l":"Mancer"},{"n":"novelai","l":"Novel​AI"},{"n":"scale","l":"Scale"},{"n":"tabbyapi","l":"Tabby​API"}],"s":"<path d=\"M8.75 19.25a3.25 3.25 0 1 1 6.5 0 3.25 3.25 0 0 1-6.5 0ZM15 4.75a3.25 3.25 0 1 1 6.5 0 3.25 3.25 0 0 1-6.5 0Zm-12.5 0a3.25 3.25 0 1 1 6.5 0 3.25 3.25 0 0 1-6.5 0ZM5.75 6.5a1.75 1.75 0 1 0-.001-3.501A1.75 1.75 0 0 0 5.75 6.5ZM12 21a1.75 1.75 0 1 0-.001-3.501A1.75 1.75 0 0 0 12 21Zm6.25-14.5a1.75 1.75 0 1 0-.001-3.501A1.75 1.75 0 0 0 18.25 6.5Z\"/><path d=\"M6.5 7.75v1A2.25 2.25 0 0 0 8.75 11h6.5a2.25 2.25 0 0 0 2.25-2.25v-1H19v1a3.75 3.75 0 0 1-3.75 3.75h-6.5A3.75 3.75 0 0 1 5 8.75v-1Z\"/><path d=\"M11.25 16.25v-5h1.5v5h-1.5Z\"/>"},{"n":"prompts","l":"Prompts","i":[{"n":"/usage/core-concepts/advancedformatting","l":"Advanced Formatting"},{"n":"context-template","l":"Context Template"},{"n":"/usage/core-concepts/instructmode","l":"Instruct Mode"},{"n":"tokenizer","l":"Tokenizer"},{"n":"cfg","l":"CFG"},{"n":"prompt-manager","l":"Prompt Manager"}],"s":"<path d=\"M10.414 15H3.586l-1.631 4.505a.75.75 0 1 1-1.41-.51l5.08-14.03a1.463 1.463 0 0 1 2.75 0l5.08 14.03a.75.75 0 1 1-1.411.51Zm4.532-5.098c.913-1.683 2.703-2.205 4.284-2.205 1.047 0 2.084.312 2.878.885.801.577 1.392 1.455 1.392 2.548v8.12a.75.75 0 0 1-1.5 0v-.06l-.044.025c-.893.52-2.096.785-3.451.785-1.051 0-2.048-.315-2.795-.948-.76-.643-1.217-1.578-1.217-2.702 0-.919.349-1.861 1.168-2.563.81-.694 2-1.087 3.569-1.087H22v-1.57c0-.503-.263-.967-.769-1.332-.513-.37-1.235-.6-2.001-.6-1.319 0-2.429.43-2.966 1.42a.75.75 0 0 1-1.318-.716ZM9.87 13.5 7 5.572 4.13 13.5Zm12.13.7h-2.77c-1.331 0-2.134.333-2.593.726a1.822 1.822 0 0 0-.644 1.424c0 .689.267 1.203.686 1.557.43.365 1.065.593 1.826.593 1.183 0 2.102-.235 2.697-.581.582-.34.798-.74.798-1.134Z\"/>"},{"n":"/usage/core-concepts/worldinfo","l":"World Info","s":"<path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1Zm3.241 10.5v-.001c-.1-2.708-.992-4.904-1.89-6.452a13.919 13.919 0 0 0-1.304-1.88L12 3.11l-.047.059c-.354.425-.828 1.06-1.304 1.88-.898 1.547-1.79 3.743-1.89 6.451Zm-12.728 0h4.745c.1-3.037 1.1-5.49 2.093-7.204.39-.672.78-1.233 1.119-1.673C6.11 3.329 2.746 7 2.513 11.5Zm18.974 0C21.254 7 17.89 3.329 13.53 2.623c.339.44.729 1.001 1.119 1.673.993 1.714 1.993 4.167 2.093 7.204ZM8.787 13c.182 2.478 1.02 4.5 1.862 5.953.382.661.818 1.29 1.304 1.88l.047.057.047-.059c.354-.425.828-1.06 1.304-1.88.842-1.451 1.679-3.471 1.862-5.951Zm-1.504 0H2.552a9.505 9.505 0 0 0 7.918 8.377 15.773 15.773 0 0 1-1.119-1.673C8.413 18.085 7.47 15.807 7.283 13Zm9.434 0c-.186 2.807-1.13 5.085-2.068 6.704-.39.672-.78 1.233-1.118 1.673A9.506 9.506 0 0 0 21.447 13Z\"/>"},{"n":"/usage/user-settings","l":"User Settings","i":[{"n":"/usage/core-concepts/uicustomization","l":"UI Customization"},{"n":"visual-novel","l":"Visual Novel (VN) Mode"}],"s":"<path d=\"M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0Z\"/><path d=\"M12 1c.266 0 .532.009.797.028.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221.247.089.49.19.728.302.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147.402.349.78.726 1.128 1.129.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315.112.238.213.481.303.728.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512.038.531.038 1.063 0 1.594-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225-.089.248-.19.491-.302.728-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99-.349.402-.726.78-1.129 1.128-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a8.606 8.606 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303-.531.038-1.063.038-1.594 0-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8.138 8.138 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147-.402-.349-.78-.726-1.128-1.129-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a8.606 8.606 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11.158 11.158 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225.089-.248.19-.491.302-.728.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99.349-.402.726-.78 1.129-1.128.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002.238-.112.481-.213.728-.303.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304C11.466 1.01 11.732 1 12 1Zm-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.832 1.832 0 0 1-1.172 1.277 7.147 7.147 0 0 0-.6.249 1.833 1.833 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a9.774 9.774 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7.147 7.147 0 0 0-.249.6 1.831 1.831 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a9.63 9.63 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.832 1.832 0 0 1 1.277 1.172c.074.204.157.404.249.6.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228.301.348.628.675.976.976.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075c.196.093.396.176.6.25a1.831 1.831 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a9.63 9.63 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.834 1.834 0 0 1 1.172-1.278 6.82 6.82 0 0 0 .6-.248 1.831 1.831 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0 .348-.301.675-.628.976-.976.036-.042.06-.131 0-.228l-.776-1.275a1.834 1.834 0 0 1-.075-1.733c.093-.196.176-.396.25-.6a1.831 1.831 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a9.63 9.63 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a6.576 6.576 0 0 0-.248-.6 1.833 1.833 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a9.774 9.774 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.831 1.831 0 0 1-1.733.074 6.88 6.88 0 0 0-.6-.249 1.835 1.835 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a9.63 9.63 0 0 0-1.38 0Z\"/>"},{"n":"/usage/core-concepts/personas","l":"Personas","s":"<path d=\"M8.456 14.494a.75.75 0 0 1 1.068.17 3.08 3.08 0 0 0 .572.492A3.381 3.381 0 0 0 12 15.72c.855 0 1.487-.283 1.904-.562a3.081 3.081 0 0 0 .572-.492l.021-.026a.75.75 0 0 1 1.197.905l-.027.034c-.013.016-.03.038-.052.063-.044.05-.105.119-.184.198a4.569 4.569 0 0 1-.695.566A4.88 4.88 0 0 1 12 17.22a4.88 4.88 0 0 1-2.736-.814 4.57 4.57 0 0 1-.695-.566 3.253 3.253 0 0 1-.236-.261c-.259-.332-.223-.824.123-1.084Z\"/><path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1ZM2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5 9.5 9.5 0 0 0 2.5 12Z\"/><path d=\"M9 10.75a1.25 1.25 0 1 1-2.5 0 1.25 1.25 0 0 1 2.5 0ZM16.25 12a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Z\"/>"},{"n":"characters","l":"Characters","i":[{"n":"/usage/core-concepts/characterdesign","l":"Character Design"},{"n":"/usage/core-concepts/macros","l":"Macros (replacement tags)"},{"n":"/usage/core-concepts/chatfilemanagement","l":"Chat File Management"},{"n":"/usage/core-concepts/groupchats","l":"Group Chats"},{"n":"/usage/core-concepts/tags","l":"Tags"},{"n":"/usage/core-concepts/authors-note","l":"Author's Note"},{"n":"/usage/core-concepts/data-bank","l":"Data Bank (RAG)"}],"s":"<path d=\"M12 2.5a5.25 5.25 0 0 0-2.519 9.857 9.005 9.005 0 0 0-6.477 8.37.75.75 0 0 0 .727.773H20.27a.75.75 0 0 0 .727-.772 9.005 9.005 0 0 0-6.477-8.37A5.25 5.25 0 0 0 12 2.5Z\"/>"}],"s":"<path d=\"M11.75 4.5a.75.75 0 0 1 .75.75V11h5.75a.75.75 0 0 1 0 1.5H12.5v5.75a.75.75 0 0 1-1.5 0V12.5H5.25a.75.75 0 0 1 0-1.5H11V5.25a.75.75 0 0 1 .75-.75Z\"/>"},{"n":"extensions","l":"Extensions","o":true,"i":[{"n":"blip","l":"Blip"},{"n":"translation","l":"Chat Translation"},{"n":"chat-vectorization","l":"Chat Vectorization"},{"n":"dynamic-audio","l":"Dynamic Audio"},{"n":"emulatorjs","l":"Emulator​JS"},{"n":"expression-images","l":"Expression Images"},{"n":"captioning","l":"Image Captioning"},{"n":"stable-diffusion","l":"Image Generation"},{"n":"live2d","l":"Live​2​D"},{"n":"objective","l":"Objective"},{"n":"rvc","l":"Retrieval-​based Voice Conversion (RVC)"},{"n":"speech-recognition","l":"Speech Recognition"},{"n":"summarize","l":"Summarize"},{"n":"tts","l":"TTS"},{"n":"alltalk","l":"All​Talk TTS V​2"},{"n":"xtts","l":"XTTS with voice cloning"},{"n":"vrm","l":"VRM"},{"n":"websearch","l":"Web Search"},{"n":"extras","l":"Extras","i":[{"n":"running-extras-in-colab","l":"Extras via Colab","s":"<path d=\"M3.103 10.107c0-4.244 3.445-7.607 7.733-7.607 3.19 0 5.912 1.858 7.099 4.563l.01.022.001.006C21.348 7.345 24 10.095 24 13.536 24 17.148 21.076 20 17.431 20H5.017C2.23 20 0 17.83 0 15.06a4.899 4.899 0 0 1 3.112-4.581 7.696 7.696 0 0 1-.009-.372ZM10.836 4c-3.485 0-6.233 2.717-6.233 6.107 0 .284.022.602.052.756a.75.75 0 0 1-.552.869c-1.52.385-2.603 1.712-2.603 3.328 0 1.917 1.532 3.44 3.517 3.44h12.414c2.843 0 5.069-2.206 5.069-4.964 0-2.759-2.226-4.965-5.069-4.965a.75.75 0 0 1-.696-.47l-.179-.446C15.606 5.5 13.424 4 10.836 4Z\"/>"},{"n":"installation","l":"Local Installation","i":[{"n":"common-problems","l":"Common Problems","s":"<path d=\"M7.72.22a.75.75 0 0 1 1.06 0l1.204 1.203A4.98 4.98 0 0 1 12 1c.717 0 1.4.151 2.016.423L15.22.22a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-.971.972A4.991 4.991 0 0 1 17 6v1.104a2.755 2.755 0 0 1 1.917 1.974l1.998-.999a.75.75 0 0 1 .67 1.342L19 10.714V13.5l3.25.003a.75.75 0 0 1 0 1.5L19 15.001V16c0 .568-.068 1.134-.204 1.686l.04.018 2.75 1.375a.75.75 0 1 1-.671 1.342l-2.638-1.319A6.998 6.998 0 0 1 12 23a6.998 6.998 0 0 1-6.197-3.742l-2.758 1.181a.752.752 0 0 1-1.064-.776.752.752 0 0 1 .474-.602l2.795-1.199A6.976 6.976 0 0 1 5 16v-.996H1.75a.75.75 0 0 1 0-1.5H5v-2.79L2.415 9.42a.75.75 0 0 1 .67-1.342l1.998.999A2.756 2.756 0 0 1 7 7.104V6a4.99 4.99 0 0 1 1.69-3.748l-.97-.972a.75.75 0 0 1 0-1.06ZM6.5 9.75V16a5.5 5.5 0 1 0 11 0V9.75c0-.69-.56-1.25-1.25-1.25h-8.5c-.69 0-1.25.56-1.25 1.25ZM8.5 7h7V6a3.5 3.5 0 1 0-7 0Z\"/>"}],"s":"<path d=\"M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0Z\"/><path d=\"M12 1c.266 0 .532.009.797.028.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221.247.089.49.19.728.302.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147.402.349.78.726 1.128 1.129.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315.112.238.213.481.303.728.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512.038.531.038 1.063 0 1.594-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225-.089.248-.19.491-.302.728-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99-.349.402-.726.78-1.129 1.128-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a8.606 8.606 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303-.531.038-1.063.038-1.594 0-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8.138 8.138 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147-.402-.349-.78-.726-1.128-1.129-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a8.606 8.606 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11.158 11.158 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225.089-.248.19-.491.302-.728.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99.349-.402.726-.78 1.129-1.128.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002.238-.112.481-.213.728-.303.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304C11.466 1.01 11.732 1 12 1Zm-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.832 1.832 0 0 1-1.172 1.277 7.147 7.147 0 0 0-.6.249 1.833 1.833 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a9.774 9.774 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7.147 7.147 0 0 0-.249.6 1.831 1.831 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a9.63 9.63 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.832 1.832 0 0 1 1.277 1.172c.074.204.157.404.249.6.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228.301.348.628.675.976.976.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075c.196.093.396.176.6.25a1.831 1.831 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a9.63 9.63 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.834 1.834 0 0 1 1.172-1.278 6.82 6.82 0 0 0 .6-.248 1.831 1.831 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0 .348-.301.675-.628.976-.976.036-.042.06-.131 0-.228l-.776-1.275a1.834 1.834 0 0 1-.075-1.733c.093-.196.176-.396.25-.6a1.831 1.831 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a9.63 9.63 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a6.576 6.576 0 0 0-.248-.6 1.833 1.833 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a9.774 9.774 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.831 1.831 0 0 1-1.733.074 6.88 6.88 0 0 0-.6-.249 1.835 1.835 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a9.63 9.63 0 0 0-1.38 0Z\"/>"},{"n":"/extensions/smart-context","l":"Smart Context"},{"n":"/extensions/talkinghead","l":"talkinghead"}],"s":"<path d=\"M15.716 1.329a1.341 1.341 0 0 1 2.109 1.55L15.147 9h4.161c1.623 0 2.372 2.016 1.143 3.075L8.102 22.721a1.148 1.148 0 0 1-1.81-1.317L8.996 15H4.674c-1.619 0-2.37-2.008-1.148-3.07l12.19-10.6Zm.452 1.595L4.51 13.061a.25.25 0 0 0 .164.439h5.45a.749.749 0 0 1 .692 1.041l-2.559 6.066 11.215-9.668a.25.25 0 0 0-.164-.439H14a.75.75 0 0 1-.687-1.05Z\"/>"}],"s":"<path d=\"M7 11.5H2.938c-.794 0-1.438.644-1.438 1.437v8.313a.75.75 0 0 1-1.5 0v-8.312A2.939 2.939 0 0 1 2.937 10H7V6.151c0-.897.678-1.648 1.57-1.74l6.055-.626 1.006-1.174A1.752 1.752 0 0 1 16.96 2h1.29c.966 0 1.75.784 1.75 1.75V6h3.25a.75.75 0 0 1 0 1.5H20V14h3.25a.75.75 0 0 1 0 1.5H20v2.25a1.75 1.75 0 0 1-1.75 1.75h-1.29a1.75 1.75 0 0 1-1.329-.611l-1.006-1.174-6.055-.627A1.749 1.749 0 0 1 7 15.348Zm9.77-7.913v.001l-1.201 1.4a.75.75 0 0 1-.492.258l-6.353.657a.25.25 0 0 0-.224.249v9.196a.25.25 0 0 0 .224.249l6.353.657c.191.02.368.112.493.258l1.2 1.401a.252.252 0 0 0 .19.087h1.29a.25.25 0 0 0 .25-.25v-14a.25.25 0 0 0-.25-.25h-1.29a.252.252 0 0 0-.19.087Z\"/>"},{"n":"/for-contributors","l":"Development and Automation","o":true,"i":[{"n":"/usage/st-script","l":"S​Tscript Language Reference","s":"<path d=\"M3 3a2 2 0 0 1 2-2h9.982a2 2 0 0 1 1.414.586l4.018 4.018A2 2 0 0 1 21 7.018V21a2 2 0 0 1-2 2H4.75a.75.75 0 0 1 0-1.5H19a.5.5 0 0 0 .5-.5V8.5h-4a2 2 0 0 1-2-2v-4H5a.5.5 0 0 0-.5.5v6.25a.75.75 0 0 1-1.5 0Zm6.308 11.5-2.104-2.236a.751.751 0 0 1 .369-1.255.749.749 0 0 1 .723.227l3.294 3.5a.75.75 0 0 1 0 1.028l-3.294 3.5a.749.749 0 0 1-1.275-.293.751.751 0 0 1 .183-.735L9.308 16H4.09a2.59 2.59 0 0 0-2.59 2.59v3.16a.75.75 0 0 1-1.5 0v-3.16a4.09 4.09 0 0 1 4.09-4.09ZM15 2.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 0-.146-.336l-4.018-4.018A.5.5 0 0 0 15 2.5Z\"/>"},{"n":"function-calling","l":"Function Calling","s":"<path d=\"M10.3 6.74a.75.75 0 0 1-.04 1.06l-2.908 2.7 2.908 2.7a.75.75 0 1 1-1.02 1.1l-3.5-3.25a.75.75 0 0 1 0-1.1l3.5-3.25a.75.75 0 0 1 1.06.04Zm3.44 1.06a.75.75 0 1 1 1.02-1.1l3.5 3.25a.75.75 0 0 1 0 1.1l-3.5 3.25a.75.75 0 1 1-1.02-1.1l2.908-2.7-2.908-2.7Z\"/><path d=\"M1.5 4.25c0-.966.784-1.75 1.75-1.75h17.5c.966 0 1.75.784 1.75 1.75v12.5a1.75 1.75 0 0 1-1.75 1.75h-9.69l-3.573 3.573A1.458 1.458 0 0 1 5 21.043V18.5H3.25a1.75 1.75 0 0 1-1.75-1.75ZM3.25 4a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h2.5a.75.75 0 0 1 .75.75v3.19l3.72-3.72a.749.749 0 0 1 .53-.22h10a.25.25 0 0 0 .25-.25V4.25a.25.25 0 0 0-.25-.25Z\"/>"},{"n":"writing-extensions","l":"UI Extensions","s":"<symbol id=\"file-added-icon-symbol\" viewBox=\"0 0 16 16\"><path d=\"M2 1.75C2 .784 2.784 0 3.75 0h6.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v9.586A1.75 1.75 0 0 1 13.25 16h-9.5A1.75 1.75 0 0 1 2 14.25Zm1.75-.25a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h9.5a.25.25 0 0 0 .25-.25V4.664a.25.25 0 0 0-.073-.177l-2.914-2.914a.25.25 0 0 0-.177-.073Zm4.48 3.758a.75.75 0 0 1 .755.745l.01 1.497h1.497a.75.75 0 0 1 0 1.5H9v1.507a.75.75 0 0 1-1.5 0V9.005l-1.502.01a.75.75 0 0 1-.01-1.5l1.507-.01-.01-1.492a.75.75 0 0 1 .745-.755Z\"/></symbol><use xlink:href=\"#file-added-icon-symbol\" />"},{"n":"server-plugins","l":"Server Plugins","s":"<path d=\"M10.75 6.5a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5ZM6 7.25a.75.75 0 0 1 .75-.75h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 6 7.25Zm4 9a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5a.75.75 0 0 1-.75-.75Zm-3.25-.75a.75.75 0 0 0 0 1.5h.5a.75.75 0 0 0 0-1.5h-.5Z\"/><path d=\"M3.25 2h17.5c.966 0 1.75.784 1.75 1.75v7c0 .372-.116.716-.314 1 .198.284.314.628.314 1v7a1.75 1.75 0 0 1-1.75 1.75H3.25a1.75 1.75 0 0 1-1.75-1.75v-7c0-.358.109-.707.314-1a1.741 1.741 0 0 1-.314-1v-7C1.5 2.784 2.284 2 3.25 2Zm0 10.5a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25Zm0-1.5h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25H3.25a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25Z\"/>"},{"n":"i18n","l":"Internationalization (i​18​n)","s":"<path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1Zm3.241 10.5v-.001c-.1-2.708-.992-4.904-1.89-6.452a13.919 13.919 0 0 0-1.304-1.88L12 3.11l-.047.059c-.354.425-.828 1.06-1.304 1.88-.898 1.547-1.79 3.743-1.89 6.451Zm-12.728 0h4.745c.1-3.037 1.1-5.49 2.093-7.204.39-.672.78-1.233 1.119-1.673C6.11 3.329 2.746 7 2.513 11.5Zm18.974 0C21.254 7 17.89 3.329 13.53 2.623c.339.44.729 1.001 1.119 1.673.993 1.714 1.993 4.167 2.093 7.204ZM8.787 13c.182 2.478 1.02 4.5 1.862 5.953.382.661.818 1.29 1.304 1.88l.047.057.047-.059c.354-.425.828-1.06 1.304-1.88.842-1.451 1.679-3.471 1.862-5.951Zm-1.504 0H2.552a9.505 9.505 0 0 0 7.918 8.377 15.773 15.773 0 0 1-1.119-1.673C8.413 18.085 7.47 15.807 7.283 13Zm9.434 0c-.186 2.807-1.13 5.085-2.068 6.704-.39.672-.78 1.233-1.118 1.673A9.506 9.506 0 0 0 21.447 13Z\"/>"}],"s":"<path d=\"M3.045 18.894 9.94 12 3.045 5.106a.75.75 0 0 1 1.06-1.061l7.425 7.425a.75.75 0 0 1 0 1.06l-7.424 7.425a.75.75 0 0 1-1.061-1.06Zm8.205.606a.75.75 0 0 0 0 1.5h9.5a.75.75 0 0 0 0-1.5h-9.5Z\"/>"},{"n":"administration","l":"Administration","o":true,"i":[{"n":"config-yaml","l":"Configuration File","s":"<path d=\"M8.75 8h6.5a.75.75 0 0 1 .75.75v6.5a.75.75 0 0 1-.75.75h-6.5a.75.75 0 0 1-.75-.75v-6.5A.75.75 0 0 1 8.75 8Zm.75 6.5h5v-5h-5Z\"/><path d=\"M15.25 1a.75.75 0 0 1 .75.75V4h2.25c.966 0 1.75.784 1.75 1.75V8h2.25a.75.75 0 0 1 0 1.5H20v5h2.25a.75.75 0 0 1 0 1.5H20v2.25A1.75 1.75 0 0 1 18.25 20H16v2.25a.75.75 0 0 1-1.5 0V20h-5v2.25a.75.75 0 0 1-1.5 0V20H5.75A1.75 1.75 0 0 1 4 18.25V16H1.75a.75.75 0 0 1 0-1.5H4v-5H1.75a.75.75 0 0 1 0-1.5H4V5.75C4 4.784 4.784 4 5.75 4H8V1.75a.75.75 0 0 1 1.5 0V4h5V1.75a.75.75 0 0 1 .75-.75Zm3 17.5a.25.25 0 0 0 .25-.25V5.75a.25.25 0 0 0-.25-.25H5.75a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25Z\"/>"},{"n":"multi-user","l":"Multi-​user mode","s":"<path d=\"M3.5 8a5.5 5.5 0 1 1 8.596 4.547 9.005 9.005 0 0 1 5.9 8.18.751.751 0 0 1-1.5.045 7.5 7.5 0 0 0-14.993 0 .75.75 0 0 1-1.499-.044 9.005 9.005 0 0 1 5.9-8.181A5.496 5.496 0 0 1 3.5 8ZM9 4a4 4 0 1 0 0 8 4 4 0 0 0 0-8Zm8.29 4c-.148 0-.292.01-.434.03a.75.75 0 1 1-.212-1.484 4.53 4.53 0 0 1 3.38 8.097 6.69 6.69 0 0 1 3.956 6.107.75.75 0 0 1-1.5 0 5.193 5.193 0 0 0-3.696-4.972l-.534-.16v-1.676l.41-.209A3.03 3.03 0 0 0 17.29 8Z\"/>"},{"n":"sso","l":"Single Sign-​On (SSO)","s":"<path d=\"M16.75 8.5a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Z\"/><path d=\"M15.75 0a8.25 8.25 0 1 1-2.541 16.101l-1.636 1.636a1.744 1.744 0 0 1-1.237.513H9.25a.25.25 0 0 0-.25.25v1.448a.876.876 0 0 1-.256.619l-.214.213a.75.75 0 0 1-.545.22H5.25a.25.25 0 0 0-.25.25v1A1.75 1.75 0 0 1 3.25 24h-1.5A1.75 1.75 0 0 1 0 22.25v-2.836c0-.464.185-.908.513-1.236l7.386-7.388A8.249 8.249 0 0 1 15.75 0ZM9 8.25a6.733 6.733 0 0 0 .463 2.462.75.75 0 0 1-.168.804l-7.722 7.721a.25.25 0 0 0-.073.177v2.836c0 .138.112.25.25.25h1.5a.25.25 0 0 0 .25-.25v-1c0-.966.784-1.75 1.75-1.75H7.5v-1c0-.966.784-1.75 1.75-1.75h1.086a.25.25 0 0 0 .177-.073l1.971-1.972a.75.75 0 0 1 .804-.168A6.75 6.75 0 1 0 9 8.25Z\"/>"},{"n":"/usage/remoteconnections","l":"Remote connections","s":"<path d=\"M3.5 3.25a.75.75 0 0 1 .75-.75C14.053 2.5 22 10.447 22 20.25a.75.75 0 0 1-1.5 0C20.5 11.275 13.225 4 4.25 4a.75.75 0 0 1-.75-.75Zm.75 6.25C10.187 9.5 15 14.313 15 20.25a.75.75 0 0 1-1.5 0A9.25 9.25 0 0 0 4.25 11a.75.75 0 0 1 0-1.5ZM3.5 19a2 2 0 1 1 3.999-.001A2 2 0 0 1 3.5 19Z\"/>"},{"n":"tunneling","l":"VP​Ns and Tunneling","s":"<path d=\"M6 9V7.25C6 3.845 8.503 1 12 1s6 2.845 6 6.25V9h.5a2.5 2.5 0 0 1 2.5 2.5v8a2.5 2.5 0 0 1-2.5 2.5h-13A2.5 2.5 0 0 1 3 19.5v-8A2.5 2.5 0 0 1 5.5 9Zm-1.5 2.5v8a1 1 0 0 0 1 1h13a1 1 0 0 0 1-1v-8a1 1 0 0 0-1-1h-13a1 1 0 0 0-1 1Zm3-4.25V9h9V7.25c0-2.67-1.922-4.75-4.5-4.75-2.578 0-4.5 2.08-4.5 4.75Z\"/>"},{"n":"/usage/st-reverse-proxy-guide","l":"Reverse proxying","s":"<path d=\"M10.75 6.5a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5ZM6 7.25a.75.75 0 0 1 .75-.75h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 6 7.25Zm4 9a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5a.75.75 0 0 1-.75-.75Zm-3.25-.75a.75.75 0 0 0 0 1.5h.5a.75.75 0 0 0 0-1.5h-.5Z\"/><path d=\"M3.25 2h17.5c.966 0 1.75.784 1.75 1.75v7c0 .372-.116.716-.314 1 .198.284.314.628.314 1v7a1.75 1.75 0 0 1-1.75 1.75H3.25a1.75 1.75 0 0 1-1.75-1.75v-7c0-.358.109-.707.314-1a1.741 1.741 0 0 1-.314-1v-7C1.5 2.784 2.284 2 3.25 2Zm0 10.5a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25Zm0-1.5h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25H3.25a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25Z\"/>"}],"s":"<path d=\"M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0Z\"/><path d=\"M12 1c.266 0 .532.009.797.028.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221.247.089.49.19.728.302.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147.402.349.78.726 1.128 1.129.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315.112.238.213.481.303.728.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512.038.531.038 1.063 0 1.594-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225-.089.248-.19.491-.302.728-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99-.349.402-.726.78-1.129 1.128-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a8.606 8.606 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303-.531.038-1.063.038-1.594 0-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8.138 8.138 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147-.402-.349-.78-.726-1.128-1.129-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a8.606 8.606 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11.158 11.158 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225.089-.248.19-.491.302-.728.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99.349-.402.726-.78 1.129-1.128.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002.238-.112.481-.213.728-.303.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304C11.466 1.01 11.732 1 12 1Zm-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.832 1.832 0 0 1-1.172 1.277 7.147 7.147 0 0 0-.6.249 1.833 1.833 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a9.774 9.774 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7.147 7.147 0 0 0-.249.6 1.831 1.831 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a9.63 9.63 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.832 1.832 0 0 1 1.277 1.172c.074.204.157.404.249.6.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228.301.348.628.675.976.976.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075c.196.093.396.176.6.25a1.831 1.831 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a9.63 9.63 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.834 1.834 0 0 1 1.172-1.278 6.82 6.82 0 0 0 .6-.248 1.831 1.831 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0 .348-.301.675-.628.976-.976.036-.042.06-.131 0-.228l-.776-1.275a1.834 1.834 0 0 1-.075-1.733c.093-.196.176-.396.25-.6a1.831 1.831 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a9.63 9.63 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a6.576 6.576 0 0 0-.248-.6 1.833 1.833 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a9.774 9.774 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.831 1.831 0 0 1-1.733.074 6.88 6.88 0 0 0-.6-.249 1.835 1.835 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a9.63 9.63 0 0 0-1.38 0Z\"/>"},{"n":"licensecredits","l":"License and credits","s":"<path d=\"M12.75 2.75V4.5h1.975c.351 0 .694.106.984.303l1.697 1.154c.041.028.09.043.14.043h4.102a.75.75 0 0 1 0 1.5H20.07l3.366 7.68a.749.749 0 0 1-.23.896c-.1.074-.203.143-.31.206a6.296 6.296 0 0 1-.79.399 7.349 7.349 0 0 1-2.856.569 7.343 7.343 0 0 1-2.855-.568 6.205 6.205 0 0 1-.79-.4 3.205 3.205 0 0 1-.307-.202l-.005-.004a.749.749 0 0 1-.23-.896l3.368-7.68h-.886c-.351 0-.694-.106-.984-.303l-1.697-1.154a.246.246 0 0 0-.14-.043H12.75v14.5h4.487a.75.75 0 0 1 0 1.5H6.763a.75.75 0 0 1 0-1.5h4.487V6H9.275a.249.249 0 0 0-.14.043L7.439 7.197c-.29.197-.633.303-.984.303h-.886l3.368 7.68a.75.75 0 0 1-.209.878c-.08.065-.16.126-.31.223a6.077 6.077 0 0 1-.792.433 6.924 6.924 0 0 1-2.876.62 6.913 6.913 0 0 1-2.876-.62 6.077 6.077 0 0 1-.792-.433 3.483 3.483 0 0 1-.309-.221.762.762 0 0 1-.21-.88L3.93 7.5H2.353a.75.75 0 0 1 0-1.5h4.102c.05 0 .099-.015.141-.043l1.695-1.154c.29-.198.634-.303.985-.303h1.974V2.75a.75.75 0 0 1 1.5 0ZM2.193 15.198a5.414 5.414 0 0 0 2.557.635 5.414 5.414 0 0 0 2.557-.635L4.75 9.368Zm14.51-.024c.082.04.174.083.275.126.53.223 1.305.45 2.272.45a5.847 5.847 0 0 0 2.547-.576L19.25 9.367Z\"/>"}],"search":{"mode":0,"minChars":2,"maxResults":20,"placeholder":"Search","hotkeys":["k"],"noResultsFoundMsg":"Sorry, no results found.","recognizeLanguages":true,"languages":[0],"preload":false},"resources":{"History_Title_Label":"History","History_ClearLink_Label":"Clear","History_NoHistory_Label":"No history items","API_AccessFilter_Label":"Access","API_ParameterSection_Label":"PARAMETERS","API_SignatureSection_Label":"SIGNATURE","API_CopyHint_Label":"Copy","API_CopyNameHint_Label":"Copy name","API_CopyLinkHint_Label":"Copy link","API_CopiedAckHint_Label":"Copied!","API_MoreOverloads_Label":"more","API_MoreDropdownItems_Label":"More","API_OptionalParameter_Label":"optional","API_DefaultParameterValue_Label":"Default value","API_InheritedFilter_Label":"Inherited","Search_Input_Placeholder":"Search","Toc_Contents_Label":"Contents","Toc_RelatedClasses_Label":"Related Classes","History_JustNowTime_Label":"just now","History_AgoTime_Label":"ago","History_YearTime_Label":"y","History_MonthTime_Label":"mo","History_DayTime_Label":"d","History_HourTime_Label":"h","History_MinuteTime_Label":"m","History_SecondTime_Label":"s"}};
+var __DOCS_CONFIG__ = {"id":"64fVH285F2OtHy1wNcoNwXASz+8TiCOFPBC","key":"X6b9jo4fGxz1tDBoFZrNYvxHL/f/Mzn43wQnaa5lQbA.tewV5LinrwcdHWJADKn26GDs0VT+8K0p+2psSbtWBhTlokx1g+PqyqixQHig/+kvuZgzZdRzoPqExFhoF2oeLg.8274","base":"/","host":"docs.sillytavern.app","version":"1.0.0","useRelativePaths":true,"documentName":"index.html","appendDocumentName":false,"trailingSlash":true,"preloadSearch":false,"cacheBustingToken":"3.6.0.790895867607","cacheBustingStrategy":"query","sidebarFilterPlaceholder":"Filter","toolbarFilterPlaceholder":"Filter","showSidebarFilter":true,"filterNotFoundMsg":"No member names found containing the query \"{query}\"","maxHistoryItems":15,"homeIcon":"<path d=\"M12.97 2.59a1.5 1.5 0 00-1.94 221 0l-7.5 6.363A1.5 1.5 0 003 10.097V19.5A1.5 1.5 0 004.5 21h4.75a.75.75 0 00.75-.75V14h4v6.25c0 .414.336.75.75.75h4.75a1.5 1.5 0 001.5-1.5v-9.403a1.5 1.5 0 00-.53-1.144l-7.5-6.363z\"></path>","access":[{"value":"public","label":"Public"},{"value":"protected","label":"Protected"}],"toolbarLinks":[{"id":"fields","label":"Fields"},{"id":"properties","label":"Properties"},{"id":"methods","label":"Methods"},{"id":"events","label":"Events"}],"sidebar":[{"n":"/","l":"What is Silly​Tavern?"},{"n":"installation","l":"Installation","o":true,"i":[{"n":"windows","l":"Windows"},{"n":"linuxmacos","l":"Mac​OS & Linux"},{"n":"/installation/android-(termux)","l":"Android (Termux)"},{"n":"docker","l":"Docker"},{"n":"updating","l":"Updating","i":[{"n":"/installation/st-1.12.0-migration-guide","l":"1.​12.​0 Migration Guide"},{"n":"migration-guide-1-09","l":"1.​9.​0 Migration Guide"}],"s":"<path d=\"M1.875 2.875a2.5 2.5 0 0 1 2.5-2.5h14a.75.75 0 0 1 .75.75v9.125a.75.75 0 0 1-1.5 0V1.875H4.375a1 1 0 0 0-1 1v11.208a2.486 2.486 0 0 1 1-.208h5.937a.75.75 0 1 1 0 1.5H4.375a1 1 0 0 0-1 1v1.75a1 1 0 0 0 1 1h6a.75.75 0 0 1 0 1.5h-6a2.5 2.5 0 0 1-2.5-2.5V2.875Z\"/><path d=\"M18.643 20.484a.749.749 0 1 0 1.061 1.06l3.757-3.757a.75.75 0 0 0 0-1.06l-3.757-3.757a.75.75 0 0 0-1.061 1.06l2.476 2.477H13a.75.75 0 0 0 0 1.5h8.12l-2.477 2.477Z\"/>"}],"s":"<path d=\"M12.876.64V.639l8.25 4.763c.541.313.875.89.875 1.515v9.525a1.75 1.75 0 0 1-.875 1.516l-8.25 4.762a1.748 1.748 0 0 1-1.75 0l-8.25-4.763a1.75 1.75 0 0 1-.875-1.515V6.917c0-.625.334-1.202.875-1.515L11.126.64a1.748 1.748 0 0 1 1.75 0Zm-1 1.298L4.251 6.34l7.75 4.474 7.75-4.474-7.625-4.402a.248.248 0 0 0-.25 0Zm.875 19.123 7.625-4.402a.25.25 0 0 0 .125-.216V7.639l-7.75 4.474ZM3.501 7.64v8.803c0 .09.048.172.125.216l7.625 4.402v-8.947Z\"/>"},{"n":"usage","l":"Usage","o":true,"i":[{"n":"quick-start","l":"Quick Start","s":"<path d=\"M20.322.75h1.176a1.75 1.75 0 0 1 1.75 1.749v1.177a10.75 10.75 0 0 1-2.925 7.374l-1.228 1.304a23.699 23.699 0 0 1-1.596 1.542v5.038c0 .615-.323 1.184-.85 1.5l-4.514 2.709a.75.75 0 0 1-1.12-.488l-.963-4.572a1.305 1.305 0 0 1-.14-.129L8.04 15.96l-1.994-1.873a1.305 1.305 0 0 1-.129-.14l-4.571-.963a.75.75 0 0 1-.49-1.12l2.71-4.514c.316-.527.885-.85 1.5-.85h5.037a23.668 23.668 0 0 1 1.542-1.594l1.304-1.23A10.753 10.753 0 0 1 20.321.75Zm-6.344 4.018v-.001l-1.304 1.23a22.275 22.275 0 0 0-3.255 3.851l-2.193 3.29 1.859 1.744a.545.545 0 0 1 .034.034l1.743 1.858 3.288-2.192a22.263 22.263 0 0 0 3.854-3.257l1.228-1.303a9.251 9.251 0 0 0 2.517-6.346V2.5a.25.25 0 0 0-.25-.25h-1.177a9.252 9.252 0 0 0-6.344 2.518ZM6.5 21c-1.209 1.209-3.901 1.445-4.743 1.49a.236.236 0 0 1-.18-.067.236.236 0 0 1-.067-.18c.045-.842.281-3.534 1.49-4.743.9-.9 2.6-.9 3.5 0 .9.9.9 2.6 0 3.5Zm-.592-8.588L8.17 9.017c.23-.346.47-.685.717-1.017H5.066a.25.25 0 0 0-.214.121l-2.167 3.612ZM16 15.112c-.333.248-.672.487-1.018.718l-3.393 2.262.678 3.223 3.612-2.167a.25.25 0 0 0 .121-.214ZM17.5 8a1.5 1.5 0 1 1-3.001-.001A1.5 1.5 0 0 1 17.5 8Z\"/>"},{"n":"faq","l":"FAQ","s":"<path d=\"M10.97 8.265a1.45 1.45 0 0 0-.487.57.75.75 0 0 1-1.341-.67c.2-.402.513-.826.997-1.148C10.627 6.69 11.244 6.5 12 6.5c.658 0 1.369.195 1.934.619a2.45 2.45 0 0 1 1.004 2.006c0 1.033-.513 1.72-1.027 2.215-.19.183-.399.358-.579.508l-.147.123a4.329 4.329 0 0 0-.435.409v1.37a.75.75 0 1 1-1.5 0v-1.473c0-.237.067-.504.247-.736.22-.28.486-.517.718-.714l.183-.153.001-.001c.172-.143.324-.27.47-.412.368-.355.569-.676.569-1.136a.953.953 0 0 0-.404-.806C12.766 8.118 12.384 8 12 8c-.494 0-.814.121-1.03.265ZM13 17a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z\"/><path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1ZM2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5 9.5 9.5 0 0 0 2.5 12Z\"/>"},{"n":"chatting","l":"Chatting","i":[{"n":"/usage/core-concepts/slashcommands","l":"Slash commands","s":"<path d=\"M19.564 4.42a.75.75 0 0 0-1.378-.59l-6.75 15.75a.75.75 0 0 0 1.378.59l6.75-15.75ZM7 18.5a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0Z\"/>"},{"n":"/usage/hotkeys","l":"Hot​Keys","s":"<symbol id=\"key-asterisk-icon-symbol\" viewBox=\"0 0 16 16\"><path d=\"M0 2.75A2.75 2.75 0 0 1 2.75 0h10.5A2.75 2.75 0 0 1 16 2.75v10.5A2.75 2.75 0 0 1 13.25 16H2.75A2.75 2.75 0 0 1 0 13.25ZM2.75 1.5c-.69 0-1.25.56-1.25 1.25v10.5c0 .69.56 1.25 1.25 1.25h10.5c.69 0 1.25-.56 1.25-1.25V2.75c0-.69-.56-1.25-1.25-1.25Z\"/><path d=\"M8 4a.75.75 0 0 1 .75.75V6.7l1.69-.975a.75.75 0 0 1 .75 1.3L9.5 8l1.69.976a.75.75 0 0 1-.75 1.298L8.75 9.3v1.951a.75.75 0 0 1-1.5 0V9.299l-1.69.976a.75.75 0 0 1-.75-1.3L6.5 8l-1.69-.975a.75.75 0 0 1 .75-1.3l1.69.976V4.75A.75.75 0 0 1 8 4Z\"/></symbol><use xlink:href=\"#key-asterisk-icon-symbol\" />"}],"s":"<path d=\"M1.5 4.25c0-.966.784-1.75 1.75-1.75h17.5c.966 0 1.75.784 1.75 1.75v12.5a1.75 1.75 0 0 1-1.75 1.75h-9.586a.25.25 0 0 0-.177.073l-3.5 3.5A1.458 1.458 0 0 1 5 21.043V18.5H3.25a1.75 1.75 0 0 1-1.75-1.75ZM3.25 4a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h2.5a.75.75 0 0 1 .75.75v3.19l3.427-3.427A1.75 1.75 0 0 1 11.164 17h9.586a.25.25 0 0 0 .25-.25V4.25a.25.25 0 0 0-.25-.25ZM12 6a.75.75 0 0 1 .75.75v4a.75.75 0 0 1-1.5 0v-4A.75.75 0 0 1 12 6Zm0 9a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"/>"},{"n":"common-settings","l":"Common Settings","s":"<symbol id=\"sliders-icon-symbol\" viewBox=\"0 0 16 16\"><path d=\"M15 2.75a.75.75 0 0 1-.75.75h-4a.75.75 0 0 1 0-1.5h4a.75.75 0 0 1 .75.75Zm-8.5.75v1.25a.75.75 0 0 0 1.5 0v-4a.75.75 0 0 0-1.5 0V2H1.75a.75.75 0 0 0 0 1.5H6.5Zm1.25 5.25a.75.75 0 0 0 0-1.5h-6a.75.75 0 0 0 0 1.5h6ZM15 8a.75.75 0 0 1-.75.75H11.5V10a.75.75 0 1 1-1.5 0V6a.75.75 0 0 1 1.5 0v1.25h2.75A.75.75 0 0 1 15 8Zm-9 5.25v-2a.75.75 0 0 0-1.5 0v1.25H1.75a.75.75 0 0 0 0 1.5H4.5v1.25a.75.75 0 0 0 1.5 0v-2Zm9 0a.75.75 0 0 1-.75.75h-6a.75.75 0 0 1 0-1.5h6a.75.75 0 0 1 .75.75Z\"/></symbol><use xlink:href=\"#sliders-icon-symbol\" />"},{"n":"/usage/api-connections","l":"API Connections","i":[{"n":"/usage/core-concepts/connection-profiles","l":"Connection Profiles","s":"<path d=\"M19.187 3.588a2.75 2.75 0 0 0-3.889 0L5.575 13.31a4.5 4.5 0 0 0 6.364 6.364l8.662-8.662a.75.75 0 0 1 1.061 1.06L13 20.735a6 6 0 0 1-8.485-8.485l9.723-9.723a4.247 4.247 0 0 1 4.124-1.139 4.247 4.247 0 0 1 3.025 3.025 4.247 4.247 0 0 1-1.139 4.124l-9.193 9.193a2.64 2.64 0 0 1-1.858.779 2.626 2.626 0 0 1-1.854-.779c-.196-.196-.338-.47-.43-.726a2.822 2.822 0 0 1-.168-.946c0-.7.284-1.373.775-1.864l8.132-8.131a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734l-8.131 8.132a1.148 1.148 0 0 0-.336.803c.003.204.053.405.146.587.01.018.018.028.02.032.22.215.501.332.786.332.29 0 .58-.121.798-.34l9.192-9.192a2.75 2.75 0 0 0 0-3.89Z\"/>"},{"n":"/usage/how-to-use-a-self-hosted-model","l":"Self-​hosted AI models","s":"<path d=\"M11.25 9.331V.75a.75.75 0 0 1 1.5 0v8.58l1.949-2.11A.75.75 0 1 1 15.8 8.237l-3.25 3.52a.75.75 0 0 1-1.102 0l-3.25-3.52A.75.75 0 1 1 9.3 7.22l1.949 2.111Z\"/><path d=\"M2.5 3.75v11.5c0 .138.112.25.25.25h18.5a.25.25 0 0 0 .25-.25V3.75a.25.25 0 0 0-.25-.25h-5.5a.75.75 0 0 1 0-1.5h5.5c.966 0 1.75.784 1.75 1.75v11.5A1.75 1.75 0 0 1 21.25 17h-6.204c.171 1.375.805 2.652 1.769 3.757A.752.752 0 0 1 16.25 22h-8.5a.75.75 0 0 1-.566-1.243c.965-1.105 1.599-2.382 1.77-3.757H2.75A1.75 1.75 0 0 1 1 15.25V3.75C1 2.784 1.784 2 2.75 2h5.5a.75.75 0 0 1 0 1.5h-5.5a.25.25 0 0 0-.25.25ZM10.463 17c-.126 1.266-.564 2.445-1.223 3.5h5.52c-.66-1.055-1.098-2.234-1.223-3.5Z\"/>"},{"n":"openai","l":"Chat Completions"},{"n":"openrouter","l":"Open​Router"},{"n":"horde","l":"AI Horde"},{"n":"dreamgen","l":"Dream​Gen"},{"n":"koboldcpp","l":"Kobold​Cpp"},{"n":"mancer","l":"Mancer"},{"n":"novelai","l":"Novel​AI"},{"n":"scale","l":"Scale"},{"n":"tabbyapi","l":"Tabby​API"}],"s":"<path d=\"M8.75 19.25a3.25 3.25 0 1 1 6.5 0 3.25 3.25 0 0 1-6.5 0ZM15 4.75a3.25 3.25 0 1 1 6.5 0 3.25 3.25 0 0 1-6.5 0Zm-12.5 0a3.25 3.25 0 1 1 6.5 0 3.25 3.25 0 0 1-6.5 0ZM5.75 6.5a1.75 1.75 0 1 0-.001-3.501A1.75 1.75 0 0 0 5.75 6.5ZM12 21a1.75 1.75 0 1 0-.001-3.501A1.75 1.75 0 0 0 12 21Zm6.25-14.5a1.75 1.75 0 1 0-.001-3.501A1.75 1.75 0 0 0 18.25 6.5Z\"/><path d=\"M6.5 7.75v1A2.25 2.25 0 0 0 8.75 11h6.5a2.25 2.25 0 0 0 2.25-2.25v-1H19v1a3.75 3.75 0 0 1-3.75 3.75h-6.5A3.75 3.75 0 0 1 5 8.75v-1Z\"/><path d=\"M11.25 16.25v-5h1.5v5h-1.5Z\"/>"},{"n":"prompts","l":"Prompts","i":[{"n":"/usage/core-concepts/advancedformatting","l":"Advanced Formatting"},{"n":"context-template","l":"Context Template"},{"n":"/usage/core-concepts/instructmode","l":"Instruct Mode"},{"n":"tokenizer","l":"Tokenizer"},{"n":"cfg","l":"CFG"},{"n":"prompt-manager","l":"Prompt Manager"}],"s":"<path d=\"M10.414 15H3.586l-1.631 4.505a.75.75 0 1 1-1.41-.51l5.08-14.03a1.463 1.463 0 0 1 2.75 0l5.08 14.03a.75.75 0 1 1-1.411.51Zm4.532-5.098c.913-1.683 2.703-2.205 4.284-2.205 1.047 0 2.084.312 2.878.885.801.577 1.392 1.455 1.392 2.548v8.12a.75.75 0 0 1-1.5 0v-.06l-.044.025c-.893.52-2.096.785-3.451.785-1.051 0-2.048-.315-2.795-.948-.76-.643-1.217-1.578-1.217-2.702 0-.919.349-1.861 1.168-2.563.81-.694 2-1.087 3.569-1.087H22v-1.57c0-.503-.263-.967-.769-1.332-.513-.37-1.235-.6-2.001-.6-1.319 0-2.429.43-2.966 1.42a.75.75 0 0 1-1.318-.716ZM9.87 13.5 7 5.572 4.13 13.5Zm12.13.7h-2.77c-1.331 0-2.134.333-2.593.726a1.822 1.822 0 0 0-.644 1.424c0 .689.267 1.203.686 1.557.43.365 1.065.593 1.826.593 1.183 0 2.102-.235 2.697-.581.582-.34.798-.74.798-1.134Z\"/>"},{"n":"/usage/core-concepts/worldinfo","l":"World Info","s":"<path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1Zm3.241 10.5v-.001c-.1-2.708-.992-4.904-1.89-6.452a13.919 13.919 0 0 0-1.304-1.88L12 3.11l-.047.059c-.354.425-.828 1.06-1.304 1.88-.898 1.547-1.79 3.743-1.89 6.451Zm-12.728 0h4.745c.1-3.037 1.1-5.49 2.093-7.204.39-.672.78-1.233 1.119-1.673C6.11 3.329 2.746 7 2.513 11.5Zm18.974 0C21.254 7 17.89 3.329 13.53 2.623c.339.44.729 1.001 1.119 1.673.993 1.714 1.993 4.167 2.093 7.204ZM8.787 13c.182 2.478 1.02 4.5 1.862 5.953.382.661.818 1.29 1.304 1.88l.047.057.047-.059c.354-.425.828-1.06 1.304-1.88.842-1.451 1.679-3.471 1.862-5.951Zm-1.504 0H2.552a9.505 9.505 0 0 0 7.918 8.377 15.773 15.773 0 0 1-1.119-1.673C8.413 18.085 7.47 15.807 7.283 13Zm9.434 0c-.186 2.807-1.13 5.085-2.068 6.704-.39.672-.78 1.233-1.118 1.673A9.506 9.506 0 0 0 21.447 13Z\"/>"},{"n":"/usage/user-settings","l":"User Settings","i":[{"n":"/usage/core-concepts/uicustomization","l":"UI Customization"},{"n":"visual-novel","l":"Visual Novel (VN) Mode"}],"s":"<path d=\"M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0Z\"/><path d=\"M12 1c.266 0 .532.009.797.028.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221.247.089.49.19.728.302.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147.402.349.78.726 1.128 1.129.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315.112.238.213.481.303.728.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512.038.531.038 1.063 0 1.594-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225-.089.248-.19.491-.302.728-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99-.349.402-.726.78-1.129 1.128-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a8.606 8.606 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303-.531.038-1.063.038-1.594 0-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8.138 8.138 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147-.402-.349-.78-.726-1.128-1.129-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a8.606 8.606 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11.158 11.158 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225.089-.248.19-.491.302-.728.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99.349-.402.726-.78 1.129-1.128.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002.238-.112.481-.213.728-.303.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304C11.466 1.01 11.732 1 12 1Zm-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.832 1.832 0 0 1-1.172 1.277 7.147 7.147 0 0 0-.6.249 1.833 1.833 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a9.774 9.774 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7.147 7.147 0 0 0-.249.6 1.831 1.831 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a9.63 9.63 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.832 1.832 0 0 1 1.277 1.172c.074.204.157.404.249.6.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228.301.348.628.675.976.976.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075c.196.093.396.176.6.25a1.831 1.831 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a9.63 9.63 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.834 1.834 0 0 1 1.172-1.278 6.82 6.82 0 0 0 .6-.248 1.831 1.831 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0 .348-.301.675-.628.976-.976.036-.042.06-.131 0-.228l-.776-1.275a1.834 1.834 0 0 1-.075-1.733c.093-.196.176-.396.25-.6a1.831 1.831 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a9.63 9.63 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a6.576 6.576 0 0 0-.248-.6 1.833 1.833 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a9.774 9.774 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.831 1.831 0 0 1-1.733.074 6.88 6.88 0 0 0-.6-.249 1.835 1.835 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a9.63 9.63 0 0 0-1.38 0Z\"/>"},{"n":"/usage/core-concepts/personas","l":"Personas","s":"<path d=\"M8.456 14.494a.75.75 0 0 1 1.068.17 3.08 3.08 0 0 0 .572.492A3.381 3.381 0 0 0 12 15.72c.855 0 1.487-.283 1.904-.562a3.081 3.081 0 0 0 .572-.492l.021-.026a.75.75 0 0 1 1.197.905l-.027.034c-.013.016-.03.038-.052.063-.044.05-.105.119-.184.198a4.569 4.569 0 0 1-.695.566A4.88 4.88 0 0 1 12 17.22a4.88 4.88 0 0 1-2.736-.814 4.57 4.57 0 0 1-.695-.566 3.253 3.253 0 0 1-.236-.261c-.259-.332-.223-.824.123-1.084Z\"/><path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1ZM2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5 9.5 9.5 0 0 0 2.5 12Z\"/><path d=\"M9 10.75a1.25 1.25 0 1 1-2.5 0 1.25 1.25 0 0 1 2.5 0ZM16.25 12a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Z\"/>"},{"n":"characters","l":"Characters","i":[{"n":"/usage/core-concepts/characterdesign","l":"Character Design"},{"n":"/usage/core-concepts/macros","l":"Macros (replacement tags)"},{"n":"/usage/core-concepts/chatfilemanagement","l":"Chat File Management"},{"n":"/usage/core-concepts/groupchats","l":"Group Chats"},{"n":"/usage/core-concepts/tags","l":"Tags"},{"n":"/usage/core-concepts/authors-note","l":"Author's Note"},{"n":"/usage/core-concepts/data-bank","l":"Data Bank (RAG)"}],"s":"<path d=\"M12 2.5a5.25 5.25 0 0 0-2.519 9.857 9.005 9.005 0 0 0-6.477 8.37.75.75 0 0 0 .727.773H20.27a.75.75 0 0 0 .727-.772 9.005 9.005 0 0 0-6.477-8.37A5.25 5.25 0 0 0 12 2.5Z\"/>"}],"s":"<path d=\"M11.75 4.5a.75.75 0 0 1 .75.75V11h5.75a.75.75 0 0 1 0 1.5H12.5v5.75a.75.75 0 0 1-1.5 0V12.5H5.25a.75.75 0 0 1 0-1.5H11V5.25a.75.75 0 0 1 .75-.75Z\"/>"},{"n":"extensions","l":"Extensions","o":true,"i":[{"n":"blip","l":"Blip"},{"n":"translation","l":"Chat Translation"},{"n":"chat-vectorization","l":"Chat Vectorization"},{"n":"dynamic-audio","l":"Dynamic Audio"},{"n":"emulatorjs","l":"Emulator​JS"},{"n":"expression-images","l":"Expression Images"},{"n":"captioning","l":"Image Captioning"},{"n":"stable-diffusion","l":"Image Generation"},{"n":"live2d","l":"Live​2​D"},{"n":"objective","l":"Objective"},{"n":"rvc","l":"Retrieval-​based Voice Conversion (RVC)"},{"n":"speech-recognition","l":"Speech Recognition"},{"n":"summarize","l":"Summarize"},{"n":"tts","l":"TTS"},{"n":"alltalk","l":"All​Talk TTS V​2"},{"n":"xtts","l":"XTTS with voice cloning"},{"n":"vrm","l":"VRM"},{"n":"websearch","l":"Web Search"},{"n":"extras","l":"Extras","i":[{"n":"running-extras-in-colab","l":"Extras via Colab","s":"<path d=\"M3.103 10.107c0-4.244 3.445-7.607 7.733-7.607 3.19 0 5.912 1.858 7.099 4.563l.01.022.001.006C21.348 7.345 24 10.095 24 13.536 24 17.148 21.076 20 17.431 20H5.017C2.23 20 0 17.83 0 15.06a4.899 4.899 0 0 1 3.112-4.581 7.696 7.696 0 0 1-.009-.372ZM10.836 4c-3.485 0-6.233 2.717-6.233 6.107 0 .284.022.602.052.756a.75.75 0 0 1-.552.869c-1.52.385-2.603 1.712-2.603 3.328 0 1.917 1.532 3.44 3.517 3.44h12.414c2.843 0 5.069-2.206 5.069-4.964 0-2.759-2.226-4.965-5.069-4.965a.75.75 0 0 1-.696-.47l-.179-.446C15.606 5.5 13.424 4 10.836 4Z\"/>"},{"n":"installation","l":"Local Installation","i":[{"n":"common-problems","l":"Common Problems","s":"<path d=\"M7.72.22a.75.75 0 0 1 1.06 0l1.204 1.203A4.98 4.98 0 0 1 12 1c.717 0 1.4.151 2.016.423L15.22.22a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-.971.972A4.991 4.991 0 0 1 17 6v1.104a2.755 2.755 0 0 1 1.917 1.974l1.998-.999a.75.75 0 0 1 .67 1.342L19 10.714V13.5l3.25.003a.75.75 0 0 1 0 1.5L19 15.001V16c0 .568-.068 1.134-.204 1.686l.04.018 2.75 1.375a.75.75 0 1 1-.671 1.342l-2.638-1.319A6.998 6.998 0 0 1 12 23a6.998 6.998 0 0 1-6.197-3.742l-2.758 1.181a.752.752 0 0 1-1.064-.776.752.752 0 0 1 .474-.602l2.795-1.199A6.976 6.976 0 0 1 5 16v-.996H1.75a.75.75 0 0 1 0-1.5H5v-2.79L2.415 9.42a.75.75 0 0 1 .67-1.342l1.998.999A2.756 2.756 0 0 1 7 7.104V6a4.99 4.99 0 0 1 1.69-3.748l-.97-.972a.75.75 0 0 1 0-1.06ZM6.5 9.75V16a5.5 5.5 0 1 0 11 0V9.75c0-.69-.56-1.25-1.25-1.25h-8.5c-.69 0-1.25.56-1.25 1.25ZM8.5 7h7V6a3.5 3.5 0 1 0-7 0Z\"/>"}],"s":"<path d=\"M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0Z\"/><path d=\"M12 1c.266 0 .532.009.797.028.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221.247.089.49.19.728.302.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147.402.349.78.726 1.128 1.129.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315.112.238.213.481.303.728.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512.038.531.038 1.063 0 1.594-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225-.089.248-.19.491-.302.728-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99-.349.402-.726.78-1.129 1.128-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a8.606 8.606 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303-.531.038-1.063.038-1.594 0-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8.138 8.138 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147-.402-.349-.78-.726-1.128-1.129-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a8.606 8.606 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11.158 11.158 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225.089-.248.19-.491.302-.728.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99.349-.402.726-.78 1.129-1.128.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002.238-.112.481-.213.728-.303.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304C11.466 1.01 11.732 1 12 1Zm-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.832 1.832 0 0 1-1.172 1.277 7.147 7.147 0 0 0-.6.249 1.833 1.833 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a9.774 9.774 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7.147 7.147 0 0 0-.249.6 1.831 1.831 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a9.63 9.63 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.832 1.832 0 0 1 1.277 1.172c.074.204.157.404.249.6.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228.301.348.628.675.976.976.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075c.196.093.396.176.6.25a1.831 1.831 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a9.63 9.63 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.834 1.834 0 0 1 1.172-1.278 6.82 6.82 0 0 0 .6-.248 1.831 1.831 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0 .348-.301.675-.628.976-.976.036-.042.06-.131 0-.228l-.776-1.275a1.834 1.834 0 0 1-.075-1.733c.093-.196.176-.396.25-.6a1.831 1.831 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a9.63 9.63 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a6.576 6.576 0 0 0-.248-.6 1.833 1.833 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a9.774 9.774 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.831 1.831 0 0 1-1.733.074 6.88 6.88 0 0 0-.6-.249 1.835 1.835 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a9.63 9.63 0 0 0-1.38 0Z\"/>"},{"n":"/extensions/smart-context","l":"Smart Context"},{"n":"/extensions/talkinghead","l":"talkinghead"}],"s":"<path d=\"M15.716 1.329a1.341 1.341 0 0 1 2.109 1.55L15.147 9h4.161c1.623 0 2.372 2.016 1.143 3.075L8.102 22.721a1.148 1.148 0 0 1-1.81-1.317L8.996 15H4.674c-1.619 0-2.37-2.008-1.148-3.07l12.19-10.6Zm.452 1.595L4.51 13.061a.25.25 0 0 0 .164.439h5.45a.749.749 0 0 1 .692 1.041l-2.559 6.066 11.215-9.668a.25.25 0 0 0-.164-.439H14a.75.75 0 0 1-.687-1.05Z\"/>"}],"s":"<path d=\"M7 11.5H2.938c-.794 0-1.438.644-1.438 1.437v8.313a.75.75 0 0 1-1.5 0v-8.312A2.939 2.939 0 0 1 2.937 10H7V6.151c0-.897.678-1.648 1.57-1.74l6.055-.626 1.006-1.174A1.752 1.752 0 0 1 16.96 2h1.29c.966 0 1.75.784 1.75 1.75V6h3.25a.75.75 0 0 1 0 1.5H20V14h3.25a.75.75 0 0 1 0 1.5H20v2.25a1.75 1.75 0 0 1-1.75 1.75h-1.29a1.75 1.75 0 0 1-1.329-.611l-1.006-1.174-6.055-.627A1.749 1.749 0 0 1 7 15.348Zm9.77-7.913v.001l-1.201 1.4a.75.75 0 0 1-.492.258l-6.353.657a.25.25 0 0 0-.224.249v9.196a.25.25 0 0 0 .224.249l6.353.657c.191.02.368.112.493.258l1.2 1.401a.252.252 0 0 0 .19.087h1.29a.25.25 0 0 0 .25-.25v-14a.25.25 0 0 0-.25-.25h-1.29a.252.252 0 0 0-.19.087Z\"/>"},{"n":"/for-contributors","l":"Development and Automation","o":true,"i":[{"n":"/usage/st-script","l":"S​Tscript Language Reference","s":"<path d=\"M3 3a2 2 0 0 1 2-2h9.982a2 2 0 0 1 1.414.586l4.018 4.018A2 2 0 0 1 21 7.018V21a2 2 0 0 1-2 2H4.75a.75.75 0 0 1 0-1.5H19a.5.5 0 0 0 .5-.5V8.5h-4a2 2 0 0 1-2-2v-4H5a.5.5 0 0 0-.5.5v6.25a.75.75 0 0 1-1.5 0Zm6.308 11.5-2.104-2.236a.751.751 0 0 1 .369-1.255.749.749 0 0 1 .723.227l3.294 3.5a.75.75 0 0 1 0 1.028l-3.294 3.5a.749.749 0 0 1-1.275-.293.751.751 0 0 1 .183-.735L9.308 16H4.09a2.59 2.59 0 0 0-2.59 2.59v3.16a.75.75 0 0 1-1.5 0v-3.16a4.09 4.09 0 0 1 4.09-4.09ZM15 2.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 0-.146-.336l-4.018-4.018A.5.5 0 0 0 15 2.5Z\"/>"},{"n":"function-calling","l":"Function Calling","s":"<path d=\"M10.3 6.74a.75.75 0 0 1-.04 1.06l-2.908 2.7 2.908 2.7a.75.75 0 1 1-1.02 1.1l-3.5-3.25a.75.75 0 0 1 0-1.1l3.5-3.25a.75.75 0 0 1 1.06.04Zm3.44 1.06a.75.75 0 1 1 1.02-1.1l3.5 3.25a.75.75 0 0 1 0 1.1l-3.5 3.25a.75.75 0 1 1-1.02-1.1l2.908-2.7-2.908-2.7Z\"/><path d=\"M1.5 4.25c0-.966.784-1.75 1.75-1.75h17.5c.966 0 1.75.784 1.75 1.75v12.5a1.75 1.75 0 0 1-1.75 1.75h-9.69l-3.573 3.573A1.458 1.458 0 0 1 5 21.043V18.5H3.25a1.75 1.75 0 0 1-1.75-1.75ZM3.25 4a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h2.5a.75.75 0 0 1 .75.75v3.19l3.72-3.72a.749.749 0 0 1 .53-.22h10a.25.25 0 0 0 .25-.25V4.25a.25.25 0 0 0-.25-.25Z\"/>"},{"n":"writing-extensions","l":"UI Extensions","s":"<symbol id=\"file-added-icon-symbol\" viewBox=\"0 0 16 16\"><path d=\"M2 1.75C2 .784 2.784 0 3.75 0h6.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v9.586A1.75 1.75 0 0 1 13.25 16h-9.5A1.75 1.75 0 0 1 2 14.25Zm1.75-.25a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h9.5a.25.25 0 0 0 .25-.25V4.664a.25.25 0 0 0-.073-.177l-2.914-2.914a.25.25 0 0 0-.177-.073Zm4.48 3.758a.75.75 0 0 1 .755.745l.01 1.497h1.497a.75.75 0 0 1 0 1.5H9v1.507a.75.75 0 0 1-1.5 0V9.005l-1.502.01a.75.75 0 0 1-.01-1.5l1.507-.01-.01-1.492a.75.75 0 0 1 .745-.755Z\"/></symbol><use xlink:href=\"#file-added-icon-symbol\" />"},{"n":"server-plugins","l":"Server Plugins","s":"<path d=\"M10.75 6.5a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5ZM6 7.25a.75.75 0 0 1 .75-.75h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 6 7.25Zm4 9a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5a.75.75 0 0 1-.75-.75Zm-3.25-.75a.75.75 0 0 0 0 1.5h.5a.75.75 0 0 0 0-1.5h-.5Z\"/><path d=\"M3.25 2h17.5c.966 0 1.75.784 1.75 1.75v7c0 .372-.116.716-.314 1 .198.284.314.628.314 1v7a1.75 1.75 0 0 1-1.75 1.75H3.25a1.75 1.75 0 0 1-1.75-1.75v-7c0-.358.109-.707.314-1a1.741 1.741 0 0 1-.314-1v-7C1.5 2.784 2.284 2 3.25 2Zm0 10.5a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25Zm0-1.5h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25H3.25a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25Z\"/>"},{"n":"i18n","l":"Internationalization (i​18​n)","s":"<path d=\"M12 1c6.075 0 11 4.925 11 11s-4.925 11-11 11S1 18.075 1 12 5.925 1 12 1Zm3.241 10.5v-.001c-.1-2.708-.992-4.904-1.89-6.452a13.919 13.919 0 0 0-1.304-1.88L12 3.11l-.047.059c-.354.425-.828 1.06-1.304 1.88-.898 1.547-1.79 3.743-1.89 6.451Zm-12.728 0h4.745c.1-3.037 1.1-5.49 2.093-7.204.39-.672.78-1.233 1.119-1.673C6.11 3.329 2.746 7 2.513 11.5Zm18.974 0C21.254 7 17.89 3.329 13.53 2.623c.339.44.729 1.001 1.119 1.673.993 1.714 1.993 4.167 2.093 7.204ZM8.787 13c.182 2.478 1.02 4.5 1.862 5.953.382.661.818 1.29 1.304 1.88l.047.057.047-.059c.354-.425.828-1.06 1.304-1.88.842-1.451 1.679-3.471 1.862-5.951Zm-1.504 0H2.552a9.505 9.505 0 0 0 7.918 8.377 15.773 15.773 0 0 1-1.119-1.673C8.413 18.085 7.47 15.807 7.283 13Zm9.434 0c-.186 2.807-1.13 5.085-2.068 6.704-.39.672-.78 1.233-1.118 1.673A9.506 9.506 0 0 0 21.447 13Z\"/>"}],"s":"<path d=\"M3.045 18.894 9.94 12 3.045 5.106a.75.75 0 0 1 1.06-1.061l7.425 7.425a.75.75 0 0 1 0 1.06l-7.424 7.425a.75.75 0 0 1-1.061-1.06Zm8.205.606a.75.75 0 0 0 0 1.5h9.5a.75.75 0 0 0 0-1.5h-9.5Z\"/>"},{"n":"administration","l":"Administration","o":true,"i":[{"n":"config-yaml","l":"Configuration File","s":"<path d=\"M8.75 8h6.5a.75.75 0 0 1 .75.75v6.5a.75.75 0 0 1-.75.75h-6.5a.75.75 0 0 1-.75-.75v-6.5A.75.75 0 0 1 8.75 8Zm.75 6.5h5v-5h-5Z\"/><path d=\"M15.25 1a.75.75 0 0 1 .75.75V4h2.25c.966 0 1.75.784 1.75 1.75V8h2.25a.75.75 0 0 1 0 1.5H20v5h2.25a.75.75 0 0 1 0 1.5H20v2.25A1.75 1.75 0 0 1 18.25 20H16v2.25a.75.75 0 0 1-1.5 0V20h-5v2.25a.75.75 0 0 1-1.5 0V20H5.75A1.75 1.75 0 0 1 4 18.25V16H1.75a.75.75 0 0 1 0-1.5H4v-5H1.75a.75.75 0 0 1 0-1.5H4V5.75C4 4.784 4.784 4 5.75 4H8V1.75a.75.75 0 0 1 1.5 0V4h5V1.75a.75.75 0 0 1 .75-.75Zm3 17.5a.25.25 0 0 0 .25-.25V5.75a.25.25 0 0 0-.25-.25H5.75a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25Z\"/>"},{"n":"multi-user","l":"Multi-​user mode","s":"<path d=\"M3.5 8a5.5 5.5 0 1 1 8.596 4.547 9.005 9.005 0 0 1 5.9 8.18.751.751 0 0 1-1.5.045 7.5 7.5 0 0 0-14.993 0 .75.75 0 0 1-1.499-.044 9.005 9.005 0 0 1 5.9-8.181A5.496 5.496 0 0 1 3.5 8ZM9 4a4 4 0 1 0 0 8 4 4 0 0 0 0-8Zm8.29 4c-.148 0-.292.01-.434.03a.75.75 0 1 1-.212-1.484 4.53 4.53 0 0 1 3.38 8.097 6.69 6.69 0 0 1 3.956 6.107.75.75 0 0 1-1.5 0 5.193 5.193 0 0 0-3.696-4.972l-.534-.16v-1.676l.41-.209A3.03 3.03 0 0 0 17.29 8Z\"/>"},{"n":"sso","l":"Single Sign-​On (SSO)","s":"<path d=\"M16.75 8.5a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Z\"/><path d=\"M15.75 0a8.25 8.25 0 1 1-2.541 16.101l-1.636 1.636a1.744 1.744 0 0 1-1.237.513H9.25a.25.25 0 0 0-.25.25v1.448a.876.876 0 0 1-.256.619l-.214.213a.75.75 0 0 1-.545.22H5.25a.25.25 0 0 0-.25.25v1A1.75 1.75 0 0 1 3.25 24h-1.5A1.75 1.75 0 0 1 0 22.25v-2.836c0-.464.185-.908.513-1.236l7.386-7.388A8.249 8.249 0 0 1 15.75 0ZM9 8.25a6.733 6.733 0 0 0 .463 2.462.75.75 0 0 1-.168.804l-7.722 7.721a.25.25 0 0 0-.073.177v2.836c0 .138.112.25.25.25h1.5a.25.25 0 0 0 .25-.25v-1c0-.966.784-1.75 1.75-1.75H7.5v-1c0-.966.784-1.75 1.75-1.75h1.086a.25.25 0 0 0 .177-.073l1.971-1.972a.75.75 0 0 1 .804-.168A6.75 6.75 0 1 0 9 8.25Z\"/>"},{"n":"/usage/remoteconnections","l":"Remote connections","s":"<path d=\"M3.5 3.25a.75.75 0 0 1 .75-.75C14.053 2.5 22 10.447 22 20.25a.75.75 0 0 1-1.5 0C20.5 11.275 13.225 4 4.25 4a.75.75 0 0 1-.75-.75Zm.75 6.25C10.187 9.5 15 14.313 15 20.25a.75.75 0 0 1-1.5 0A9.25 9.25 0 0 0 4.25 11a.75.75 0 0 1 0-1.5ZM3.5 19a2 2 0 1 1 3.999-.001A2 2 0 0 1 3.5 19Z\"/>"},{"n":"tunneling","l":"VP​Ns and Tunneling","s":"<path d=\"M6 9V7.25C6 3.845 8.503 1 12 1s6 2.845 6 6.25V9h.5a2.5 2.5 0 0 1 2.5 2.5v8a2.5 2.5 0 0 1-2.5 2.5h-13A2.5 2.5 0 0 1 3 19.5v-8A2.5 2.5 0 0 1 5.5 9Zm-1.5 2.5v8a1 1 0 0 0 1 1h13a1 1 0 0 0 1-1v-8a1 1 0 0 0-1-1h-13a1 1 0 0 0-1 1Zm3-4.25V9h9V7.25c0-2.67-1.922-4.75-4.5-4.75-2.578 0-4.5 2.08-4.5 4.75Z\"/>"},{"n":"/usage/st-reverse-proxy-guide","l":"Reverse proxying","s":"<path d=\"M10.75 6.5a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5ZM6 7.25a.75.75 0 0 1 .75-.75h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 6 7.25Zm4 9a.75.75 0 0 1 .75-.75h6.5a.75.75 0 0 1 0 1.5h-6.5a.75.75 0 0 1-.75-.75Zm-3.25-.75a.75.75 0 0 0 0 1.5h.5a.75.75 0 0 0 0-1.5h-.5Z\"/><path d=\"M3.25 2h17.5c.966 0 1.75.784 1.75 1.75v7c0 .372-.116.716-.314 1 .198.284.314.628.314 1v7a1.75 1.75 0 0 1-1.75 1.75H3.25a1.75 1.75 0 0 1-1.75-1.75v-7c0-.358.109-.707.314-1a1.741 1.741 0 0 1-.314-1v-7C1.5 2.784 2.284 2 3.25 2Zm0 10.5a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25Zm0-1.5h17.5a.25.25 0 0 0 .25-.25v-7a.25.25 0 0 0-.25-.25H3.25a.25.25 0 0 0-.25.25v7c0 .138.112.25.25.25Z\"/>"}],"s":"<path d=\"M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0Zm-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0Z\"/><path d=\"M12 1c.266 0 .532.009.797.028.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221.247.089.49.19.728.302.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147.402.349.78.726 1.128 1.129.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315.112.238.213.481.303.728.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512.038.531.038 1.063 0 1.594-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225-.089.248-.19.491-.302.728-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99-.349.402-.726.78-1.129 1.128-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a8.606 8.606 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303-.531.038-1.063.038-1.594 0-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8.138 8.138 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147-.402-.349-.78-.726-1.128-1.129-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a8.606 8.606 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11.158 11.158 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225.089-.248.19-.491.302-.728.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99.349-.402.726-.78 1.129-1.128.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002.238-.112.481-.213.728-.303.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304C11.466 1.01 11.732 1 12 1Zm-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.832 1.832 0 0 1-1.172 1.277 7.147 7.147 0 0 0-.6.249 1.833 1.833 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a9.774 9.774 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7.147 7.147 0 0 0-.249.6 1.831 1.831 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a9.63 9.63 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.832 1.832 0 0 1 1.277 1.172c.074.204.157.404.249.6.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228.301.348.628.675.976.976.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075c.196.093.396.176.6.25a1.831 1.831 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a9.63 9.63 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.834 1.834 0 0 1 1.172-1.278 6.82 6.82 0 0 0 .6-.248 1.831 1.831 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0 .348-.301.675-.628.976-.976.036-.042.06-.131 0-.228l-.776-1.275a1.834 1.834 0 0 1-.075-1.733c.093-.196.176-.396.25-.6a1.831 1.831 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a9.63 9.63 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a6.576 6.576 0 0 0-.248-.6 1.833 1.833 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a9.774 9.774 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.831 1.831 0 0 1-1.733.074 6.88 6.88 0 0 0-.6-.249 1.835 1.835 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a9.63 9.63 0 0 0-1.38 0Z\"/>"},{"n":"licensecredits","l":"License and credits","s":"<path d=\"M12.75 2.75V4.5h1.975c.351 0 .694.106.984.303l1.697 1.154c.041.028.09.043.14.043h4.102a.75.75 0 0 1 0 1.5H20.07l3.366 7.68a.749.749 0 0 1-.23.896c-.1.074-.203.143-.31.206a6.296 6.296 0 0 1-.79.399 7.349 7.349 0 0 1-2.856.569 7.343 7.343 0 0 1-2.855-.568 6.205 6.205 0 0 1-.79-.4 3.205 3.205 0 0 1-.307-.202l-.005-.004a.749.749 0 0 1-.23-.896l3.368-7.68h-.886c-.351 0-.694-.106-.984-.303l-1.697-1.154a.246.246 0 0 0-.14-.043H12.75v14.5h4.487a.75.75 0 0 1 0 1.5H6.763a.75.75 0 0 1 0-1.5h4.487V6H9.275a.249.249 0 0 0-.14.043L7.439 7.197c-.29.197-.633.303-.984.303h-.886l3.368 7.68a.75.75 0 0 1-.209.878c-.08.065-.16.126-.31.223a6.077 6.077 0 0 1-.792.433 6.924 6.924 0 0 1-2.876.62 6.913 6.913 0 0 1-2.876-.62 6.077 6.077 0 0 1-.792-.433 3.483 3.483 0 0 1-.309-.221.762.762 0 0 1-.21-.88L3.93 7.5H2.353a.75.75 0 0 1 0-1.5h4.102c.05 0 .099-.015.141-.043l1.695-1.154c.29-.198.634-.303.985-.303h1.974V2.75a.75.75 0 0 1 1.5 0ZM2.193 15.198a5.414 5.414 0 0 0 2.557.635 5.414 5.414 0 0 0 2.557-.635L4.75 9.368Zm14.51-.024c.082.04.174.083.275.126.53.223 1.305.45 2.272.45a5.847 5.847 0 0 0 2.547-.576L19.25 9.367Z\"/>"}],"search":{"mode":0,"minChars":2,"maxResults":20,"placeholder":"Search","hotkeys":["k"],"noResultsFoundMsg":"Sorry, no results found.","recognizeLanguages":true,"languages":[0],"preload":false},"resources":{"History_Title_Label":"History","History_ClearLink_Label":"Clear","History_NoHistory_Label":"No history items","API_AccessFilter_Label":"Access","API_ParameterSection_Label":"PARAMETERS","API_SignatureSection_Label":"SIGNATURE","API_CopyHint_Label":"Copy","API_CopyNameHint_Label":"Copy name","API_CopyLinkHint_Label":"Copy link","API_CopiedAckHint_Label":"Copied!","API_MoreOverloads_Label":"more","API_MoreDropdownItems_Label":"More","API_OptionalParameter_Label":"optional","API_DefaultParameterValue_Label":"Default value","API_InheritedFilter_Label":"Inherited","Search_Input_Placeholder":"Search","Toc_Contents_Label":"Contents","Toc_RelatedClasses_Label":"Related Classes","History_JustNowTime_Label":"just now","History_AgoTime_Label":"ago","History_YearTime_Label":"y","History_MonthTime_Label":"mo","History_DayTime_Label":"d","History_HourTime_Label":"h","History_MinuteTime_Label":"m","History_SecondTime_Label":"s"}};
diff --git a/resources/js/search.json b/resources/js/search.json
index 1e0220368..e45e52de0 100644
--- a/resources/js/search.json
+++ b/resources/js/search.json
@@ -1 +1 @@
-[[{"i":"what-is-sillytavern","l":"What is SillyTavern?","p":["SillyTavern - LLM Frontend for Power Users","SillyTavern (or ST for short) is a locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models. Our goal is to empower users with as much utility and control over their LLM prompts as possible, embracing the steep learning curve as part of the fun.","SillyTavern is a passion project brought to you by a dedicated community of LLM enthusiasts and will always be free and open-sourced. Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 100 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists."]},{"l":"Screenshots","p":["API Connection","Chat UI","Advanced Formatting","World Info"]},{"l":"Installation Requirements","p":["The hardware requirements are minimal: it will run on anything that can run NodeJS 18 or higher. If you intend to do LLM inference on your local machine, we recommend a 3000-series NVIDIA graphics card with at least 6GB of VRAM.","Follow the installation guide for your platform:","Windows","Linux and Mac","Android","Docker"]},{"l":"Branches","p":["SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.","release-\uD83C\uDF1F Recommended for most users. This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users. Typically updated once a month.","staging- ⚠️ Not recommended for casual use. This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts. Updates several times daily."]},{"i":"what-do-i-need-other-than-sillytavern","l":"What do I need other than SillyTavern?","p":["Since SillyTavern is only an interface, you will need access to an LLM backend to provide inference. You can use AI Horde for instant out-of-the-box chatting. Aside from that, we support many other local and cloud-based LLM backends: OpenAI-compatible API, KoboldAI, Tabby, and many more. You can read more about our supported APIs in the API Connections section."]},{"l":"Character Cards","p":["SillyTavern is built around the concept of \"character cards\". A character card is a collection of prompts that set the behavior of the LLM and is required to have persistent conversations in SillyTavern. They function similarly to ChatGPT's GPTs or Poe's bots. The content of a character card can be anything: an abstract scenario, an assistant tailored for a specific task, a famous personality or a fictional character.","The name field is the only required character card input. To start a neutral conversation with the language model, create a new card simply called \"Assistant\" and leave the rest of the boxes blank. For a more themed chat, you can provide the language model with various background details, behavior and writing patterns, and a scenario to jump start the chat.","To have a quick conversation without selecting a character card or to just test the LLM connection, simply type your prompt input into the input bar on the Welcome Screen after opening SillyTavern. Please note that such chats are temporary and will not be saved.","To get a general idea on how to define character cards, see the default character (Seraphina) or download selected community-made cards from the \"Download Extensions & Assets\" menu.","You can also create your own character cards from scratch. Refer to the Character Design guide for more information."]},{"l":"Key Features","p":["Advanced text generation settings with many community-made presets","World Info support: create rich lore or save tokens on your character card","Group chats: multi-bot rooms for characters to talk to you and/or each other","Rich UI customization options: theme colors, background images, custom CSS, and more","User personas: let the AI know a bit about you for greater immersion","Built-in RAG support: add documents to your chats for the AI to reference","Extensive chat commands subsystem and own scripting engine"]},{"l":"Extensions","p":["SillyTavern has extensibility support.","Character emotional expressions (sprites)","Auto-Summary of the chat history","Automatic UI and chat translation","Stable Diffusion/FLUX/DALL-E image generation","Text-to-speech for AI response messages (via ElevenLabs, Silero, or the OS's System TTS)","Web Search capabilities for adding additional real world context to your prompts","Many more are available to download from the \"Download Extensions & Assets\" menu."]},{"i":"how-can-i-get-in-touch-with-the-developers-directly","l":"How can I get in touch with the developers directly?","p":["Discord: cohee, rossascends, wolfsblvt","Reddit: /u/RossAscends, /u/sillylossy, u/Wolfsblvt","Post a GitHub issue"]},{"i":"i-like-your-project-how-do-i-contribute","l":"I like your project! How do I contribute?","p":["We welcome pull requests! Follow the Contribution Guidelines to get started.","We also welcome helpful and informed bug reports that use the templates provided in our GitHub.","We do not accept monetary donations for the project itself."]},{"l":"Personal Donations","p":["Your support for individual contributors is appreciated, but it will not influence the overall development direction of SillyTavern.","RossAscends has a personal Patreon& Kofi"]},{"l":"License","p":["SillyTavern is a free and open-source project released under the AGPL-3.0 License."]}],[{"l":"Installation","p":["Follow the installation guide for your platform:","Windows","Linux and Mac","Android","Docker"]},{"l":"Branches","p":["SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.","release-\uD83C\uDF1F Recommended for most users. This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users. Typically updated once a month.","staging- ⚠️ Not recommended for casual use. This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts. Updates several times daily."]}],[{"l":"Windows Installation","p":["DO NOT INSTALL INTO ANY WINDOWS CONTROLLED FOLDER (Program Files, System32, etc).","DO NOT RUN START.BAT WITH ADMIN PERMISSIONS","INSTALLATION ON WINDOWS 7 IS IMPOSSIBLE AS IT CAN NOT RUN NODEJS 18.16"]},{"l":"Installing via Git","p":["Install NodeJS(latest LTS version is recommended)","Install Git for Windows","Open Windows Explorer ( Win+E)","Browse to or Create a folder that is not controlled or monitored by Windows. (ex: C:\\MySpecialFolder)","Open a Command Prompt inside that folder by clicking in the 'Address Bar' at the top, typing cmd, and pressing Enter.","Once the black box (Command Prompt) pops up, type ONE of the following into it and press Enter:","for Release Branch: git clone https://github.com/SillyTavern/SillyTavern -b release","for Staging Branch: git clone https://github.com/SillyTavern/SillyTavern -b staging","Once everything is cloned, double-click Start.bat to make NodeJS install its requirements.","The server will then start, and SillyTavern will pop up in your browser."]},{"l":"Installing via SillyTavern Launcher","p":["On your keyboard: press WINDOWS + R to open Run dialog box. Then, run the following command to install git:","On your keyboard: press WINDOWS + E to open File Explorer, then navigate to the folder where you want to install the launcher. Once in the desired folder, type cmd into the address bar and press enter. Then, run the following command:"]},{"l":"Installing via GitHub Desktop","p":["(This allows git usage only in GitHub Desktop, if you want to use git on the command line too, you also need to install Git for Windows)","Install NodeJS(latest LTS version is recommended)","Install GitHub Desktop","After installing GitHub Desktop, click on Clone a repository from the internet....(Note: You do NOT need to create a GitHub account for this step)","image","On the menu, click the URL tab, enter this URL https://github.com/SillyTavern/SillyTavern, and click Clone. You can change the Local path to change where SillyTavern is going to be downloaded.","To open SillyTavern, use Windows Explorer to browse into the folder where you cloned the repository. By default, the repository will be cloned here: C:\\Users\\[Your Windows Username]\\Documents\\GitHub\\SillyTavern","Double-click on the start.bat file. (Note: the .bat part of the file name might be hidden by your OS, in that case, it will look like a file called \" Start\". This is what you double-click to run SillyTavern)","After double-clicking, a large black command console window should open and SillyTavern will begin to install what it needs to operate.","After the installation process, if everything is working, the command console window should look like this and a SillyTavern tab should be open in your browser:","Connect to any of the supported APIs and start chatting!"]}],[{"i":"linuxmacos-install","l":"Linux/MacOS Install"},{"l":"Manual Git install","p":["For MacOS / Linux all of these will be done in a Terminal.","Install git and nodeJS (the method for doing this will vary depending on your OS)","Clone the repo","for Release Branch: git clone https://github.com/SillyTavern/SillyTavern -b release","for Staging Branch: git clone https://github.com/SillyTavern/SillyTavern -b staging","cd SillyTavern to navigate into the install folder.","Run the start.sh script with one of these commands:","./start.sh","bash start.sh"]},{"l":"SillyTavern Launcher"},{"l":"For Linux users","p":["Open your favorite terminal and install git","Download Sillytavern Launcher with: git clone https://github.com/SillyTavern/SillyTavern-Launcher.git","Navigate to the SillyTavern-Launcher with: cd SillyTavern-Launcher","Start the install launcher with: chmod +x install.sh ./install.sh and choose what you wanna install","After installation start the launcher with: chmod +x launcher.sh ./launcher.sh"]},{"l":"For Mac users","p":["Open a terminal and install brew with: /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)","Then install git with: brew install git","Download Sillytavern Launcher with: git clone https://github.com/SillyTavern/SillyTavern-Launcher.git","Navigate to the SillyTavern-Launcher with: cd SillyTavern-Launcher","Start the install launcher with: chmod +x install.sh ./install.sh and choose what you wanna install","After installation start the launcher with: chmod +x launcher.sh ./launcher.sh"]}],[{"i":"android-termux-installation","l":"Android (Termux) Installation","p":["SillyTavern can be run natively on Android phones using Termux.","Please refer to this guide by ArroganceComplex#2659:","https://rentry.org/STAI-Termux"]},{"l":"Common errors"},{"i":"unsupported-platform-android-arm-letime-web","l":"Unsupported platform: android arm LEtime-web","p":["32-bit Android requires an external dependency that can't be installed with npm.","Use the following command to install it:","pkg install esbuild","Then run the steps from the guide."]}],[{"l":"Docker Installation","p":["This guide assumes you installed SillyTavern in a non-root (non-admin) folder. If you installed SillyTavern in a root folder, you may have to run some of these commands with administrator rights [sudo, doas, Command Prompt (Administrator)]."]},{"l":"Installation"},{"l":"Linux","p":["Add a new line below 127.0.0.1 and put in the IP you copied from Docker. It should look something similar to the following afterwards.","Arch Linux (Manjaro/EndeavourOS/etc.)","Clone the SillyTavern repository.","Copy down the IP you see in Gateway as this will be important.","Debian (Ubuntu/Pop! OS/etc.)","Do not install Docker Desktop.","Enjoy! :D","Execute docker compose by running the following command within the Docker folder.","Execute the following Docker command to obtain the IP of your SillyTavern Docker container.","Fedora, Red Hat Enterprise Linux (RHEL), etc.","Follow the steps in Manage Docker as a non-root user in the Docker Post-Installation Guide.","Install Docker by following the Docker installation guide here.","Install Git using your package manager.","Note that if you configured Docker network as a bridge, you could also add external IP addresses to the whitelist as usual.","Open an new browser and go to http://localhost:8000. You should see SillyTavern load in a few moments.","Release (Stable Branch)","Restart the Docker Container to apply the new configuration.","Save the file by pressing Ctrl+S then exit nano by pressing Ctrl+X.","Staging (Development Branch)","Using sudo, open nano and run the following command.","Within nano, go down to whitelist. You should see something similar to the following below.","You should receive some sort of output similar to the following below."]},{"l":"Windows","p":["Add a new line below 127.0.0.1 and put in the IP you copied from Docker. It should look something similar to the following afterwards.","Clone the SillyTavern repository.","Copy down the IP you see in Gateway as this will be important.","Enjoy! :D","Execute docker compose by running the following command within the Docker folder.","Execute the following Docker command to obtain the IP of your SillyTavern Docker container.","Install Docker Desktop by following the Docker installation guide here.","Install Git for Windows.","It is highly suggested you install SillyTavern by following our Windows guide. This section is a rough idea of how it can be done on Windows.","Note that if you configured Docker network as a bridge, you could also add external IP addresses to the whitelist as usual.","Open an new browser and go to http://localhost:8000. You should see SillyTavern load in a few moments.","Release (Stable Branch)","Restart the Docker Container to apply the new configuration.","Running Notepad or a code editor of your choice with administrator rights, go to config and open config.yaml.","Save the file by pressing Ctrl+S then exit your editor.","Staging (Development Branch)","Using Docker on Windows is really complicated. Not only do you need to activate Windows Subsystem for Linux within Turn Windows features on or off, but also configure your system for Virtualization (Intel VT-d/AMD SVM) which differs from PC manufacturer to PC manufacturer (or motherboard manufacturer). Sometimes, this option is not present on some systems.","Within the editor of your choice, you should see something similar to the following below.","You should receive some sort of output similar to the following below."]},{"l":"macOS","p":["Add a new line below 127.0.0.1 and put in the IP you copied from Docker. It should look something similar to the following afterwards.","Clone the SillyTavern repository.","Copy down the IP you see in Gateway as this will be important.","Enjoy! :D","Even though macOS is similar to Linux, it doesn't have the Docker Engine. You will have to install Docker Desktop similarly to Windows. You will also need to install Homebrew in order to install Git on your Mac. This section is a rough idea on how it can be done on macOS.","Execute docker compose by running the following command within the Docker folder.","Execute the following Docker command to obtain the IP of your SillyTavern Docker container.","If you can't run nano, either install it via Homebrew or use TextEdit.","Install Docker Desktop by following the Docker installation guide here.","Install git using Homebrew.","Note that if you configured Docker network as a bridge, you could also add external IP addresses to the whitelist as usual.","Open an new browser and go to http://localhost:8000. You should see SillyTavern load in a few moments.","Release (Stable Branch)","Restart the Docker Container to apply the new configuration.","Save the file by pressing Ctrl+S then exit nano by pressing Ctrl+X.","Staging (Development Branch)","Using sudo, open nano and run the following command.","Within nano, go down to whitelist. You should see something similar to the following below.","You should recieve some sort of output similar to the following below."]},{"l":"Configuring SillyTavern","p":["SillyTavern's configuration file (config.yaml) will be located within the config folder. Configuring the config file should be no different than configuring it without Docker, however you will need to run nano or a code editor with administrator rights in order to save your changes.","Don't forget to restart the Docker container for SillyTavern in order to apply your changes! Make sure you execute this command within the docker folder."]},{"l":"Locating User Data","p":["SillyTavern's data folder will be within the data folder. Backing up your files should be easy to do, however, restoring or adding content into it may require you to do so with administrator rights."]},{"l":"Running Server Plugins","p":["Running plugins like HoYoWiki-Scraper-TS or SillyTavern-Fandom-Scraper within Docker is no different from running it on your system without Docker, however we will need to do a slight modification to the Docker Compose script in order to do so.","If you already see a plugins folder within the docker folder, you can skip Steps 1-2.","Using nano or a code editor, open docker-compose.yml and add the following line below volumes.","Create a new folder within the docker folder called plugins.","Follow your plugin's instructions on installing the plugin.","Using nano or a code editor with administrator rights, open config.yaml(within the config folder) and enable enableServerPlugins","Restart the Docker container.","Profit."]}],[{"l":"How to Update SillyTavern","p":["Find your OS below and follow the instructions to update ST.","This guide assumes you have already installed and run SillyTavern at least once."]},{"i":"linuxtermux-or-macos","l":"Linux/Termux or MacOS","p":["You definitely installed via git, so just 'git pull' inside the SillyTavern directory.","cd SillyTavern to enter the correct folder.","git pull to get the update.","./start.sh or bash start.sh to start ST."]},{"l":"Windows","p":["First try using the UpdateAndStart.bat which is located in your SillyTavern installation base folder.","If that fails, come back here and continue reading."]},{"i":"method-1---git","l":"Method 1 - GIT","p":["We always recommend users install using 'git'. Here's why:","When you have installed via git clone, all you have to do to update is type git pull in a command line in the ST folder. Alternatively, if the command prompt gives you problems (and you have GitHub Desktop installed), you can use the Repository menu and select Pull.","The updates are applied automatically and safely."]},{"i":"help-i-originally-installed-via-zip-and-now-want-to-convert-to-git-install","l":"\"Help I originally installed via Zip and now want to convert to Git install\"","p":["You have chosen a wise path.","Since your installation was done via Zip, you will need to make a new install using git.","Thankfully we have instructions on how to do so.","Once you have used git to install a NEW SillyTavern into a DIFFERENT folder, come back to this page and proceed to Step 4 of the 'Zip Update' instructions below."]},{"i":"method-2---zip","l":"Method 2 - ZIP","p":["(*) 'As necessary' = \"If you made any custom content related to those folders\".","1.12.0 includes an automated migration procedure. The steps below are required only if the migration was interrupted or errored.","Copy the /data directory and config.yaml file from one installation to another.","Copy the following files/folders as necessary(*) from your old ST installation:","Do the usual setup procedure for your OS to install NodeJS requirements.","Doing so could break the new install and prevent new features from being present.","Download the new release zip.","If everything shows up, you can safely delete the old ST folder.","If you insist on installing via a zip, here is the tedious process for doing the update:","None of the folders are mandatory, so only copy what you need.","NOTE: DO NOT COPY THE ENTIRE /PUBLIC/ FOLDER","Once those folders/files are copied, paste them into the /data/default-user folder (with secrets.json going into the folder root) of the new install.","Run the updated server install at least once to create the /data/default-user directory.","Start SillyTavern once again with the method appropriate to your OS, and pray you got it right.","Transfer the files from old /public to new /data/default-user as necessary.","Unzip it into a folder OUTSIDE of your current ST installation."]},{"l":"Common Update Problems"},{"i":"i-use-docker-and-all-my-data-is-gone-after-the-update","l":"I use Docker and all my data is gone after the update!","p":["You must follow the Migration guide for Docker containers to update volume mappings for the new data model introduced in 1.12.0"]},{"i":"there-are-unresolved-conflicts-in-the-working-directory","l":"\"There are unresolved conflicts in the working directory.\"","p":["This means that you've modified default files that have been changed in the remote repository (such as setting presets).","To fix this, run this in the terminal. Use cautiously, as it can be destructive. Make sure to have a backup if needed."]},{"l":"File changes prevent git pull","p":["If you change SillyTavern system files, git pull may not work.","Sometimes an update may require us to change an important file, which can cause the same problem.","Usually it is default preset files or package-lock.json.","In this case you can try moving the file to a different folder (or deleting the file) and then do git pull.","Another solution is using git pull --rebase --autostash"]},{"i":"error-cannot-find-module--when-starting-the-server","l":"Error: Cannot find module \"***\" when starting the server","p":["This means that SillyTavern added a new npm package requirement.","Run npm install in the SillyTavern directory to fix this. Provided Start.bat and start.sh scripts will do that automatically.","Didn't help? Remove the node_modules folder","Windows","Unix/Linux"]}],[{"i":"1120-migration-guide","l":"1.12.0 Migration Guide","p":["SillyTavern 1.12.0 (codename the \"Neo Server\" update) includes several critical changes that may affect the way you use SillyTavern.","This guide will prepare you for the update and provide some further guidance."]},{"l":"Data storage update","p":["1.12.0 changes the way SillyTavern handles the user data.","Previously, all of the persistent data was stored together with the frontend part in the /public directory, which created confusion and potential points of failure, as well as making containerization and system-wide app installation quite challenging."]},{"i":"whats-changed","l":"What's changed?","p":["All persistent information from /public such as settings and chats (full list below) was moved into a separate directory with the configurable path, making it portable and independent from the web server itself. When needed for compatibility purposes, for example, for hosting extensions, full-size character cards, user image uploads, etc. a smart redirect has been set up to automatically host user files from the data directory."]},{"l":"Setting a data root","p":["You can provide either an absolute or a relative (to the ST repository directory) path to the data root either by config.yaml or by starting the server with the --dataRoot console argument.","YAML example","Console example","The default data root path is ./data, which means the data directory in SillyTavern's repository.","The data root path should be either a full absolute or a full relative path. You can't use path shortcuts like ~ or %APP_DATA%, as these are resolved by a shell, not the operating system."]},{"l":"Migration"},{"i":"important-before-we-begin","l":"IMPORTANT! Before we begin","p":["Only if you want to move dataRoot from the default location. Otherwise, skip this part. Set the data root before first running the server after pulling an update. Run npm install for the config.yaml to populate with a new value, or pass a console argument.","All data will be migrated into a default-user account. See more on Users below."]},{"i":"containerless-bare-metal-installs","l":"Containerless (bare metal) installs","p":["You don't have to do anything! An automatic migration should handle everything for you when you start the ST server and it detects the old storage format (by checking the existence of the /public/characters directory).","Upon moving any files, an automatic backup will be created in the /backups/_migration/YYYY-MM-DD(resolved to the current date) directory, but it is always a good practice to make a full manual backup before running the migration."]},{"i":"containerized-docker-installs","l":"Containerized (Docker) installs","p":["Migrating the data in Docker volumes is a bit trickier but pretty straightforward. While docker-compose.yml provided with the repo was updated to reflect the changes, you may need to adjust your custom workflows/deployments.","Step 1. Create a new volume, and mount it to the \"/home/node/app/data\" path within the container. Don't remove the config volume.","Step 2. Move everything but the config.yaml file from the config volume into the default-user subdirectory of the data volume.","Step 3. Rebuild the container and start it up.","Soft links between the /public directory and the config volume are no longer needed and are not built into the Docker container!"]},{"i":"what-to-migrate","l":"What to migrate?","p":["/data/default-user/assets","/data/default-user/backgrounds","/data/default-user/characters","/data/default-user/chats","/data/default-user/content.log","/data/default-user/context","/data/default-user/extensions","/data/default-user/group chats","/data/default-user/groups","/data/default-user/instruct","/data/default-user/KoboldAI Settings","/data/default-user/movingUI","/data/default-user/NovelAI Settings","/data/default-user/OpenAI Settings","/data/default-user/QuickReplies","/data/default-user/secrets.json","/data/default-user/settings.json","/data/default-user/stats.json","/data/default-user/TextGen Settings","/data/default-user/themes","/data/default-user/thumbnails","/data/default-user/vectors","/data/default-user/worlds","/default/content/content.log","/public/assets","/public/backgrounds","/public/characters","/public/chats","/public/context","/public/group chats","/public/groups","/public/instruct","/public/KoboldAI Settings","/public/movingUI","/public/NovelAI Settings","/public/OpenAI Settings","/public/QuickReplies","/public/scripts/extensions/third-party","/public/settings.json","/public/stats.json","/public/TextGen Settings","/public/themes","/public/worlds","/secrets.json","/thumbnails","/vectors","After","Before","The following files and directories are subject to the data migration. Assuming the default configuration, the before and after paths are provided in the table below."]},{"l":"Users","p":["1.12.0 adds a (completely optional) ability to create a multi-user setup on the same server, allowing multiple users to use their own fully isolated SillyTavern instances even at the same time. User accounts can also be password-protected for an additional layer of privacy.","Please refer to the Users documentation for more information."]}],[{"i":"190-migration-guide","l":"1.9.0 Migration Guide"},{"i":"how-to-migrate-to-a-new-branch-if-i-use-maindev","l":"How to migrate to a new branch if I use main/dev?","p":["It is recommended to do a fresh install. However, if you wish to use an existing copy of SillyTavern, please follow the instructions below.","IMPORTANT! Before doing anything, make a complete backup of your installation. You may lose your data in the process, so don't ignore this warning.","Not sure of which files to back up? See the list here: How to Update SillyTavern"]},{"l":"git installs","p":["Open a terminal prompt (cmd, PowerShell, Termux, etc) in your SillyTavern installation folder.","Type git fetch and then git pull to pull the updates.","You may lose your settings. Have you made a backup? git switch release or git switch staging will change your branch, respectively","Skip to next item if you have no errors. You may have something like:","You will see a list of files affected. If you do not care about those settings files being replaced git switch -f release or git switch -f staging will set your branch. If you do care to save those changes restore from backup.","Type npm install and then npm run start to test that everything behaves correctly.","Enjoy! Restore your data from a backup if needed."]},{"i":"fatal-invalid-reference-release","l":"fatal: invalid reference: release","p":["This may happen if you cloned just a single branch from an old remote (before migration to the organization repo). To fix this, you need to add and fetch a branch from a new remote:","Then proceed from step 5."]},{"l":"ZIP installs","p":["Nothing changes for you. Just download the branch/release ZIP like usual."]}],[{"l":"Usage","p":["Add new features and capabilities to the AI or the interface","API Connections","Automate tasks, let your AI interact with the world, and write your own extensions","Characters and Personas","Chatting","Connect to AI models for generating text, images, and more","Control the requests that you send to the AI and how it responds","Create and use characters to shape the AI's role, and personas to define your identities","Data Bank","Development and Automation","Extensions","FAQ","Frequently asked questions about SillyTavern, AI models, making characters, getting better responses, and more","How to chat with the AI and use the chat interface","Interact with AI, your way. Build your world, your work, or your dreams.","Manage information and when to insert it into the prompt","Quick Start","Response Configuration and Prompts","Send your first message to the AI and get a response","Store and retrieve information for use in the AI's responses","World Info"]},{"l":"Control Panels","p":["Add new features and capabilities to the AI or the interface","Advanced Formatting","API Connections","Backgrounds","Change the background image","Change the theme, and the look and feel of messages and chats","Characters","Connect to AI models for generating text, images, and more","Control text generation and sampling. Customize prompt construction for Chat Completion APIs.","Create and manage characters for the AI to use","Create and manage personas to use with the AI","Customize prompt construction for Text Completion APIs","Extensions","Manage information and when to insert it into the prompt","Personas","Response Configuration and Prompt Manager","User Settings","What all the buttons do, from the left to the right:","World Info"]}],[{"l":"Quick Start","p":["I'm clueless. Just spoonfeed me the easiest and fastest way I can start using SillyTavern. -- Anonymous","You can get started with SillyTavern in just a few minutes. Here are two easy ways to get started:","You can use AI Horde for free. AI Horde is a community-driven AI service that provides access to a variety of AI models.","If you have an OpenAI account or want to register one, you can use OpenAI."]},{"l":"Quick start with AI Horde","p":["Follow the Installation Guide to install and start SillyTavern.","In SillyTavern's onboarding screen, enter a name for your persona. This name will be used in the chat.","This is an optional caption","Click the API Connections button in the top bar.","Enter an API key for AI Horde. You can use 0000000000 for now, or get a free key from AI Horde.","Select some AI models to use. Just choose a few from the top. You can always change them later.","Close the API Connections window. Enter a message in the chat box at the bottom and press Enter.","Your AI will respond in a few moments. You can continue chatting with it. Success!"]},{"l":"Quick start with OpenAI"},{"l":"Install SillyTavern","p":["Follow the Installation Guide to install and start SillyTavern."]},{"l":"Get access to OpenAI","p":["Sign up to OpenAI.","Go to https://platform.openai.com","Click your account icon in the top right, then View API Keys.","Click \"Create new secret key\". Copy it somewhere immediately. DO NOT SHARE THIS KEY. WHOEVER HAS IT CAN USE YOUR ACCOUNT TO USE GPT AT YOUR EXPENSE."]},{"l":"Configure SillyTavern to use your API","p":["In SillyTavern's top bar, click API Connections.","Under API, select Chat Completion (OpenAI).","Under Chat Completion Source, select OpenAI.","Paste the API key you saved in the previous step.","Click the Connect button. Confirm it says Valid.","By default, SillyTavern will use GPT-4 Turbo. You can choose a different model, but educate yourself on the pricing."]},{"l":"Test your setup","p":["In SillyTavern's top bar, click Character Management at the far right.","Select an existing character such as Seraphina.","In the text box at the bottom, write something to Seraphina, then press Enter or click the Send button.","If you did everything right, after a few seconds, Seraphina should respond."]}],[{"l":"FAQ"},{"l":"Explain what SillyTavern is about","p":["Modern AI language models such as ChatGPT have gotten so powerful that some of them are now convincingly able to simulate a character you create, and who you can chat with, write fiction with, etc. For example, you can tell the AI to pretend to be a Go instructor named Jubei from medieval Japan, and it will act and respond accordingly. You can have a long chat with Jubei, go to the pub together, decide to get in a fight with samurais, whatever you can imagine, and the AI will play along and write/react around this content, acting as your foil and dungeon master. Your imagination is the limit. You can tell the AI to pretend it's Wonder Woman. You can also specify a scenario (\"Wonder Woman and I are robbing a bank\"), a writing style (\"Wonder Woman speaks in ebonics\"), or anything else you can think of.","SillyTavern is an app to facilitate these uses:","It's a user interface that handles communication with AI language models.","It lets you create new character cards (prompts), and switch between them easily.","It lets you import characters created by other people.","It will keep your chat history with a character, allowing you to resume at any time, start a new chat, review old chats, etc.","In the background, it does the necessary things to prepare the AI prompt for you. Specifically, it will send a system prompt (instructions for the AI) that primes the AI to follow certain rules to improve response accuracy."]},{"l":"Give me an overview of my AI model options","p":["SillyTavern can interact with two types of AI:","Web services(Cloud-based, usually paid, proprietary, closed)","Self-hosted(local, free, open-source)"]},{"l":"Paid web service AIs","p":["Paid web models are black boxes. You pay a company to use their AI service. You put your account info in SillyTavern and it will connect to your provider to use the AI on your behalf.","Pros:","Really easy to get started.","Highest quality AI writing.","Cons:","They cost money to use.","Everything is logged on their server. Privacy concerns.","They are often censored and will refuse to chat with you about certain subjects."]},{"l":"Self-hosted AIs","p":["Self-hosted models are free models you can run on your PC but require a powerful PC and more work to set up.","Pros:","Once you set them up, they can be used for free even without Internet access.","Total privacy. Everything you write stays on your own PC.","There's a wide variety of models. As a community-driven technology, you can find models that fit certain tasks or behaviors that you want.","Cons:","They are not as capable as SOTA models (i.e., they write worse dialog, are less creative, etc).","Running local models requires a GPU with at least 6GB VRAM.","If you are interested in using these, refer to the dedicated guide here: How To Use A Self-Hosted Model."]},{"i":"can-i-use-sillytavern-on-my-phone-or-tablet","l":"Can I use SillyTavern on my phone or tablet?","p":["iPhones and iPads are not capable of running the whole SillyTavern app, but since it's just a web interface, you can run it on another computer on your home Wi-Fi, and then access it in your mobile browser. Refer to Remote Connections for more information.","For Android users, in addition to the above, you can run the whole SillyTavern directly on your phone, without needing a PC, using the Termux app. Refer to Installation (Android). (NOTE: Termux installations are not officially supported, and we can't guarantee it will work.)"]},{"i":"i-tried-to-import-a-png-character-card-but-got-an-error-that-its-invalid-why","l":"I tried to import a PNG character card but got an error that it's invalid. Why?","p":["Two possibilities:","The card did not have the definitions embedded inside it and was just a normal image file. Some programs or file managers will strip the embedded definitions from the card when you save them. Make sure you're using the raw PNG file as it was posted by the person who shared it.","The PNG file was actually a WEBP file with a .png filename. You can try renaming the card to .webp before importing, or look for a proper PNG version of the image."]},{"i":"how-can-i-make-my-own-ai-character","l":"How can I make my own AI character?","p":["Click the Character Management button","Click Create New Character","Under Character Name, give a name, like Amanda","Optionally, click the Select Avatar button to pick an image portrait for this character","Under Description, describe the character, and include any information you want that you feel is relevant to the chat. For example: Amanda is a student traveling during her gap year. She's 6 feet tall, and a volleyball player. She has an athletic figure. She has long brown hair. She loves the Victorian England period, and watching TV and reading novels relating to that period. For example, if you want Amanda to be friendly, then you would add: Amanda is extremely cheerful and outgoing.","Under First Message, write the greeting the character when you begin a new chat. For example: *Amanda waves at you* Hey! Are you a backpacker too?","Click the Create Character button","You now have a basic character you can chat with. Select Amanda from the character list, and a new chat will begin.","Note that you can use the Description and/or First Message to create a more specific scenario, and/or include yourself in the description. For example:","Any relevant information you include can be used. How well it's used depends on the power level of the AI model.","NOTE: you can go back and edit any of this information once the character is created, except the name."]},{"i":"where-are-my-api-keys-stored-why-cant-i-see-them","l":"Where are my API keys stored? Why can't I see them?","p":["SillyTavern saves your API keys to a secrets.json file in the server directory.","By default, they will not be exposed to a frontend after you enter them and reload the page.","To enable viewing your keys by clicking a button in the API block:","Set the value of allowKeysExposure to true in the config.yaml file.","Restart the SillyTavern server."]},{"i":"why-is-the-ui-so-slowjittery","l":"Why is the UI so slow/jittery?","p":["Try enabling the No Blur Effect (Fast UI) mode on the User settings panel.","Enable Reduced motion in the UI theme settings to remove cosmetic animations.","Make sure your browser is using Hardware Acceleration."]},{"i":"how-to-make-the-ai-write-more","l":"How to make the AI write more?","p":["Sometimes the AI will only respond with a single sentence when you'd like it to be more verbose. This is usually a problem with locally run models.","If you simply want the bot to continue writing from where it left off at the end of its most recent reply, you can send an empty user message by typing nothing into the Input Bar and clicking Send. This will force the bot to continue the story.","Strategies for fixing this:","Decrease the value of the Response Length setting","Design a good First Message for the Character, which shows them speaking in a long-winded manner. AI models can improve a lot when given guidance about the writing style you expect.","Add a phrase in the character's Description Box such as \"likes to talk a lot\" or \"very verbose speaker\"","Do the same thing for your Author's Note, or Post-History Instruction Prompt","As a last resort, you can try turning on Auto-Continue(in the User Settings panel), but will make responses come out slower because it's making the AI produce small replies back to back, and then combining them all together into one big reply. It may also be incompatible with some API options."]},{"i":"how-to-make-the-ai-write-less","l":"How to make the AI write less?","p":["This is mostly only a problem for models like ChatGPT or Claude. The same strategies can be applied but in reverse.","Decrease the value of the Response Length setting","Give the character a phrase like 'short spoken', or 'doesn't talk much' line in their Description.","Give the character a brief First Message to set the tone and expectation for the chat.","Make sure Auto-Continue is turned off."]},{"i":"how-to-make-the-ai-stop-writing-the-actions-of-my-character-and-driving-the-plot-all-on-its-own","l":"How to make the AI stop writing the actions of my character, and driving the plot all on its own?","p":["This should be handled in the Author's Note with a combination of phrases like:","{{char}}'s responses shall only be passive and reactive to {{user}}'s actions.","Your next response shall be solely from the POV of {{char}}.","You are never allowed to dictate actions or speech for {{user}}"]}],[{"l":"Chatting","p":["When you are connected to an API, send messages to the AI by typing in the chat bar at the bottom of the screen. Then click Send or press Enter. Chat bar","The AI will respond with a message that continues the conversation.","Chat message","You can now:","Send another message","Swipe the response: Click the Swipe button on the message to generate a different response.","Edit the message: Click the Edit button on any message to edit the message content.","Message actions: Click the Message actions button on a message for more message options like translation, image generation, and story branching.","Chat options: Click the Options button next to the chat bar for more chat options like author's notes and chat file management.","If you wish you'd said something different, you can edit your message and then swipe the AI's response to get a new one.","You can also use the Right arrow key to swipe, and the Up arrow key to edit the last message in the chat. For more hotkeys, use the /help hotkeys slash command in the chat or check the HotKeys page."]},{"l":"Message actions panel","p":["Manage individual chat messages via the ellipsis (•••) button on the message.","To display these options for all messages in your chats, enable the Expand Message Actions setting in your user settings."]},{"l":"Core Functions","p":["Translate: Convert message to different language","Generate Image: Create an image from message content","Narrate: Text-to-speech conversion","Prompt: View the generation prompt and token usage"]},{"l":"Message Visibility","p":["Included: AI sees this message; click to exclude it","Excluded: AI does not see this message; click to include it"]},{"l":"Content Management","p":["Embed: Attach files or images","Checkpoint: Create story checkpoint","Checkpoint Navigation: Click to open checkpoint chat, Shift+Click to update existing checkpoint","Branch: Start alternate story path","Copy: Copy message text","Edit: Edit message content"]},{"l":"Edit message content","p":["A compact panel of message manipulation tools that appears when you Edit a chat message."]},{"l":"Core Actions","p":["Confirm: Save message changes","Cancel: Discard message changes"]},{"l":"Message Operations","p":["Copy: Duplicate message content","Delete: Remove message"]},{"l":"Message Position","p":["Move Up: Shift message higher in chat","Move Down: Shift message lower in chat","Note: Movement controls may be disabled based on message position in chat history."]},{"l":"Chat options panel","p":["Manage chat settings and operations via the Options button at the bottom left of the chat interface."]},{"l":"Display Controls","p":["Close chat: Exit current chat session","Toggle Panels: Show/hide interface panels"]},{"l":"Generation Settings","p":["Author's Note: Custom context instructions","CFG Scale: Adjust response creativity","Token Probabilities: View token generation stats"]},{"l":"Chat Navigation","p":["Back to parent chat: Return to main conversation","Save checkpoint: Create story checkpoint","Convert to group: Transform into group chat"]},{"l":"Chat Management","p":["Start new chat: Begin fresh conversation","Manage chat files: Chat file operations such as import, export, and renaming"]},{"l":"Message Controls","p":["Delete messages: Select and remove multiple messages","Regenerate: Create new response","Impersonate: AI writes message as user","Continue: Extend last message","Note: Some options may be hidden depending on context and chat state."]},{"l":"Token Probabilities Panel","p":["The Token Probabilities panel lets you look into the AI's sampling process for text generation. It shows you not just what the AI wrote, but what other options it considered at each point in the text.","To open it, click the Token Probabilities button in the Chat Options panel.","Example message","Token probabilities display for example message","When you click any token (word, punctuation, or formatting character) in the generated text, the panel displays alternative tokens the AI considered at that position, along with their probability scores. This gives you insight into the AI's \"thought process\" and shows other directions the response could have taken. Looking at these alternatives can help you understand whether there were several likely options or a single clear choice.","Alternative tokens and probabilities","If you see a token that you think the AI should have chosen differently, choose an alternative and the message will regenerate from that point forward, potentially giving you a different response."]},{"l":"Rerolling","p":["If you change a specific token and regenerate the response, the part of the new response before the changed token will be the same as the original response. This part is shown in gray. Since it was not generated, there is no probability information for this part.","You may like to see other responses that could have been generated based on your alternative token.","You can click the gray portion to \"reroll\" the generation, giving you a new variation of the text. Clicking any part of the gray portion will keep the entire gray portion and regenerate the entire white/tinted portion.","Holding Ctrl while clicking a token in the gray portion will retain the gray portion up to the clicked token and regenerate the rest of the text. Your choice of alternative token can not be kept in this case."]},{"l":"Controls","p":["Token Display:","Generated text is split into individual tokens","Each token is interactive, click a token to see alternatives considered by the AI","Tokens are tinted as a visual aid but this does not indicate probability","Special characters (spaces, newlines) are visibly marked","Token Selection:","Click a token to view alternatives","Click an alternative to replace the token and regenerate the response","Hover over a token to see its raw log-probability score","Window Controls:","Drag handle for panel repositioning (MovingUI only)","Maximize/restore panel size","Expand/collapse panel content","Close panel"]},{"l":"Availability","p":["You must select Request token probabilities in User Settings to enable this feature.","Token probabilities are only available for the most recent message, and are not saved to the chat. If token probability information is no longer available for a message, the panel will display a message indicating this.","Token probabilities are not available when using Smooth Streaming.","Token probabilities are not available from all APIs. If you are using an API that does not support token probabilities, the panel will open but will not display any information."]},{"l":"Text Completion","p":["LlamaCPP: Available","Text Generation WebUI(oobabooga): Available","TabbyAPI: Available","NovelAI: Available","KoboldCPP: Available","Ollama: Appears to be unavailable","OpenRouter Text: Appears to be unavailable"]},{"l":"Chat Completion","p":["OpenAI or Custom: Available, but rerolling is not supported","Anthropic: Appears to be unavailable","Google AI Studio: Appears to be unavailable","OpenRouter Chat: Appears to be unavailable"]}],[{"l":"Slash commands","p":["This is not an exhaustive list as it is updated rarely.","For the most up-to-date list of commands that will work in your instance, use the /help slash chat command in any SillyTavern chat.","/help– displays the help message","/api- switches to a different API","/sys- sends a neutral message as a system narrator","/send- sends a message as the user without triggering the generation","/sendas– sends a message as a specific character","/comment- adds a comment to the chat invisible to the AI","/impersonate- ask AI to write as you with an optional prompt","/persona- set your user persona","/imagine- generate an image from a text prompt","/bg- set a background image by file name"]}],[{"l":"HotKeys","p":["For the most up-to-date list of HotKeys that will work in your SillyTavern instance, use the /help hotkeys slash command in any chat.","Hotkeys are disabled for mobile devices."]},{"l":"Chat Hotkeys","p":["Up = Edit last message in chat","Ctrl+Up = Edit last USER message in chat","Left = swipe left","Right = swipe right (NOTE: swipe hotkeys are disabled when chatbar has something typed into it)","Enter (with chat bar selected) = send your message to AI","Ctrl+Enter = Regenerate the last AI response","Alt+Enter = Continue the last AI response","Escape","(while editing message AND Message Edit AutoSave is enabled)= close edit box.","(while an AI message is generating or streaming)= stop the generation immediately."]},{"l":"Markdown Hotkeys","p":["Needs to be enabled under the \"User Settings\" tab. Works in the chatbar and textareas marked with the \"M↓\" icon:","Ctrl+B = **bold**","Ctrl+I = *italic*","Ctrl+U = __underline__","Ctrl+K = `inline code`","Ctrl+Shift+~= ~~strikethrough~~"]}],[{"l":"Common Settings","p":["These settings control the sampling process when generating text using a language model. The meaning of these settings is universal for all the supported backends."]},{"l":"Context Settings"},{"i":"response-tokens","l":"Response (tokens)","p":["The maximum number of tokens that the API will generate to respond.","The higher the response length, the longer it will take to generate the response.","If supported by the API, you can enable Streaming to display the response bit by bit as it is being generated.","When Streaming is off, responses will be displayed all at once when they are complete."]},{"i":"context-tokens","l":"Context (tokens)","p":["The maximum number of tokens that SillyTavern will send to the API as the prompt, minus the response length.","Context comprises character information, system prompts, chat history, etc.","A dotted line between messages denotes the context range for the chat. Messages above that line are not sent to the AI.","To see a composition of the context after generating the message, click on the Prompt Itemization message option (expand the ... menu and click on the lined square icon)."]},{"l":"Sampler Parameters"},{"l":"Temperature","p":["Controls the randomness of the generated text.","Lower value: responses are more logical but less creative.","Higher value: responses are more creative but less logical."]},{"l":"Repetition Penalty","p":["Attempts to curb repetition by penalizing tokens based on how often they occur in the context.","Sometimes, if the character is fixated on something or repeats the same phrase, increasing this parameter can help.","This parameter will break responses if set too high. It's best not to go above 1.15 unless you know what you're doing.","Set the value to 1 to disable its effect."]},{"l":"Repetition Penalty Range","p":["How many tokens from the last generated token will be considered for the repetition penalty. This can break responses if set too high, as common words like \"the, a, and,\" etc. will be penalized the most.","Set the value to 0 to disable its effect."]},{"l":"Repetition Penalty Slope","p":["If both this and Repetition Penalty Range are above 0, the repetition penalty will have a greater effect at the end of the prompt. The higher the value, the stronger the effect.","Set the value to 0 to disable its effect."]},{"l":"Top K","p":["Limits the token pool to the K most likely tokens. A lower number is more consistent but less creative.","Set the value to 0 to disable its effect."]},{"l":"Top P","p":["Limits the token pool to however many tokens it takes for their probabilities to add up to P. A lower number is more consistent but less creative.","Set the value to 1 to disable its effect."]},{"l":"Typical P","p":["Selects tokens randomly from the list of possible tokens, with each token having an equal chance of being selected. Produces responses that are more diverse but may also be less coherent.","Set the value to 1 to disable its effect."]},{"l":"Min P","p":["Limits the token pool by cutting off low-probability tokens relative to the top token. Produces more coherent responses but can also worsen repetition if set too high.","Works best at low values such as 0.1-0.01, but can be set higher with a high Temperature. For example: Temperature: 5, Min P: 0.5","Set the value to 0 to disable its effect."]},{"l":"Top A","p":["The number of tokens chosen from the most likely options is automatically determined based on the likelihood distribution of the options, but instead of choosing the Top P or Top K tokens, it chooses all tokens with probabilities above a certain threshold.","Set the value to 0 to disable its effect."]},{"l":"Tail Free Sampling","p":["This setting removes the least probable tokens from consideration during text generation, which can improve the quality and coherence of the generated text.","Set the value to 1 to disable its effect."]},{"l":"Smoothing Factor","p":["Increases the likelihood of high-probability tokens while decreasing the likelihood of low-probability tokens using a quadratic transformation. Aims to produce more creative responses regardless of Temperature.","Works best without truncation samplers such as Top K, Top P, Min P, etc.","Set the value to 0 to disable its effect."]},{"l":"Dynamic Temperature","p":["Scales temperature dynamically based on the likelihood of the top token. Aims to produce more creative outputs without sacrificing coherency.","Accepts a temperature range from minimum to maximum. For example: Minimum Temp: 0.75 and Minimum Temp: 1.25","Exponent applies an exponential curve based on the top token.","Untick to disable its effect."]}],[{"l":"API Connections","p":["SillyTavern can connect to a wide range of LLM APIs. Below is a description of their respective strengths, weaknesses, and use cases."]},{"i":"eli5-chat-completions-vs-text-completions","l":"ELI5: Chat Completions vs Text Completions","p":["When you first navigate to the \"API Connections\" page in ST, you will notice a drop-down option to select between options using nomenclature such as \"Chat Completion\" and \"Text Completion\". It's helpful to understand what this is.","What it's not: It's easy to think of \"Text Completion\" as local models and \"Chat Completion\" as cloud-based LLMs but that's not the case. Neither is e.g. \"Novel AI\" or \"Kobold\" actually a separate type of model altogether, even though they are separate options in the API dropdown in ST. You can force models into different API structures with the appropriate backend, but that's not the point of this section.","When you send a message using ST, your chat, character description, and other prompts such as lorebooks or author notes are constructed into a single \"prompt\" to be sent to the model. The API \"type\" for the model you are using decides how exactly this prompt will be constructed (something that ST takes care of you automatically in the background - you can open your ST terminal and see exactly what the prompt being sent to the AI looks like)."]},{"l":"Chat Completions","p":["A Chat Completion model, as its name suggests will structure your prompt into a series of messages between the User (you) and the Assistant (the AI) or System (neutral). Models that are trained for Chat Completion help create the feeling of a \"Chat\", with the AI \"responding\" to the last message. When you're using the ChatGPT website, you're dealing with a Chat Completions API in the background."]},{"i":"text-completions-aka-just-completions","l":"Text Completions (a.k.a just \"Completions\")","p":["A Text Completion on the other hand, and again as its name suggests, will convert your prompt into one long string and the model will simply try to continue this (like, literally imagine all your text, your hundreds of messages, all your formatting, newlines, etc. squashed into one very long sentence).","If your messages in ST happen to be formatted as a series of messages between YourPersona: and Character:, the Text Completion model will try to continue this pattern and ST will render it as a new chat message for you, but really the model is just trying to continue the Text. If you offered an input of \"The Sun rises in the\", a text completion model is likely to finish that message for you with \"East\".","Most Text Completion models have a recommended \"Instruct Template\" (usually mentioned in the model's documentation or download page) that help them \"respond\" to messages and instructions, just like a Chat Completion model. ST usually has most (if not all) Instruct Templates available for you to choose from in the \"Advanced Formatting\" page."]},{"l":"Local APIs","p":["These LLM APIs can be run on your PC.","They are free to use and have no content filter.","Installation process can be complex ( SillyTavern dev team does not provide support for this).","Requires separate download of LLM models from HuggingFace which can be 5-50GB each.","Most models are not as powerful as cloud LLM APIs."]},{"l":"KoboldAI","p":["Runs on your PC, 100% private, wide range of models available","Gives the most direct control of the AI's generation settings","Requires large amounts of VRAM in your GPU (6-24GB, depending on the LLM model)","Models limited to 2k context","No streaming","Popular KoboldAI versions:","Henky's United","0cc4m's 4bit-supporting United"]},{"l":"KoboldCpp","p":["Easy-to-use API with CPU offloading (helpful for low VRAM users) and streaming","Runs from a single .exe file on Windows (must be compiled from source on MacOS and Linux)","Supports GGUF/GGML models","Slower than GPU-only loaders such as AutoGPTQ and Exllama/v2","GitHub"]},{"l":"Oobabooga TextGeneration WebUI","p":["All-in-one Gradio UI with streaming","Broadest support for quantized (AWQ, Exl2, GGML, GGUF, GPTQ) and FP16 models","One-click installers available","Regular updates, which can sometimes break compatibility with SillyTavern","GitHub","Correct Way to Connect SillyTavern to Ooba's new OpenAI API","Make sure you're on the latest update of Oobabooga's TextGen (as of Nov 14th, 2023).","Edit the CMD_FLAGS.txt file, and add the --api flag there. Then restart Ooba's server.","Connect ST to http://localhost:5000/(by default) without checking the 'Legacy API' box. You may remove the /v1 postfix from the URL Ooba's console provides you.","You can change the API hosting port with the --api-port 5001 flag, where 5001 is your custom port."]},{"l":"TabbyAPI","p":["Lightweight Exllamav2-based API with streaming","Supports Exl2, GPTQ, and FP16 models","Official extension allows loading/unloading models directly from SillyTavern","Not recommended for users with low VRAM (no CPU offloading)","GitHub"]},{"l":"Cloud LLM APIs","p":["These LLM APIs are run as cloud services and require no resources on your PC","They are stronger/smarter than most local LLMs","However they all have content filtering of varying degrees, and most require payment"]},{"i":"openai-chatgpt","l":"OpenAI (ChatGPT)","p":["Easy to set up and acquire an API key","Requires prepayment for credits and charges per prompt","Very logical. Creative style can be repetitive and predictable","Most of the newer models (gpt-4-turbo, gpt-4o) support multimodality","Website, Setup Instructions"]},{"i":"claude-by-anthropic","l":"Claude (by Anthropic)","p":["Recommended for users who want their AI chats to have a creative, unique writing style","Requires prepayment for credits and charges per prompt","The newest models (Claude 3) support multimodality","Requires a specific prompting style and utilization of prefills for reply steering","Website"]},{"i":"mistral-by-mistral-ai","l":"Mistral (by Mistral AI)","p":["Efficient models from various sizes and use cases. You can create an account and API key on their platform.","From 32k to 128k context sizes for general use, and 32k to 256k context sizes for coding.","Free Tier with rate limits.","Reasonable moderation, with Mistrals main principles being to be neutral and empower users, more information here."]},{"l":"OpenRouter","p":["WindowAI browser extension allows you to connect to the abovementioned cloud LLMs with your own API key","Use OpenRouter to pay to use their API keys instead","Useful if you don't want to create individual accounts on each service","WindowAI website and OpenRouter website"]},{"l":"DreamGen","p":["Uncensored models tuned for steerable creative writing","Free monthly credits, as well as paid subscription","Models ranging from 7B to 70B","Setup Instructions"]},{"l":"AI Horde","p":["SillyTavern can access this API out of the box with no additional settings required","Uses the GPU of individual volunteers (Horde Workers) to process responses for your chat inputs","At the mercy of the Worker in terms of generation wait times, AI settings, and available models","Website"]},{"l":"Mancer AI","p":["Service that hosts unconstrained models of various families","Uses 'credits' to pay for tokens on various models","Does not log prompts by default, but you can enable it to get credit discounts on tokens.","Uses an API similar to Oobabooga TextGeneration WebUI, see Mancer docs for details.","Website, Setup Instructions"]},{"l":"NovelAI","p":["No content filter","Paid subscription required","Website, Setup Instructions"]}],[{"l":"Connection Profiles","p":["Save Connection Profiles to quickly switch between different APIs, models and formatting templates. This is useful when you actively use multiple API connections or need to switch between different configurations without surfing through the menus."]},{"l":"Accessing Connection Profiles","p":["This feature is enabled by default starting from SillyTavern 1.12.6 or later as a built-in extension, and available in the API Connections menu. If you wish to disable it, open the Extensions panel, click on \"Manager extensions\", locate Connection Profiles in the list, uncheck the \"Enabled\" checkbox, and then click \"Close\"."]},{"l":"What is Saved","p":["Connection Profiles store the following selections."]},{"l":"Common","p":["API type, model and the server URL","Settings preset"]},{"l":"Text Completion APIs","p":["System Prompt and its state","Instruct Mode state and template","Context Template","Tokenizer"]},{"l":"Chat Completion APIs","p":["Proxy preset"]},{"l":"Managing Connection Profiles","p":["Profiles only save the selection in dropdown fields, without knowing anything about the underlying settings. This means that you will lose unsaved changes by switching to a different profile. To prevent this, make sure to update all presets and templates if you don't want to lose ephemeral changes.","To save a profile, set all the required settings and click the \"Create\" button. Then review the settings and provide a name for the profile. A name should be unique.","To view the detailed information about a chosen profile, click on the \"Information\" button. Click again to hide the details.","Connection Profile settings are saved into settings.json without altering the associated profile save file until you press the \"Update\" button. This means that if you setup a profile, but then switch to a different one without updating, you will lose all of your previous changes.","To restore the changed selections from a saved profile, click the \"Reload\" button.","To delete a profile, click the \"Delete\" button and confirm the deletion. This action is irreversible."]},{"l":"Slash Commands","p":["Connection profiles can be managed using the following slash commands.","/profile [name]- switch to a profile if the argument is provided, or get the name of the current profile if not.","/profile-create [name]- saves the current settings as a new profile with the provided name.","/profile-list- returns a JSON-serialized array of available profile names.","/profile-get [name]- gets the details of the profile with the provided name as a JSON-serialized object.","/profile-update- updates the selected profile with the current settings."]}],[{"l":"Self-hosted AI models","p":["This guide is based on the author's personal experience and knowledge and is not an absolute truth. All statements should be taken with a grain of salt. If you have any corrections or suggestions, please contact us on Discord or send a PR to the SillyTavern documentation repository."]},{"l":"Intro","p":["This guide aims to help you get set up using SillyTavern with a local AI running on your PC (we'll start using the proper terminology from now on and call it an LLM). Read it before bothering people with tech support questions."]},{"i":"what-are-the-best-large-language-models","l":"What are the best Large Language Models?","p":["It is impossible to answer this question as there's no standardized scale of \"Best\". The community has enough resources and discussions going on Reddit and Discord to form at least some opinion on what is the preferred / go-to model. Your mileage may vary."]},{"i":"what-is-the-best-configuration","l":"What is the best configuration?","p":["If there was a best or no-brainer setup, would there even have to be a need for configuration? The best configuration is the one that works for you. It's a trial-and-error process."]},{"l":"Hardware requirements and orientation","p":["This is a complex subject, so I'll stick to the essentials and generalize.","There are thousands of free LLMs you can download from the Internet, similar to how Stable Diffusion has tons of models you can get to generate images.","Running an unmodified LLM requires a monster GPU with a ton of VRAM (GPU memory). More than you will ever have.","It is possible to reduce VRAM requirements by compressing the model using quantization techniques, such as GPTQ or AWQ. This makes the model somewhat less capable, but greatly reduces the VRAM requirements to run it. Suddenly, this allowed people with gaming GPUs like a 3080 to run a 13B model. Even though it's not as good as the unquantized model, it's still good.","It gets better: there also exists a model format and quantization called GGUF (previously GGML) which has become the format of choice for normal people without monster GPUs. This allows you to use an LLM without a GPU at all. It will only use CPU and RAM. This is much slower (probably 15 times) than running the LLM on a GPU using GPTQ/AWQ, especially during the prompt processing, but the model's ability is just as good. The GGUF creator then optimized GGUF further by adding a configuration option that allows people with a gaming-grade GPU to offload parts of the model to the GPU, allowing them to run part of the model at GPU speed (note that this doesn't reduce RAM requirements, it only improves your generation speed).","There are different sizes of models, named based on the number of parameters they were trained with. You will see names like 7B, 13B, 30B, 70B, etc. You can think of these as the brain size of the model. A 13B model will be more capable than the 7B from the same family of models: they were trained on the same data, but the bigger brain can retain the knowledge better and think more coherently. Bigger models also require more VRAM/RAM.","There are several degrees of quantization (8-bit, 5-bit, 4-bit, etc). The lower you go, the more the model degrades, but the lower the hardware requirements. So even on bad hardware, you might be able to run a 4-bit version of your desired model. There's even 3-bit and 2-bit quantization but at this point, you're beating a dead horse. There's also a further quantization subtypes named k_s, k_m, k_l, etc. k_m is better than k_s but requires more resources.","The context size (how long your conversation can become without the model dropping parts of it) also affects VRAM/RAM requirements. Thankfully, this is a configurable setting, allowing you to use a smaller context to reduce VRAM/RAM requirements. (Note: the context size of Llama2-based models is 4k. Mistral is advertised as 8k, but it's 4k in practice.)","Sometime in 2023, NVIDIA changed their GPU driver so that if you need more VRAM than your GPU has, instead of the task crashing, it will begin using regular RAM as a fallback. This will ruin the writing speed of the LLM, but the model will still work and give the same quality of output. Thankfully, this behavior can be disabled.","Given all of the above, the hardware requirements and performance vary completely depending on the family of model, the type of model, the size of the model, the quantization method, etc."]},{"l":"Model size calculator","p":["You can use Nyx's Model Size Calculator to determine how much RAM/VRAM you need.","Remember, you want to run the largest, least quantized model that can fit in your memory, i.e. without causing disk swapping."]},{"l":"Downloading an LLM","p":["To get started, you will need to download an LLM. The most common place to find and download LLMs is on HuggingFace. There are thousands of models available. A good way to find GGUF models is to check bartowski's account page: https://huggingface.co/bartowski. If you don't want GGUF, he links the original model page where you might find other formats for that same model.","On a given model's page, you will find a whole bunch of files.","You might not need all of them! For GGUF, you just need the .gguf model file (usually 4-11GB). If you find multiple large files, it's usually all different quantizations of the same model, you only need to pick one.","For .safetensors files (which can be GPTQ or AWQ or HF quantized or unquantized), if you see a number sequence in the filename like model-00001-of-00003.safetensors, then you need all 3 of those .safetensors files + all the other files in the repository (tokenizer, configs, etc.) to get the full model.","As of January 2024, Mixtral MOE 8x7B is widely considered the state of the art for local LLMs. If you have the 32GB of RAM to run it, definitely try it. If you have less than 32GB of RAM, then use Kunoichi-DPO-v2-7B, which despite its size is stellar out of the gate."]},{"l":"Walkthrough for downloading Kunoichi-DPO-v2-7B","p":["We will use the Kunoichi-DPO-v2-7B model for the rest of this guide. It's an excellent model based on Mistral 7B, that only requires 7GB RAM, and punches far above its weight. Note: Kunoichi uses Alpaca prompting.","Go to https://huggingface.co/brittlewis12/Kunoichi-DPO-v2-7B-GGUF","Click 'Files and versions'. You will see a listing of several files. These are all the same model but offered in different quantization options. Click the file 'kunoichi-dpo-v2-7b.Q6_K.gguf', which gives us a 6-bit quantization.","Click the 'download' button. Your download should start."]},{"l":"How to identify the type of model","p":["Good model uploaders like TheBloke give descriptive names. But if they don't:","Filename ends in .gguf: GGUF CPU model (duh)","Filename ends in .safetensors: can be unquantized, or HF quantized, or GPTQ, or AWQ","Filename is pytorch-***.bin: same as above, but this is an older model file format that allows the model to execute arbitrary Python script when the model is loaded, and is considered unsafe. You can still use it if you trust the model creator, or are desperate, but pick .safetensors if you have the option.","config.json exists? Look if it has a quant_method.","q4 means 4-bit quantization, q5 is 5-bit quantization, etc","You see a number like -16k? That's an increased context size (i.e. how long your conversation can get before the model forgets the beginning of your chat)! Note that higher context sizes require more VRAM."]},{"i":"installing-an-llm-server-oobabooga-or-koboldai","l":"Installing an LLM server: Oobabooga or KoboldAI","p":["With the LLM now on your PC, we need to download a tool that will act as a middle-man between SillyTavern and the model: it will load the model, and expose its functionality as a local HTTP web API that SillyTavern can talk to, the same way that SillyTavern talks with paid webservices like OpenAI GPT or Claude. The tool you use should be either KoboldAI or Oobabooga (or other compatible tools).","This guide covers both options, you only need one.","If you are hosting SillyTavern on Docker, use http://host.docker.internal: instead of http://127.0.0.1:. This is because SillyTavern connects to the API endpoint from the server running in the Docker container. Docker's network stack is separate from the host's, and so the loopback interfaces are not shared."]},{"i":"downloading-and-using-koboldcpp-no-installation-required-gguf-models","l":"Downloading and using KoboldCpp (No installation required, GGUF models)","p":["Visit https://koboldai.org/cpp where you will see the latest version with various files you can download. At the time of writing the newest CUDA version they list is cu12 which will work best on modern Nvidia GPU's, if you have an older GPU or a different brand you can use the regular koboldcpp.exe. If you have an old CPU its possible that KoboldCpp will crash when you try to load models, in that case try the _ oldcpu version to see if it resolves your issue.","KoboldCpp does not need to be installed, once you start KoboldCpp you will immediately be able to select your GGUF model such as the one linked above using the Browse button next to the Model field.","By default KoboldCpp runs at a maximum of 4K context even if you set this higher in SillyTavern, if you wish to run a model at higher context make sure to adjust the context slider on this screen before launching the model. Keep in mind that more context size means higher (video) memory requirements, if you set this to high or load a model that is to big for your system KoboldCpp will automatically begin using your CPU for the layers it can not fit on your GPU, this will be much slower.","Click Launch, if everything goes well a new webpage will open with KoboldAI Lite where you can test if everything works correctly.","Open SillyTavern and click API Connections (2nd button in the top bar)","Set API to Text Completion and the API Type to KoboldCpp.","Set server URL to http://127.0.0.1:5001/ or the link that KoboldCpp gave you in case it is not running on the same system (You can activate KoboldCpp's Remote Tunnel mode to obtain a link that can be accessed from anywhere).","Click Connect. It should connect successfully and detect kunoichi-dpo-v2-7b.Q6_K.gguf as the model.","Chat with a character to test that it works."]},{"i":"tips-for-optimizing-koboldcpps-speed","l":"Tips for Optimizing KoboldCpp's speed","p":["Flash Attention will help reduce the memory requirements, it can be faster or slowing depending on your system and will allow you to fit more layers on your GPU than the default.","KoboldCpp will leave some space for other software when it guesses layers to prevent issues, if you have few programs open and are unable to fit the model entirely in the GPU you may be able to add a few extra layers.","If the model uses up to much memory for the context size you can decrease this by Quantizing the KV. This will reduce the quality of the output but can help you put more layers on the GPU. To do this you go to the Tokens tab in KoboldCpp and then disable Context Shifting and enable Flash Attention. This will unlock the Quantized KV Cache slider, a lower number means less memory / intelligence of the model.","Running KoboldCpp on a slower system where it takes long to process the prompt? Context Shifting works best when you avoid using Lorebooks, randomization or other features that dynamically change the input. Leaving context shifting enabled KoboldCpp will help you avoid long reprocessing times."]},{"l":"Installing Oobabooga","p":["Here's a more correct/dummy proof installation procedure:","git clone https://github.com/oobabooga/text-generation-webui(or download their repo as a .zip in your browser, then extract it)","Run start_windows.bat or whatever your OS is","When asked, select your GPU type. Even if you intend to use GGUF/CPU, if your GPU is in the list, select it now, because it will give you the option to use a speed optimization later called GPU sharding (without having to reinstall from scratch). If you have no gaming-grade dGPU (NVIDIA, AMD), select None.","Wait for the installation to finish","Place kunoichi-dpo-v2-7b.Q6_K.gguf in text-generation-webui/models","Open text-generation-webui/CMD_FLAGS.txt, delete everything inside and write: --api","Restart Oobabooga","Visit http://127.0.0.1:5000/docs. Does it load a FastAPI page? If not, you messed up somewhere."]},{"l":"Loading our model in Oobabooga","p":["Open http://127.0.0.1:7860/ in your browser","Click the Model tab","In the dropdown, select our Kunoichi DPO v2 model. It should have automatically selected the llama.cpp loader.","(Optional) We mentioned 'GPU offload' several times earlier: that's the n-gpu-layers setting on this page. If you want to use it, set a value before loading the model. As a basic reference, setting it to 30 uses just under 6GB VRAM for 13B and lower models. (it varies with model architecture and size)","Click Load"]},{"l":"Configuring SillyTavern to talk to Oobabooga","p":["Click API Connections (2nd button in the top bar)","Set API to Text Completion","Set API Type to Default (Oobabooga)","Set server URL to http://127.0.0.1:5000/","Click Connect. It should connect successfully and detect kunoichi-dpo-v2-7b.Q6_K.gguf as the model.","Chat with a character to test that it works"]},{"l":"Conclusion","p":["Congrats, you should now have a working local LLM."]}],[{"l":"Chat Completions"},{"l":"OpenAI"},{"l":"API key","p":["How to get:","Go to OpenAI and sign in.","Use \" View API keys\" option to create a new API key.","Important!","Lost API keys can't be restored! Make sure to keep it safe!"]},{"l":"Claude","p":["If you have access to Anthropic's Claude API:","Select 'Claude' for 'Chat Completion Source'.","Input your API key.","Click connect."]},{"l":"Mistral AI","p":["Mistral AI is a team developing both open and proprietary models with high scientific standards and a focus on openness. You can run their models locally or through their API service, La Plateforme."]},{"l":"API","p":["The first step is to create an account on La Plateforme.","Once that's done, you can choose a plan and set up your payment information or opt for the Free Tier.","Next, you can create your API key. You may need to wait a couple of minutes before the key becomes valid!","Important! Lost API keys can't be restored! You would have to create a new one. Make sure to keep it safe!"]},{"l":"Proxy","p":["Back in the 'AI Connections' tab, you can find two optional checkboxes labeled:","Bypass API status check.","Checking 'Bypass API status check' tells SillyTavern to stop alerting you about a non-functioning API endpoint. Check this if your API endpoint works, but SillyTavern keeps warning you anyway.","Checking 'Show \"External\" models (provided by API)' will show the external available models as reported by your custom API endpoint in the dropdown (scroll down past OpenAI's models). This allows you to select different API models right from SillyTavern without having to go into your custom app and change the model.","Examples of backends which implement this API are:","Hint: If it doesn't work, try adding /v1 at the end of the endpoint URL!","If you intend to use this proxy feature to use a local endpoint, like TabbyAPI, Oobabooga, Aphrodite, or any like those, you might want to check out the built-in compatibility for those instead. This proxy feature is mainly intended for use with other services and programs that expose an OpenAI-compatible API Chat Completion endpoint.","It is important to note that we do not provide support for possible issues that you may have! We do not guarantee compatibility with every possible API endpoint!","It is possible to configure a proxy/alternative endpoint for OpenAI's backend. This custom endpoint can connect to alternative Chat Completion APIs that support the generic OpenAI API schema.","Leaving the details like the API key empty.","LiteLLM","LM Studio","LocalAI","Most Text Completion APIs support far greater customization options than OpenAI's standards allow for. These greater customization options, such as the Min-P sampler, may be worthwhile for SillyTavern users to check out, which can greatly improve the quality of generations.","Opening the 'AI Response Configuration' tab and scrolling down to the 'OpenAI / Claude Reverse Proxy' section.","Selecting 'OpenAI' for 'Chat Completion Source'.","Show \"External\" models (provided by API).","Switching to the 'Chat Completion' API type.","There you may enter the proxy/custom endpoint and optionally an API key under 'Proxy Password' if needed. For example, TabbyAPI provides you with an API key you have to use.","This feature is accessed by:","This feature is not required for custom API endpoints to work and might not be available on every backend."]}],[{"l":"OpenRouter","p":["Don't have access to OpenAI / Claude APIs due to geolocking or waitlists? Use OpenRouter.","OpenRouter works by letting you use keys they own to access models like GPT-4 and Claude 2, all in one service with a shared credit pool.","It has a free trial (about $1) and paid access afterward. No subscription or monthly bill - you pay for what you actually use. Some models have free access with a limited context size.","OpenRouter Pricing Details","Create an OpenRouter account: openrouter.ai","OpenRouter-ConnectionPanel","From top to down (see image above):","Select 'Chat Completion' API","Select OpenRouter source","Click \"Authorize\" to get a key using OAuth flow. Alternatively, generate an API key here and paste it into the box.","Click \"Connect\" and select a model","(Optional) Use the \"Test Message\" button to verify your connection"]},{"l":"WindowAI","p":["WindowAI is a browser extension by the makers of OpenRouter that allows control of your OpenRouter connection for any enabled site or web app.","You can also use your own Claude and OpenAI API keys there."]}],[{"l":"AI Horde"},{"l":"Disclaimer","p":["AI Horde is a crowdsourced, distributed GPU cluster run entirely by volunteers.","By default, your inputs are anonymously sent and responses can not be seen by the person running the Horde Worker.","However, since it is an open-sourced program, Malicious Workers could modify the code to:","log your activity (input prompts, AI responses).","produce bad or offensive responses.","When using Horde never send any personal information such as names, email addresses, etc.","Switching on the \"Trusted Workers Only\" checkbox will limit the selection of available workers to only those who have been hosting on Horde for a while and are generally considered trusted. But they could still be seeing prompts, for example by hosting using unaccounted software.","To help reduce this problem, SillyTavern has built in the following feature:","When a chat response is generated by a Horde Worker, SillyTavern records the Worker's ID and what model they were using.","This information can be seen by hovering your mouse cursor over the chat item (see image below).","If you believe you received a malicious response, you can pass this information to the Horde admin on the AI Horde Discord for review and possible disciplinary action against that Worker.","Horde Worker Info Popup"]},{"l":"Setup","p":["SillyTavern is able to connect with Horde out of the box with no additional setup required.","Select 'AI Horde' from the API Dropdown Selector in the ST API Panel.","Select one or more Models ('AI brains' for the characters) from the Model Selector at the bottom of the panel.","Select a character and begin chatting.","ST Kobold Horde API Connection Panel","By default, your SillyTavern instance connects to the Horde's low priority 'guest account'. This means you may have to wait a long time for a reply. To reduce wait times, follow the tips down below."]},{"l":"Tips","p":["Register an account on the Horde website then add your Horde key into the SillyTavern Horde API Key box.","Set up a Horde Worker to provide your GPU for others.","Letting others use your GPU earns you 'Kudos', a kind of Horde-only currency.","The more kudos your account has, the faster you will get chat responses from other Horde Workers.","Kudos can also be used to create AI images on Stable Horde.","SillyTavern supports Stable Horde image generation out of the box.","If your GPU isn't powerful enough to run an AI, or you don't have a computer, you can still participate in the Horde community to earn Kudos in various ways."]}],[{"l":"DreamGen","p":["DreamGen is an app and an API for AI-powered creative writing. They have a free tier, as well as a paid subscription that allows unlimited monthly access to their high-quality in-house text generation models made specifically for the purpose of steerable AI-assisted writing. Create an account to get started: https://dreamgen.com/.","The (free) credits reset at the start of each calendar month. See pricing to see the credit cost for each model and usage to see your remaining credits."]},{"l":"Connecting to DreamGen"},{"l":"Get API Key","p":["Go to the DreamGen API keys page and click the \"New API Key\" button. Make sure the API Key is copied into your clipboard.","Create New DreamGen API key Copy DreamGen API key"]},{"l":"Connect","p":["Go to the SillyTavern connection settings.","Select API: Text Completion","Select API Type: DreamGen","Enter the API key","(optional) Pick a model","Connecting to DreamGen"]},{"l":"Models","p":["DreamGen offers opus-v1-sm, opus-v1-lg, and opus-v1-xl. The larger the model, the better it will be at following instructions and writing good stories."]},{"l":"Formatting Settings","p":["The DreamGen models expect a specific input format, which is documented here.","SillyTavern comes with built-in presets made for DreamGen. Make sure to use these settings as your baseline. These settings try to stick to the DreamGen format as closely as possible but due to the irregular formatting of character cards, it is not always perfect.","Go to the \"Advanced Formatting\" page.","Under \"Context Template\" pick DreamGen Role-Play V1 Llama3 / ChatML depending on the model (*).","Enable \"Instruct Mode\".","Under \"Instruct Mode Presets\" pick DreamGen Role-Play V1 Llama3 / ChatML.","DreamGen context settings DreamGen instruct settings","(*) When to use Llama 3 and when to use ChatML? As of 2024/06/17, opus-v1-sm is ChatML and all other models are Llama3 based. When running local models, the template will be indicated in the model's HuggingFace card."]},{"l":"Completion Settings","p":["DreamGen supports:","\"Temperature\", \"Top P\", \"Top K\" and \"Min P\"","\"Presence Penalty\", \"Frequency Penalty\" and \"Repetition Penalty\" (without range)","\"Min Length\" -- lets you force the model to generate at least min(min_length, max_tokens) tokens","Good starting values might be:","Min P: 0.05","Temperature: 0.8","Repetition Penalty: 1.1"]},{"l":"Tips for Formatting","p":["The DreamGen models differ from the regular instruction-following models like OpenAI's ChatGPT.","The models were fine-tuned for the task of writing a story based on the provided description which typically consists of plot description, style description, characters, locations, lore, etc. The models can also be steered in the middle of the story, making you the director, telling the characters what they should do or how the plot should unfold.","A well-formatted system prompt message would look like this:","Note that the prompt should be a description of the story, rather than instructions or directives on how the story should be written. Avoid using phrases like:","\"Write the story as if...\"","\"Make sure to...\"","etc.","See more examples of what the plot, style and character descriptions should look like.","The default \"DreamGen Role-Play V1\" template substitutes the different sections as follows:","## Plot description: will consist of {{scenario}} and {{wiBefore}}.","## Style description: is not provided, you should either add it to the system prompt under Advanced Settings, or to the character cards, at the end of {{scenario}}. This section is useful to influence the narrative style (first, second, third person), the tense (past, present), the level of detail and verbosity, etc.","## Characters: will have a {{char}} character with description consisting of {{description}} and {{personality}} and a {{user}} character with description consisting of {{persona}}."]},{"l":"Message Examples and Initial Message","p":["The DreamGen models are very responsive to the context -- they will largely stick to the writing style (and facts) presented in the previous conversation turns. This makes the message examples and the initial message very important."]},{"l":"Formatting Message Examples","p":["The {{mesExamples}} are appended at the end of the system prompt. To take full advantage of the instruct formatting, make sure that your examples are separated with the START separator. For example:"]},{"l":"Examples","p":["Here are a couple of example cards, adapted for DreamGen, that take into account the unique prompting. These cards also leverage the {{mesExamples}} as described above."]},{"l":"Seraphina","p":["This is an edit of the popular Seraphina card that's built into SillyTavern by default."]},{"l":"Lara Lightland","p":["This is an edit of the Lara Lightland card by Deffcolony."]},{"l":"FAQ"},{"i":"what-sampler-settings-should-i-use","l":"What sampler settings should I use?","p":["You can start with these:","Temperature: 1.0","MinP: 0.05","Presence Penalty: 0.1","Frequency Penalty: 0.1"]},{"i":"how-can-i-make-the-responses-longer-or-shorter","l":"How can I make the responses longer or shorter?","p":["You have several options:","Change or add the ## Style description: in the system prompt or model card. You can try adding something like \"Sentences are generally long, and the narrative describes the setting in painstaking detail.\"","Change the Min Length in the Completion Settings.","Add Last Output Sequence similar to the following in the Advanced Formatting settings under Instruct Mode:","Here's an example of the Last Output Sequence that might help make the model respond in a more verbose way, using the Llama 3 template:","The same expressed using the ChatML template:","You can change the text within to something more suitable for your scenario or context."]},{"i":"how-can-i-stop-the-model-from-repeating-itself","l":"How can I stop the model from repeating itself?","p":["If the model repeats what's in the context, you can try increasing \"Repetition Penalty\" in the Completion Settings or you can try rephrasing the part of the context that's getting repeated. If the model repeats itself within one message, you can try increasing \"Presence Penalty\" or \"Frequency Penalty\"."]},{"i":"how-can-i-steer-the-story","l":"How can I steer the story?","p":["If you want to direct the characters to do something, or to steer the plot in certain direction, you can use the user role (that is the |im_start|user preamble).","At this point, this functionality is not neatly integrated into SillyTavern natively, but you can use the Last Output Sequence as described above to insert the user(instruction) turn. See examples of what the instructions should look here."]}],[{"l":"KoboldCpp","p":["KoboldCpp is a self-contained API for GGML and GGUF models.","This VRAM Calculator by Nyx will tell you approximately how much RAM/VRAM your model requires."]},{"l":"Nvidia GPU Quickstart","p":["As of version 1.58, KoboldCpp should look like this:","Click Launch and wait for the model to load.","Click Save so you don't have to configure KoboldCpp on every launch.","Congratulations! You're done!","Do not tick Low VRAM, even if you have low VRAM.","Download the latest release: https://github.com/LostRuins/koboldcpp/releases","GPU Layers should have been populated when you loaded your model. Leave it there for now.","Kind of.","KoboldCpp 1.58","Launch KoboldCpp. You may see a pop-up from Microsoft Defender, click Run Anyway.","Select Use CuBLAS and make sure the yellow text next to GPU ID matches your GPU.","This guide assumes you're using Windows.","Under the Hardware tab, tick High Priority.","Under the Quick Launch tab, select the model and your preferred Context Size.","Unless you have an Nvidia 10-series or older GPU, untick Use QuantMatMul (mmq).","You can now connect to KoboldCpp within SillyTavern with http://localhost:5001 as the API URL and start chatting.","You should see something like this:"]},{"l":"GPU Layers","p":["KoboldCpp is working, but you can improve performance by ensuring that as many layers as possible are offloaded to the GPU. You should see something like this in the terminal:","Don't be afraid of numbers; this part is easier than it looks. CPU buffer size refers to how much system RAM is being used. Ignore that. CUDA0 buffer size refers to how much GPU VRAM is being used. CUDA_Host KV buffer size and CUDA0 KV buffer size refer to how much GPU VRAM is being dedicated to your model's context. In this case, KoboldCpp is using about 9 GB of VRAM.","I have 12 GB of VRAM, and only 2 GB of VRAM is being used for context, so I have about 10 GB of VRAM left over to load the model. Because 9 layers used about 7 GB of VRAM and 7000 / 9 = 777.77 we can assume each layer uses approximately 777.77 MIB of VRAM. 10,000 MIB / 777.77 = 12.8, so I'll round down and load 12 layers with this model from now on.","Now do your own math using the model, context size, and VRAM for your system, and restart KoboldCpp:","If you're smart, you clicked Save before, and now you can load your previous configuration with Load. Otherwise, select the same settings you chose before.","Change the GPU Layers to your new, VRAM-optimized number (12 layers in my case).","Click Save to save your updated configuration.","You should now see something like this:","KoboldCpp is using about 11.5 GB of my 12 GB VRAM. This should perform a lot better than the settings generated automatically by KoboldCpp.","Congratulations! You're (actually) done!","For a more in-depth look at KoboldCpp settings, check out Kalmomaze's Simple Llama + SillyTavern Setup Guide."]}],[{"l":"Mancer","p":["Mancer is a large language model inferencing service that lets you run whatever prompts you want and doesn't censor responses. Most of the models require a preloaded balance to start chatting, but there is a free model as of writing (2024-11-28).","Models","Pricing"]},{"l":"How to Get Started","p":["Sign up for an account at mancer.tech.","Click on Dashboard and copy your API Key.","Mancer dashboard as of 2/27/2024","In SillyTavern, select the Text Completion API, and then select Mancer under API Type.","Enter your Mancer API Key and click Connect.","API Key","You should now be able to chat with any Mancer model of your choice."]},{"l":"Anonymous Logging","p":["If you don't mind your chats potentially being used to train models, improve Mancer's service, publish datasets, or whatever else they may decide to do with it, you can opt-in to anonymous logging for a 25% token discount on select models. Simply go to your Mancer dashboard and tick Enable Anon. Logging."]},{"l":"Support","p":["Still need help? Head over to the #mancer support channel on the SillyTavern Discord."]}],[{"l":"NovelAI","p":["NovelAI is a paid subscription service that allows unlimited monthly access to their high-quality in-house text generation, image generation, and text-to-speech models. Register an account here to get started: https://novelai.net/","You will get only 50 generations for free to evaluate the model. When the \"Not eligible for this model\" error appears, this means that you've exhausted your trial period and need to subscribe to a paid plan."]},{"l":"API Key","p":["To get your NovelAI API key, follow these steps:","Select the gear icon at the top of the left sidebar. Left Sidebar","Select \"Account\" under \"User Settings\". User Settings","Select \"Get Persistent API Token\". Account","Select the copy icon to copy your NovelAI API token to the clipboard. Persistent API Token"]},{"l":"Models","p":["If you have Opus, then Erato is the model to use. If you don't have Opus, then Kayra is the best available model.","Clio has a larger context size on Tablet/scroll tiers, but the strength of Kayra usually makes up for that difference."]},{"l":"Settings","p":["The files with the settings are here ( SillyTavern/data/user-handle/NovelAI Settings). You can also manually add your own settings files."]},{"l":"Response Length","p":["How much text you want to generate per message. Note that NovelAI has a limit of 150 tokens per response."]},{"l":"Context Size","p":["How many tokens of the chat are kept in the context at any given time. How large the maximum context size you can use depends on the model and your subscription tier:","Kayra (Tablet) - 3072 tokens","Kayra (Scroll) - 6144 tokens","Erato (Opus exclusive), Kayra (Opus) and Clio (all tiers) - 8192 tokens"]},{"l":"Preamble","p":["Text that is inserted right above the chat to modify the writing style. The recommended format is a list of short tags, like \"[Style: chat, detailed, sensory ]\"."]},{"l":"Preset Descriptions","p":["This is, according to Novel AI, what the default presets are good for."]},{"l":"Erato","p":["Golden Arrow - A good all-rounder.","Wilder - Higher variety of word choice, more differences between rerolls, more prone to mistakes.","Zany Scribe - Avoids mistakes and repetition. Prioritizes more complex words.","Dragonfruit - Varied and complex language with little repetition. More frequent mistakes and contradictions.","Shosetsu - Designed for writing in Japanese. Works fine for English too."]},{"l":"Kayra","p":["Asper - For creative writing. Expect unexpected twists.","Carefree - A good All-rounder","Fresh-Coffee - Keeps things on track. Handles instruct well.","Pro_Writer - Mimic the pacing and feel of best-selling fiction","Stelenes - More likely to choose reasonable alternatives. Variety on retries.","Tea_Time - It gets good when it gets going.","Writers-Daemon - Extremely imaginative, sometimes too much."]},{"l":"Clio","p":["Edgewise - Handles a variety of generation styles well","Fresh Coffee - Keeps things on track.","Long-Press - Intended for creative prose.","Talker Chat - Designed for chat style generation.","Vingt-Un - A good all-around default with a bent towards prose."]},{"l":"Tips and FAQs for using NovelAI with SillyTavern","p":["There are a lot of common problems and questions that come up when switching to NovelAI from another ST backend API. The difference comes down to what the models are trained for. Most likely, you've used an OpenAI or Anthropic model (or a local model made to resemble those), which is built around following the user's instructions. NovelAI's models are built purely around text completion: instead of taking your input as a message and formulating a response, NAI's models attempt to continue the incoming prompt. Due to this difference, a lot of tips and common knowledge that work for other APIs won't work for NAI."]},{"l":"Tweaking settings for NovelAI","p":["Under Advanced Formatting (the A icon):","Set \"Context Template\" to \"NovelAI\"","Set \"Tokenizer\" to \"Best match\"","Check \"Always add character's name to prompt\"","Check \"Collapse Consecutive Newlines\"","Uncheck the \"Enabled\" box under \"Instruct Mode\"","Under User Settings (the person with a gear)","Turn on \"Swipes\" (Not NAI specific, but it's so useful you should just do it)"]},{"i":"buildingadapting-character-cards-for-novelai","l":"Building/Adapting character cards for NovelAI","p":["To optimize your character cards for NovelAI, there are a couple of recommended methods for writing your character's description: prose, and attributes.","Prose is so simple it doesn't feel like it should work: \"Sylpheed is a young-looking but actually 900 year old nymph. She's short and petite, with long white hair that fades into a green gradient in her braided side ponytail, and emerald green eyes shaped like crosses.[...]\" No, really, that's it. Just write out, in normal sentences, what the character looks like, acts like, etc., and the AI will pick up on it.","If you don't trust your writing abilities or want a more structured way to go about it, you can use the attributes method, which is present in the NovelAI training data. This works as a simple list of character traits of different types. Here's a list of possible attributes that have been tested to be effective with NovelAI's models:","\"Type: character\" is there to tell the AI that this is describing a character (as opposed to a location, object, or other type of thing). The rest of the attributes are optional, and some are redundant (for example, Personality, Mind, and Mental all mean basically the same thing), but these have been tested and work well with NovelAI's models. Fill in whichever ones are relevant to your character. The attributes should be written in lower case and separated by commas, no need for quotes around the words. For example:","These methods are recommended because they're present in NovelAI's training data, so they specifically work well with the model."]},{"l":"Example cards","p":["Here are a couple of example cards, made for NovelAI, that show off different ways of creating cards specifically for NovelAI. The first card, Valka, uses the attributes method for the character description, while Eris, the second card, uses prose descriptions, along with a large amount of example dialogue.","Valka","Eris"]},{"l":"What not to do","p":["Most of the existing character card formats are a poor fit for NovelAI. They'll give you some results, even some good ones, but they have a lot of problems. W++ is one of the biggest offenders, where it doesn't resemble anything that NovelAI's models were trained on, and its constant use of brackets/braces/quotes eats up a ton of tokens, bloating the size of the cards with no real benefit.","Of the existing formats that aren't baked into NovelAI, AliChat is the one most likely to work, as it relies on using example messages to get across both information about the character and their voice at the same time, in the format of the type of message that you want the AI to output.","For most other formats, since they are usually ways of listing out different characteristics of a particular character, they can be converted to the attributes method rather straightforwardly."]},{"i":"which-module-should-i-use","l":"Which module should I use?","p":["Probably No Module. Prose Augmenter is useful if you want a character to speak in a more flowery manner, but be careful not to overdo it. Text Adventure might be useful for a text adventure-style card/story."]},{"i":"not-the-instruct-module","l":"Not the instruct module?","p":["You can invoke the Instruct module when you need it. Create a newline in your message, and put your instructions in curly brackets like this: { CharName is offended by that seemingly innocuous statement }(the spaces are required between the text and the brackets). Doing that will automatically switch the AI into the Instruct module for a short time. You don't want to use the Instruct module all the time because it tends to produce less creative output than the other modules, just when you need to guide the AI strongly in a particular direction."]},{"i":"why-do-my-responses-keep-getting-cut-off","l":"Why do my responses keep getting cut off?","p":["NovelAI limits response length to ~ 150 tokens total, even if you set the slider higher than that. When it reaches the number of tokens in the slider or 150, whichever is lower, it will generate up to 20 more tokens, looking for a stop sequence or the end of a sentence, so there's an effective limit of 170 tokens for a response, at which point it will just stop, causing it to cut off.","If it cuts off, you can select the continue option (in the three-line menu to the left of the text box) to get the character to continue their response.","If you regularly want responses longer than 170 tokens, you can work around the limit like this:","Keep the response length at 150 tokens.","Under Advanced Formatting, enable Auto-continue.","Set the \"Target length\" to the desired length.","This will chain together multiple generations to give you longer messages but doesn't guarantee that the reply will be 100% of the desired length if the model decides to stop."]},{"i":"how-do-i-get-the-bot-to-write-longer-responses","l":"How do I get the bot to write longer responses?","p":["Read the above about responses getting cut off. That will help to make sure that responses aren't cut off prematurely by running into the limit of generation length.","If your responses aren't getting cut off but are still too short, it's likely you're dealing with \"garbage in, garbage out\" - if you give the model bad examples, it will produce bad output. If the character card has no example dialogue or short example dialogue and the messages you send to the bot are short, the model will pick up on that, take it as the accepted way to do things and the responses will be short. So, write longer example dialogue and longer messages to the bot. (You can always use NovelAI to write some example dialogue for you rather than doing it yourself.)"]},{"i":"how-do-i-get-the-bot-to-stop-talking-for-me","l":"How do I get the bot to stop talking for me?","p":["Check that the character card's first message and example dialogue don't include the character taking actions for you - if they do, then rewrite them to get rid of it acting for you","Make sure that \"Always add character's name to prompt\" is checked","Make sure that you're currently using the same user persona as the rest of the chat. If you changed user personas and didn't change back (or don't have a persona locked to that chat), the usual rules to stop generating for you will fail","Add [\"\\n{{user}}:\"] to Custom Stopping Strings (shouldn't be necessary, but sometimes helps)"]},{"i":"why-isnt-my-character-responding","l":"Why isn't my character responding?","p":["A lot of things can cause this, so we need to look in a few places:","Make sure that \"Always add character's name to prompt\" is checked in Advanced Formatting","Check to make sure there aren't any errors coming from the API. While you can use SillyTavern with the NAI free trial, once it runs out, you'll just get errors","Check what you have in \"Custom Stopping Strings\" - if those are being generated at the start of the response, it might be cut off prematurely"]},{"i":"how-should-i-use-the-authors-note","l":"How should I use the Author's Note?","p":["In general, you probably shouldn't. It's inserted very close to the end of the context, and with NAI's models, it frequently overpowers everything else in the context. It's mostly an artifact from older, weaker models where it was more necessary."]},{"i":"how-do-i-do-a-scene-breaktime-jump","l":"How do I do a scene break/time jump?","p":["Put the following as a system message or on newlines at the start of your next message:","Then put the rest of your message on the next line. The bracketed text can be a time jump, a new location, or anything else. The \"***\" (hilariously named a \"dinkus\") tells the AI that the scene has changed, and the bracketed text gives that more context."]},{"i":"the-ai-keeps-repeating-specific-wordsphrases-what-do-i-do","l":"The AI keeps repeating specific words/phrases, what do I do?","p":["As mentioned above, you can push the repetition penalty slider up a bit more, though pushing it too far can make the output incoherent. To more thoroughly fix the problem, go back through the context, especially recent messages, and delete the repeated word/phrase. Removing it from the context gives the AI less reason to start saying it in the first place."]}],[{"l":"Scale","p":["Scale is an easy way to access GPT-4 and other LLMs through deployed \"apps\" that act like API endpoints.","Currently, Scale doesn't support token streaming and configuring parameters like temperature through SillyTavern's UI.","Scale API is not free, but offers a $5 trial if you link a credit card."]},{"l":"Quick Start","p":["{{ input }}","Click \"Save New Variant\"","Complete the next response in this fictional chat.","Configure the model parameters.","Create a \"Variant\", which sets the parameters (system prompt, model, temperature, response token limit, etc)","Create a Scale Spellbook account at https://spellbook.scale.com(if your country is not supported, use a VPN)","Create an \"App\" with any name and description","Go to your new Variant and click Deploy","Maximum Tokens: 400 - 600 (depending on message length preference)","Model: GPT-4","Navigate to SillyTavern, select \"Chat Completion\" API, and Scale source","Paste the API key and URL into the appropriate fields and click \"Connect\"","Replace the contents of the \"User\" section of the prompt with the following:","Select a proper language model to be deployed (GPT-4 is recommended)","Temperature:~ 0.6 - 0.9","This will create an API key and URL for your bot"]},{"l":"Credits","p":["Implementation and documentation are inspired by the work of khanon on TavernAIScale."]}],[{"l":"TabbyAPI","p":["A FastAPI based application that allows for generating text using an LLM using the Exllamav2 backend, with support for Exl2, GPTQ, and FP16 models.","GitHub"]},{"l":"Quickstart","p":["Follow the installation instructions on the official TabbyAPI GitHub.","Create your config.yml to set your model path, default model, sequence length, etc. You can ignore most (if not all) of these settings if you want.","Launch TabbyAPI. If it worked, you should see something like this:","TabbyAPI terminal","Under the Text Completion API in SillyTavern, select TabbyAPI.","Copy your API key from the TabbyAPI terminal into Tabby API key and make sure your API URL is correct (it should be http://127.0.0.1:5000 by default).","If you did everything correctly, you should see something like this in SillyTavern:","TabbyAPI SillyTavern","You can now chat using TabbyAPI!"]},{"l":"TabbyAPI Loader","p":["The developers of TabbyAPI created an official extension to load/unload models directly from SillyTavern. Installation is simple:","In SillyTavern, click on the Extensions tab and navigate to Download Extensions & Assets.","Copy https://raw.githubusercontent.com/theroyallab/ST-repo/main/index.json into Assets URL and click the plug button to the right.","You should see something like this. Click the download button next to Tabby Loader.","Tabby Loader","If the installation was successful, you should see a green pop-up message at the top of your screen. Under the extensions tab, navigate to TabbyAPI Loader and copy your admin key from the TabbyAPI terminal into Admin Key.","Click the refresh button next to Model Select. When you click on the textbox just below it, you should see all of the models in your model directory.","Tabby Loader Extension","You can now load and unload your models directly from SillyTavern!"]},{"l":"Support","p":["Still need help? Visit the TabbyAPI GitHub for a link to the developer's official Discord server and read the wiki."]}],[{"l":"Prompts","p":["When you send a message to your AI, the text you write is combined with other text to form a single request that's sent to the AI. This combined text is called a \"prompt\" or sometimes the \"request\" or \"context.\"","The prompt can include a variety of different types of text, including:","Main instructions to the AI about how to generate a response","Definitions of the roles that the AI should take on","Definitions of the role that you are taking on","Information about the \"world\" that the AI is interacting with","Relevant documents or information from Data Bank","Summaries of the past conversation","Results of web searches or other external data sources","Previous messages in the conversation","Your message to the AI","Final instructions for the AI about how to generate a response","This can be a lot to manage! To help you understand how to structure and modify the request that's sent to the AI, SillyTavern identifies different elements that you might want to include in your prompt. You can then structure your prompt to include the things that make sense for the way you want to interact with the AI.","Many of these elements are explained in the sections where you will change them. For example, to describe the role that you would like the AI to take on, you could use the Description field in Character Design."]},{"l":"Viewing the Prompt","p":["Reading the final prompt that's sent to the AI is very helpful for understanding what the AI was told, and why it generated the response that it did. You can view the prompt in several ways:","Using the Prompt Itemization icon on the reply message from the AI","Using the Prompt Inspector extension","Checking the logs in the terminal window that you're running SillyTavern in","Checking the console in your browser's developer tools"]},{"l":"Changing how the Prompt is Built","p":["Presenting all the parts of your prompt to the AI in the right way is crucial for getting the best responses. You can control how the prompt is built.","Use the Advanced Formatting panel to customize prompt construction for Text Completion APIs.","Use the Prompt Manager to customize prompt construction for Chat Completion APIs."]},{"i":"main-prompt-system-prompt","l":"Main Prompt (System Prompt)","p":["The Main Prompt (or System Prompt) defines the general instructions for the model to follow. It sets the tone and context for the conversation. For example, it tells the model to act as an AI assistant, a writing partner, or a fictional character.","The System Prompt is a part of the Story String and usually the first part of the prompt that the model receives.","The Main Prompt is one of the default prompts in Prompt Manager. It is usually the first message in the context that the model receives, attributed to (\"sent by\") the system role.","The default Main Prompt is:","Write {{char}}'s next reply in a fictional chat between {{char}} and {{user}}.","The {{char}} and {{user}} placeholders are replaced with the names of the character and persona that you've defined in the conversation.","You can use any of the supported {{macro}} tags in the Main Prompt to include information that might vary between conversations or changes as the conversation progresses."]},{"l":"Adjusting the Main Prompt","p":["The default main prompt helps the model understand what it's expected to do with the character and persona information that follows, how to interpret the past conversation, and what kind of response to generate. It's a flexible general-purpose prompt that works well for many situations, because it establishes that the AI is writing as a character in a conversation with your persona.","However, you can adjust the main prompt to better suit your needs. Here are some common reasons to adjust the main prompt:","Provide additional instructions: for example, you want the AI to explain its reasoning, follow specific rules, or avoid certain topics","Clarify the role of the AI: for example, you want the AI to act as a narrator, a storyteller, or a guide","Change the context of the conversation: for example, you want the AI to respond as if it were an AI assistant, text adventure game, or a writing partner","All the examples in this guide have worked well for other users, but the prompt that works for your needs and the model you're using might be different. Experiment with different instructions and prompting styles to see what works best for you. If you're not sure what to try, you can always ask for help in the SillyTavern Discord.","Giving the AI additional instructions in the Main Prompt can help it understand what you want from the conversation.","Write one reply only. Write at least one paragraph, up to four.","Markdown is enabled. Use it to format your response. Enclose code snippets in triple backticks.","Write character dialogue in quotation marks. Write {{char}}'s thoughts in parentheses.","You are an anime roleplay generation model for users aged 13 to 17. You always generate fun, age-appropriate responses.","Answer truthfully and write out your thinking step by step to be sure you get the right answer.","The AI will more easily follow instructions about what it should do than what it should not do. For example, if you want the AI to avoid writing in a certain way, it's better to tell it how you want it to write instead. And while \"Do not decide what {{user}} says or does\" is commonly included in prompts to prevent the AI from controlling your persona, some users find \"Write {{char}}'s responses in a way that respects {{user}}'s autonomy\" is more effective.","There is often a better place than the Main Prompt to include information about the user or characters, modify a character's writing and speaking style, or give other specific instructions. The Main Prompt is best used for general instructions about the conversation as a whole, or about a type of conversation that you want to have."]},{"l":"Effect of Message History","p":["When adjusting the main prompt to improve the AI's responses, consder that the AI picks up a lot from the message history. The history is its memory of past events, character interactions and relationships, and its style guide for word choice and writing style.","Use this to your advantage by also providing example messages showing how you want the AI to respond. Showing what you want is often easier than trying to explain it!","When your conversation already has history, changing the main prompt has a limited effect on the AI's responses. In terms of events and relationships, the AI assumes that the main prompt occurred in the distant past, and the message history updates it. In terms of writing style and word choice, the AI assumes that all the messages in history were generated according to the rules in the current main prompt, and that it should continue to generate messages in the same way. Some suggestions for dealing with this are:","insert current instructions close to or after the end of message history, for example by using an Author's Note","test your changes to the main prompt by starting a new conversation","edit the message history to remove or correct examples of unwanted behaviour","use the Post-History Instructions to provide final instructions to the AI","Never let the AI \"get away\" with something you don't want it to do. If you don't like the AI's response, don't continue the conversation as if it was correct. Instead, modify the prompts, regenerate the message, and continue from there. This will help the AI learn what you want."]},{"i":"removing-the-fictional-chat-context","l":"Removing the \"Fictional Chat\" Context","p":["There are situations where \"fictional chat\" might not be the right context for your conversation.","You can remove the \"fictional\" context from the Main Prompt:","Write {{char}}'s next reply in a conversation with {{user}}.","You may not want the AI to think of itself as role-playing at all. Instead of removing the idea of a character, you can remove the idea of an AI:","You are {{char}}, a helpful assistant. You provide useful information and help {{user}} with their questions."]},{"l":"AI as Narrator or Storyteller","p":["What if you want the AI to act as a narrator, describing events from an omniscient perspective, inventing its own characters and settings?","One approach is to create a named character for the AI to use as a narrator. This character could be called \"Narrator\" or \"AI\", suggesting that the AI is a general-purpose storyteller, or it could be named after a specific scenario or setting, giving the AI the task of narrating a story in that setting. The details of the setting can then be defined in the Character or in World Info.","You will need to adjust the default main prompt to reflect the AI's role. For a general-purpose narrator, you might use:","You are {{char}}, a skilled and versatile storyteller. Narrate the story.","or for a specific setting:","You are the narrator of a fantasy scenario. Play as the characters that visit {{char}}.","It helps to clarify the role of the user in the conversation. Are your messages part of the story, or are they instructions to the narrator about what your character does or says? An example that includes the user in the story:","The story should progress by responding to the actions and dialogue of {{user}}. Narrate the story in third person.","An example that keeps the user out of the story:","Enter Adventure Mode. Narrate the story based on {{user}}'s dialogue and actions after \">\". Describe the surroundings in vivid detail. Be detailed, creative, verbose, and proactive. Move the story forward by introducing fantasy elements and interesting characters.","Defining the role of the user not only helps the AI understand how to respond to your messages, but also to what extent it is allowed to control your persona. This avoids situations where the AI makes decisions for your persona that you would rather make yourself."]},{"l":"Post-History Instructions","p":["Post-History Instructions are additional instructions sent to the AI after the main prompt and the user message. They can be used to provide additional context or instructions to the AI based on the message history.","Since the Post-History Instructions are sent after the user message, they are the final instructions that the AI receives before generating a response. The AI usually gives them a higher priority than the main prompt, and they can override the main prompt's instructions.","Post-History Instructions cannot be defined globally. You could achieve the same effect with an Author's Note.","To use per-character Post-History Instructions, add them to the character's Post-History Instructions and enable both Prefer Char. Instructions and Allow Post-History Instructions.","The Post-History Instructions is added as an invisible user role injection that precedes the last line of the prompt (usually containing a response message \"header\").","Post-History Instructions is one of the default prompts in Prompt Manager. It is usually the last message in the context that the model receives, attributed to (\"sent by\") the system role. If your Chat Completion API does not support the system role, it will usually be attributed to the user role instead."]},{"i":"adding-to-the-prompt-world-info","l":"Adding to the Prompt (World Info)","p":["You can insert additional information anywhere in the prompt using the World Info feature. By setting the conditions for when the information should be inserted, you can guide the AI to include specific details, change how it responds, or add new elements to the conversation.","Some common uses of World Info include:","a \"lorebook\" or \"encyclopedia\" with information about the world or setting","a way to manage different system prompts for various characters and situations","a place to store memories that the AI should \"recall\" in the conversation","a more modular system for creating, editing, and sharing character details","a source of random events and surprises for the AI to react to, or to make you react to!"]}],[{"l":"Advanced Formatting","p":["The settings provided in this section allow for more control over the prompt-building strategy, primarily for Text Completion APIs.","Most of the settings in this panel do not apply to Chat Completions APIs as they are governed by the prompt manager system instead.","System Prompt","Context Template","Tokenizer","Custom Stopping Strings","System Prompt: not applicable, use Prompt Manager","Context Template: not applicable, use Prompt Manager"]},{"l":"Backend-defined templates","p":["Not applicable to Chat Completion APIs as they use a different prompt builder.","Some Text Completion sources provide an ability to automatically choose templates recommended by the model author. This works by comparing a hash of the chat template defined in the model's tokenizer_config.json file with one of the default SillyTavern templates.","Derive templates option must be enabled in the Advanced Formatting menu. This can be applied to Context, Instruct, or both.","A supported backend must be chosen as a Text Completion source. Currently only llama.cpp and KoboldCpp support deriving templates.","The model must correctly report its metadata when the connection to the API is established. If this didn't work, try updating the backend to the latest version.","The reported chat template hash must match the one of the known SillyTavern templates. This only covers default templates, such as Llama 3, Gemma 2, Mistral V7, etc.","If the hash matches, the template will be automatically selected if it exists in the templates list (i.e., not renamed or deleted)."]},{"l":"System Prompt","p":["For equivalent settings in Chat Completion APIs, use Prompt Manager. The Main Prompt is the equivalent of the System Prompt in Chat Completion APIs.","The System Prompt defines the general instructions for the model to follow. It sets the tone and context for the conversation. For example, it tells the model to act as an AI assistant, a writing partner, or a fictional character.","The System Prompt is a part of the Story String and usually the first part of the prompt that the model receives.","See the prompting guide to learn more about the System Prompt."]},{"l":"Context Template","p":["For equivalent settings in Chat Completion APIs, use Prompt Manager.","Usually, AI models require you to provide the character data to them in some specific way. SillyTavern includes a list of pre-made conversion rules for different models, but you may customize them however you like.","The options for this section are explained in Context Template."]},{"l":"Tokenizer","p":["A tokenizer is a tool that breaks down a piece of text into smaller units called tokens. These tokens can be individual words or even parts of words, such as prefixes, suffixes, or punctuation. A rule of thumb is that one token generally corresponds to 3~ 4 characters of text.","The options for this section are explained in Tokenizer."]},{"l":"Custom Stopping Strings","p":["Accepts a JSON-serialized array of stopping strings. Example: [\\n, \\nUser:, \\nChar:]. If you're unsure about the formatting, use an online JSON validator. If the model output ends with any of the stop strings, they will be removed from the output.","Supported APIs:","KoboldAI Classic (versions 1.2.2 and higher) or KoboldCpp","AI Horde","Text Completion APIs: Text Generation WebUI (ooba), Tabby, Aphrodite, Mancer, TogetherAI, Ollama, etc.","NovelAI","OpenAI (max 4 strings) and compatible APIs","OpenRouter (both Text and Chat Completion)","Claude","Google AI Studio"]}],[{"l":"Context Template","p":["For equivalent settings in Chat Completion APIs, use Prompt Manager.","Usually, AI models require you to provide the character data to them in some specific way. SillyTavern includes a list of pre-made conversion rules for different models, but you may customize them however you like.","Edit these settings in the \" Advanced Formatting\" panel."]},{"l":"Story string","p":["This field is a template for pre-chat character data (known internally as a story string). This is the main way to format your character card for text completion and instruct models.","The template supports Handlebars syntax and any custom text injections or formatting. See the language reference here: https://handlebarsjs.com/guide/","We provide the following parameters to the Handlebars evaluator (wrap them into double-curly braces):","description- character's Description","scenario- character's Scenario","personality- character's Personality","system- system prompt OR character's main prompt override (if exists and \"Prefer Char. Prompt\" is enabled in User Settings)","persona- selected persona description","char- character's name","user- selected persona name","wiBefore or loreBefore- combined activated World Info entries with Position set to \"Before Char Defs\"","wiAfter or loreAfter- combined activated World Info entries with Position set to \"After Char Defs\"","mesExamples- (optional) character's Example Dialogues, instruct-formatted with separator. Set \"Example Messages Behavior\" to \"Never include examples\" to avoid duplication.","A special {{trim}} macro is supported to remove any newlines that surround it. Use it in case you want some part of text NOT be separated with a newline from the previous line ( spaces are not trimmed).","WARNING: If some of the above parameters are missing from the story string template, they are not going to be sent in the prompt at all."]},{"l":"Example Separator","p":["Used as a block header and a separator between the example dialogue blocks. Any instance of START tags in the example dialogues will be replaced with the contents of this field."]},{"l":"Chat Start","p":["Inserted as a separator after the rendered story string and after the example dialogues blocks, but before the first message in context."]},{"l":"Separators as Stop Strings","p":["Adds \"Example Separator\" and \"Chat Start\" to the list of stop strings.","Helpful if the model tends to hallucinate or leak whole blocks of example dialogue preceded by the separator."]},{"l":"Names as Stop Strings","p":["Adds Character and User Persona names to the list of stop strings.","Recommended to keep it on to prevent model impersonation."]},{"l":"Allow Post-History Instructions","p":["Includes the Post-History Instructions at the end of the prompt, formatted as the last user message.","The Post-History Instructions prompt should be defined in the character card and \"Prefer Char. Instructions\" setting should be enabled.","Should be used with care, as placing instructions low in the context can lead to degraded quality of the outputs of smaller models."]},{"i":"always-add-characters-name-to-prompt","l":"Always add character's name to prompt","p":["Appends the character's name to the prompt to force the model to complete the message as the character:"]}],[{"l":"Instruct Mode","p":["Instruct Mode allows you to adjust the prompting for instruction-following models trained on various prompt formats, such as Alpaca, ChatML, Llama2, etc.","For equivalent settings in Chat Completion APIs, use Prompt Manager."]},{"l":"API support"},{"l":"Text Completion API","p":["Fully supported. This includes:","All of the sources under Text Completion","KoboldAI Classic","AI Horde"]},{"l":"Choosing a formatting","p":["A chosen instruct template must match the expectations of an actual model that is running on a backend.","This is usually reflected in a model card on HuggingFace, and some even provide SillyTavern-compatible JSON files.","Example: NeverSleep/Noromaid-13b-v0.1.1"]},{"i":"chat-completion-api-openai-claude-etc","l":"Chat Completion API (OpenAI, Claude, etc)","p":["This is not supported (and not needed) for Chat Completion APIs. They use an entirely different prompt builder."]},{"l":"NovelAI","p":["While technically supported for NovelAI, none of their models were trained to understand instruct formatting. NovelAI models can use a special instruct module that is activated automatically when an instruction wrapped in curly braces is encountered in chat messages, so using Instruct Mode for the entire prompt will lead to degraded quality of the outputs.","Here's an example that auto-activates the instruct module for NovelAI:"]},{"l":"Instruct Mode Settings"},{"l":"System Prompt","p":["The System Prompt is now a separate entity. See the Advanced Formatting page for more details."]},{"l":"Templates","p":["Provides ready-made templates with sequences for some well-known instruct models.","Changing a template resets the unsaved settings to the last saved state! Don't forget to save your template if you made any changes you don't want to lose."]},{"l":"Activation Regex","p":["If defined as a valid regular expression, when connected to a model and its name matches this regex, will automatically select this template.","Instruct mode needs to be enabled prior. Only the first regex match across templates will be selected (evaluated in alphabetical order)."]},{"l":"Wrap Sequences with Newline","p":["Each sequence text will be wrapped with newline characters when inserted into the prompt. Required for Alpaca and its derivatives.","Disable if you want to have full control over line terminators."]},{"l":"Replace Macro in Sequences","p":["If enabled, known {{macro}} substitutions will be replaced if defined in message wrapping sequences.","Also, a special {{name}} macro can be used in message prefixes to reference the actual name attached to a message (rather than a currently active {{char}} or {{user}}), which can be helpful when using group chats or /sendas command. If the name can't be determined, \"System\" is used as a fallback placeholder."]},{"l":"Include Names","p":["If enabled, prepend characters and user names to chat history logs after the prefix sequence.","The following options are available:","Never: Do not add name prefixes before the message contents.","Groups and Past Personas: Only add name prefixes to messages from group characters and past personas.","Always: Always add name prefixes before the message contents."]},{"i":"sequences-system-prompt-wrapping","l":"Sequences: System Prompt Wrapping","p":["Define how the System Prompt will be wrapped."]},{"l":"System Prompt Prefix","p":["Inserted before a System prompt."]},{"l":"System Prompt Suffix","p":["Inserted after a System prompt.","Important: this applies only to the System Prompt itself, not the entire Story String! If you want to wrap the Story String, add these sequences to the Story String template in the Context Template section."]},{"i":"sequences-chat-messages-wrapping","l":"Sequences: Chat Messages Wrapping","p":["These settings define how messages belonging to different roles will be wrapped upon building a prompt.","All prefix sequences will also be automatically used as stopping strings."]},{"l":"User Message Prefix","p":["Inserted before a User message and as a last prompt line when impersonating."]},{"l":"User Message Suffix","p":["Inserted after a User message."]},{"l":"Assistant Message Prefix","p":["Inserted before an Assistant message and as a last prompt line when generating an AI reply."]},{"l":"Assistant Message Suffix","p":["Inserted after an Assistant message"]},{"l":"System Message Prefix","p":["Inserted before a System (added by slash commands or extensions) message."]},{"l":"System Message Suffix","p":["Inserted after a System message."]},{"l":"System same as User","p":["If checked true, System messages will be using User role message sequences.","Otherwise, System messages use their own sequences (if not empty) or will not do any wrapping at all (if empty)."]},{"l":"Misc. Sequences","p":["Various advanced configurations for finer tuning of the prompt building"]},{"l":"First Assistant Prefix","p":["Inserted before the first Assistant's message.","Only the first message of the chat history counts, not the message that actually goes into the prompt first!"]},{"l":"Last Assistant Prefix","p":["Inserted before the last Assistant's message or as a last prompt line when generating an AI reply.","Not used when generating text in a background (e.g. Stable Diffusion prompts or Summaries). System Instruction Prefix or Regular Assistant Prefix will be used instead."]},{"l":"System Instruction Prefix","p":["Inserted as a last prompt line when generating neutral/system text in a background (e.g. Stable Diffusion prompts or Summaries)."]},{"l":"User Filler Message","p":["Will be inserted at the start of the chat history if it doesn't start with a User message.","Use case: when an instruct format strictly requires prompts to be user-first and have messages with alternating roles only, examples: Llama 2 Chat, Mistral Instruct."]},{"l":"Stop Sequence","p":["Text that denotes the end of the reply. Also sent as a stopping string to the backend API.","If a stop sequence is generated, everything past it will be removed from the output (including the sequence itself)."]}],[{"l":"Tokenizer","p":["A tokenizer is a tool that breaks down a piece of text into smaller units called tokens. These tokens can be individual words or even parts of words, such as prefixes, suffixes, or punctuation. A rule of thumb is that one token generally corresponds to 3~ 4 characters of text.","AI21 API: Jamba tokenizer (requires a one-time download).","API tokenizer. Queries the generation API to get the token count directly from the model. Known backends to support: Text Generation WebUI (ooba), koboldcpp, TabbyAPI, Aphrodite API. Pick if you use a supported backend.","Chat Completion APIs (non-overridable):","Claude: model-dependant tokenizer via WebTokenizers.","Cohere API: Command-R tokenizer (requires a one-time download).","Fallback tokenizer: GPT-3.5 turbo tokenizer.","Gemma tokenizer. Used by Gemini/Gemma models. Pick if you use a Gemma model.","Google AI Studio: Gemma tokenizer.","If you get inaccurate results or wish to experiment, you can set an override tokenizer for SillyTavern to use while forming a request to the AI backend:","KoboldAI Classic / AI Horde: Llama tokenizer.","Koboldcpp: model API tokenizer.","Llama 3 tokenizer. Used by Llama 3/3.1 models. Pick if you use a Llama 3/3.1 model.","Llama tokenizer. Used by Llama 1/2 models family: Vicuna, Hermes, Airoboros, etc. Pick if you use a Llama 1/2 model.","Mistral V1 tokenizer. Used by older Mistral models family and their finetunes. Pick if you use a Mistral model.","MistralAI API: Mistral V1 or V3 tokenizer (requires a one-time download).","NerdStash tokenizer. Used by NovelAI's Clio model. Pick if you use the Clio model.","NerdStash v2 tokenizer. Used by NovelAI's Kayra model. Pick if you use the Kayra model.","None. Each token is estimated to be ~ 3.3 characters, rounded up to the nearest integer. Try this if your prompts get cut off on high context lengths. This approach is used by KoboldAI Lite.","NovelAI Clio: NerdStash tokenizer.","NovelAI Kayra: NerdStash v2 tokenizer.","OpenAI: model-dependant tokenizer via tiktoken.","OpenRouter: Llama, Mistral, Gemma, Yi tokenizers for their respective models.","Scale API: GPT-4 tokenizer.","SillyTavern provides a \"Best match\" option that tries to match the tokenizer using the following rules depending on the API provider used.","Text Completion APIs (overridable):","Text Completion: API tokenizer (if supported) or Llama tokenizer.","Yi tokenizer. Used by Yi models. Pick if you use a Yi model."]},{"l":"Additional Tokenizers","p":["These tokenizers are not included in the default installation due to their size A one-time download is required when they're used for the first time.","Qwen2 tokenizer.","Command-R tokenizer. Used by Cohere source in Chat Completion.","Mistral V3 (Nemo) tokenizer. Used by MistralAI source in Chat Completion (Nemo and Pixtral models).","If you don't want to use internet downloads, the opt-out option exists in config.yaml: enableDownloadableTokenizers. Set to false to disable downloads.","You can also download tokenizers manually from the SillyTavern-Tokenizers repository. Download the JSON files and put them in the _cache subdirectory of your data root, the path is ./data/_cache by default. Create the _cache directory if it doesn't exist. After that, restart the SillyTavern server to re-initialize tokenizers.","If the required tokenizer model is not cached and downloads are disabled, a fallback tokenizer (Llama 3) will be used for counting."]},{"l":"Token Padding","p":["SillyTavern will always use the matching tokenizer for Chat Completion models, so there is no need for token padding.","Unless SillyTavern uses a tokenizer provided by the remote backend API that runs the model, all token counts assumed during prompt generation are estimated based on the selected tokenizer type.","Since the results of tokenization can be inaccurate on context sizes close to the model-defined maximum, some parts of the prompt may be trimmed or dropped, which may negatively affect the coherence of character definitions.","To prevent this, SillyTavern allocates a portion of the context size as padding to avoid adding more chat items than the model can accommodate. If you find that some part of the prompt is trimmed even with the most-matching tokenizer selected, adjust the padding so the description is not truncated.","You can input negative values for reverse padding, which allows allocating more than the set maximum amount of tokens."]}],[{"l":"CFG","p":["Page written by: kingbri","Contributors: kingbri, Guillaume \"Vermeille\" Sanchez, AliCat"]},{"i":"what-is-it","l":"What is it?","p":["CFG, or classifier-free guidance is a method that's used to help make parts of a prompt less or more prominent."]},{"l":"Supported Backend APIs","p":["Currently, the supported backends are oobabooga's textgen WebUI, NovelAI, and TabbyAPI. NovelAI had its own documentation for CFG.","WARNING: CFG increases vram usage due to ingesting more than 1 prompt! If your GPU memory runs out while generating a prompt with CFG on, consider reducing your context size, using a lesser parameter model, or turning off CFG entirely."]},{"l":"Configuration","p":["Accessing CFG settings are the same as accessing Author's note:","CFGhamburgermenupng","And here's what the CFG panel looks like:","CFGchatpanelpng","There are four dropdowns in the CFG panel:","Chat CFG","Scopes the CFG scale and prompts to only this chat","Character CFG","Scopes the CFG scale and prompts to the specified character","Global CFG","Globally overrides the CFG scale and prompts (also overrides the model preset!)","CFG Advanced Settings (formerly called CFG Prompt Cascading)","A place to combine prompts from the previous 3 dropdowns and set insertion depth.","NOTE: If the guidance scale is set to 1, nothing will be sent since that's when CFG is in an \"off\" state."]},{"l":"Group Chats","p":["In group chats, the CFG scale panel looks like this:","CFGpanelgcpng","The main change is that character CFG is removed and a checkbox called Use Character CFG Scales is present in the chat CFG dropdown. This allows for the current character's guidance scale to be used instead of whatever the chat CFG scale is set to.","The main utility of this feature is to alter the scale based on each character's individual needs.","In addition, checking the Character Negatives box in prompt cascading will append the independent character negative prompts along with the chat ones (if enabled)."]},{"l":"Concepts"},{"i":"isnt-this-in-stable-diffusion","l":"Isn't this in Stable Diffusion?","p":["Yes and no. CFG with LLMs works in a different way than what one might be used to in Stable Diffusion. LLM-based CFG works on the principle of \"prompt mixing\". The CFG formula takes a positive and negative prompt, then mixes the differences between them. From there, a combined prompt is sent and a response is generated!","Here's an illustration to help visualize this concept. The red represents the negative prompt, the blue represents the neutral prompt, and the purple represents the mixed result that's interpreted. All the white space is the same across all 3 prompts, so those are not used for CFG mixing.","stcfgdiagrampng","If you want to know more about CFG and LLMs, Vermifuge's original paper is located here. I'd suggest giving it a read/listen:","Paper - [2306.17806] Stay on topic with Classifier-Free Guidance (arxiv.org)","Audio version - https://www.youtube.com/watch?v=MGY00YFcyco"]},{"i":"do-i-need-cfg-prompts","l":"Do I need CFG prompts?","p":["No! CFG prompts are completely optional. Just adjusting the guidance scale above 1 will also help produce an effect on responses, which can accentuate chats and character interaction."]},{"i":"what-makes-a-good-cfg-prompt","l":"What makes a good CFG prompt?","p":["So, we established that CFG prompting is not the same as Stable Diffusion's negative tags and embeddings. How do we make a prompt?","Warning: This assumes that you have created a character using PLists and Ali:Chat. If you have not, feel free to experiment with various prompting techniques.","Let's say I have a character named \"John\". John is supposed to feel happy and excited all the time from his example dialogues. However, when chatting with John, he's sometimes sad and depressed.","To remove this, CFG comes to the rescue! Just make the negative prompt [John's feelings: sad, depressed] to help remove the sadness portions. You can optionally make the positive prompt [John's feelings: happy, joyful] to further bring out John's happy parts."]},{"l":"Positive Prompts","p":["I went over this in the previous section, but I'd like to touch on this a bit more. Positive prompts are used to further accentuate parts of a character. Let's use John again as our example. By making him happier with a positive prompt of [John's feelings: happy, joyful], John should start outputting dialogue with a more happy feeling than if the positive prompt was not included."]},{"i":"but","l":"But...","p":["These are just loose guidelines from experience with one specific character format. There are many other ways to create prompts that you should experiment with. Feel free to share your thoughts with other users!"]},{"l":"Guidance Scale","p":["Here's a rule of thumb. A guidance scale of 1 means that CFG is disabled. In fact, SillyTavern won't send anything to your backend if the guidance scale is 1. A guidance scale 1 will give the results shown in the other sections at varying degrees.","However, a guidance scale of 1 will give the opposite effect since the negative prompt is used as the primary prompt here.","Let's use the example with John again. The negative prompt is [John's feelings: sad, depressed] and the positive prompt is [John's feelings: happy, joyful] with a guidance scale of 0.8.","This will in turn accentuate the negative prompt more and you'll see John start to act sadder than normal rather than happier.","tldr; Use a guidance scale of 1.5 and work up and down from there based on your outputs."]},{"l":"Prompt Cascading","p":["Negatives and positives can be cascaded between CFG types (the types being per-chat, per-character, and global overrides). See the Configuration header for more information."]},{"l":"Insertion Depth","p":["Follow the basic rule: The lower something is located in the prompt, the more influential it is to the response. For chatting, I recommend using the default depth of 1 since it's very flexible with other components of SillyTavern.","However, if you want to experiment, an insertion depth of 0 is open. However, these can dramatically alter how your response will look and it's NOT recommended to use prompt cascading here!"]}],[{"l":"Prompt Manager","p":["The Prompt Manager is a system that allows for more control over the prompt-building strategy for Chat Completion APIs.","For equivalent settings in Text Completion APIs, use Advanced Formatting.","Access Prompt Manager by clicking on the \"AI Response Configuration\" button in the navigation bar. Prompt manager is below the common settings panel."]}],[{"l":"World Info","p":["World Info (also known as Lorebooks or Memory Books) is a powerful tool available in ST to insert prompts dynamically into your chat to help guide the AI replies.","Commonly, World Info (WI for short) is used to enhance the AI's understanding of the details in your fictional world, however you could use a World Info entry to insert ANYTHING that you would like to insert into the prompt.","It functions like a dynamic dictionary that only inserts relevant information from World Info entries when keywords associated with the entries are present in the message text.","The SillyTavern engine activates and seamlessly integrates the appropriate lore into the prompt, providing background information to the AI.","It is important to note that while World Info helps guide the AI toward the desired content, it does not guarantee its appearance in the generated output messages. That depends on how good your model is at making use of additional information!"]},{"l":"Pro Tips","p":["The World Info engine is a very powerful prompt management tool. Don't fixate on adding character lore alone, feel free to experiment.","Activation keywords, titles, and other information that is not in the Content field is not inserted into context, so each World Info entry should have a comprehensive, standalone description.","To create rich and detailed world lore, entries can be interlinked and reference one another by using recursive activation. See more on Recursion below.","SillyTavern offers flexible context budgeting for inserted background information. To conserve prompt tokens, it is advisable to keep entry contents concise."]},{"l":"Further reading","p":["World Info Encyclopedia: Exhaustive in-depth guide to World Info and Lorebooks. By kingbri, Alicat, Trappu."]},{"l":"Character Lore","p":["Optionally, one World Info file could be assigned to a character to serve as a dedicated lore source across all chats with that character (including groups).","To do that, navigate to a Character Management panel and click a globe button, then pick World Info from a dropdown list and click \"Ok\"."]},{"l":"Character Lore Insertion Strategy","p":["When generating an AI reply, entries from the character World Info will be combined with the entries from a global World Info selector using one of the following strategies:"]},{"i":"sorted-evenly-default","l":"Sorted Evenly (default)","p":["All entries will be sorted according to their Insertion Order as if they a part of one big file, ignoring the source."]},{"l":"Character Lore First","p":["Entries from the Character World Info would be included first by their Insertion Order, then entries from the Global World Info."]},{"l":"Global Lore First","p":["Entries from the Global World Info Info would be included first by their Insertion Order, then entries from the Character World Info."]},{"l":"World Info Entry"},{"l":"Key","p":["A list of keywords that trigger the activation of a World Info entry. Keys are not case-sensitive by default (this is configurable)."]},{"i":"regular-expression-regex-as-keys","l":"Regular Expression (Regex) as Keys","p":["Keys allow a more flexible approach to matching by supporting regex. This makes it possible to match more dynamic content with optional words or characters, spacing, and all the other utilities that regex provides. If a defined key is a valid regex (Javascript regex style, with / as delimiters. All flags are allowed), it will be treated as such when checking whether an entry should be triggered. Multiple regexes can be entered as separate keys and will work alongside each other. Inside a regex, commas are possible. Plaintext keys do not support commas, as they are treated as key separators.","An example of a use-case for advanced regex matching: An entry/instruction that should be inserted, when char is doing a weather-related action","For more information on Regex syntax and possibilities: Regular expressions - JavaScript | MDN"]},{"l":"Advanced Regex Per-Message Matching","p":["ST prefixes every chat message in the WI scan buffer with character name: and after v1.12.6, concatenates prepends them using the character value 1 (\\x01). This means you can match specific input or output from a certain character using a regex tied to that separation character.","For example, to match only the user saying \"hello\", you could use the following regex:"]},{"l":"Key Input","p":["There are two modes to enter keywords, each with a slightly different UI. In ⌨️ plaintext mode(default), keys can be entered as a comma-separated list in a single text field. Regexes can be included too, but they don't have any special highlighting. In ✨ fancy mode, the keys appear as separate elements and regexes will be highlighted as such. The control supports editing and deleting keys. The mode can be switched via the inline button inside the input control."]},{"l":"Optional Filter","p":["A list of supplementary keywords that are used in conjunction with the main keywords. See Optional Filter. These keys also support regex."]},{"l":"Entry Content","p":["The text that is inserted into the prompt upon entry activation."]},{"l":"Insertion Order","p":["Numeric value. Defines a priority of the entry if multiple were activated at once. Entries with higher order numbers will be inserted closer to the end of the context as they will have more impact on the output."]},{"l":"Insertion Position","p":["Before Char Defs: World Info entry is inserted before the character's description and scenario. Has a moderate impact on the conversation.","After Char Defs: World Info entry is inserted after the character's description and scenario. Has a greater impact on the conversation.","Before Example Messages: The World Info entry is parsed as an example dialogue block and inserted before the examples provided by the character card.","After Example Messages: The World Info entry is parsed as an example dialogue block and inserted after the examples provided by the character card.","Top of AN: World Info entry is inserted at the top of Author's Note content. Has a variable impact depending on the Author's Note position.","Bottom of AN: World Info entry is inserted at the bottom of Author's Note content. Has a variable impact depending on the Author's Note position.","@ D: World Info entry is inserted at a specific depth in the chat (Depth 0 being the bottom of the prompt).","⚙️ - as a system role message","\uD83D\uDC64 - as a user role message","\uD83E\uDD16 - as an assistant role message","Example Message entries will be formatted according to the prompt-building settings: Instruct Mode or Chat Completion prompt manager. They also follow the Example Messages Behavior rules: being gradually pushed out on full context, always kept, or disabled altogether.","If your Author's Note is disabled (Insertion Frequency = 0), World Info entries in A/N positions will be ignored!"]},{"i":"entry-title--memo","l":"Entry Title / Memo","p":["A text field for your convenience to label your entries, which is not utilized by the AI or any of the trigger logics.","If empty, can be backfilled using the entries' first key by clicking on the \"Fill empty memos\" button."]},{"l":"Strategy","p":["\uD83D\uDD35 (Blue Circle) = The entry would always be present in the prompt.","\uD83D\uDFE2 (Green Circle) = The entry will be triggered only in the presence of the keyword.","\uD83D\uDD17 (Chain Link) = The entry is allowed to be inserted by embedding similarity.","Each Entry also has a toggle that allows you to enable or disable the entry."]},{"i":"optional-filter-1","l":"Optional Filter","p":["Comma-separated list of additional keywords in conjunction with the primary key. If no arguments are provided, this flag is ignored. Supports logic for AND ANY, NOT ANY, or NOT ALL","AND ANY = Activates the entry only if the primary key and Any one of the optional filter keys are in scanned context.","AND ALL = Activates the entry only if the primary key and ALL of the optional filter keys are present.","NOT ANY = Activates the entry only if the primary key and None of the optional filter keys are in scanned context.","NOT ALL = Prevents activation of the entry despite primary key trigger, if all of the optional filters are in scanned context."]},{"i":"probability-trigger-","l":"Probability (Trigger %)","p":["This value acts like an additional filter that adds a chance for the entry NOT to be inserted when it is activated by any means (constant, primary key, recursion).","Probability = 100 means that the entry will be inserted on every activation.","Probability = 50 means that the entry will be inserted with a 1:1 chance.","Probability = 0 means that the entry will NOT be inserted (essentially disabling it).","Use this to create random events in your chats. For example, every message could have a 1% chance of waking up an Elder God if its name is mentioned in the message."]},{"l":"Inclusion Group","p":["Inclusion groups control how entries are selected when multiple entries with the same group label are triggered simultaneously. If multiple entries having the same group label were activated, only one will be inserted into the prompt.","By default, the chosen entry is selected randomly based on their Group Weight (default is 100 points) — the higher the number, the higher the probability of selection. This allows for a random selection among the triggered entries, adding an element of surprise and variety to interactions.","A single entry can be part of multiple inclusion groups if they are defined as a comma-separated list. The same logic as explained above will apply. If that entry is triggered, it will disable all other entries that are part of any of its groups. Therefore, if any of the groups are activated, this entry will not be activated."]},{"l":"Prioritize Inclusion","p":["To provide more control over which entries are activated via Inclusion Group, you can use the 'Prioritize Inclusion' setting. This option allows you to specify deterministically which entry to choose instead of randomly rolling Group Weight chances.","If multiple entries having the same group label and this setting turned on were activated, the one with the highest 'Order' value will be selected. This is useful for creating fallback sequences via inclusion groups. For example to prioritize low-depth entries with more emphasis, or to choose a specific instruction on setting the scene over another if both are valid."]},{"l":"Use Group Scoring","p":["When this setting is enabled globally or per entry, the number of activated entry keys determines the group winner selection. Only the subset of a group with the highest number of key matches will be left to be activated by Group Weight or Inclusion Priority - the rest will be deactivated and removed from the group.","Use this to give more specificity for individual entries in large groups. For example, they can have a common key and a specific key. A random entry will be inserted when a specific key is not provided, and vice versa.","The score calculation logic for primary keys is 1 match = 1 point.","For secondary keys, the interaction depends on the chosen Selective Logic:","AND ANY: 1 secondary match = 1 point.","AND ALL: 1 point for every secondary key if they all match.","NOT ANY and NOT ALL: no change.","Example:","Entry 1. Keys: song, sing, Black Cat. Group: songs","Entry 2. Keys: song, sing, Ghosts. Group: songs","The input sing me a song can activate either entry (both activated 2 keys), but sing me a song about Ghosts will activate only Entry 2 (activated 3 keys)."]},{"l":"Automation ID","p":["Allows to integrate World Info entries with STscripts from Quick Replies extension. If both the quick reply command and the WI entry have the same Automation ID, the command will be executed automatically when the entry with a matching ID is activated.","Automations are executed in the order they are triggered, adhering to your designated sorting strategy, combining the Character Lore Insertion Strategy with the 'Priority' sorting. Which leads to Blue Circle entries processed first, followed by others in their specified 'Order'. Recursively triggered entries will be processed after in the same order.","The script command will run only once if multiple entries with the same Automation ID are activated."]},{"l":"Vector Storage Matching","p":["The Vector Storage extension provides an alternative to keyword matching by using the similarity between the recent chat messages and World Info entry contents.","To enable and use this, the following prerequisites need to be met:","Vector Storage extension is enabled and is configured to use one of the available embedding sources.","The \"Enable for World Info\" checkbox is ticked in the Vector Storage extension settings.","Either the World Info entries that are allowed for keyless matching have the \"Vectorized\" (\uD83D\uDD17) status or the \"Enabled for all entries\" option is checked in the Vector Storage settings.","The choice of the vectorization model in the extension and the theoretical meaning behind the term \"embeddings\" won't be covered here. Check out the Data Bank guide if you require more info on this topic.","Vector Storage matching adheres to this set of rules:","The maximum number of entries that are allowed to be matched with the Vector Storage can be adjusted with the \"Max Entries\" setting. This number only sets the limit and does not influence the token budget set in the activation settings for World Info. All of the budgeting rules still apply.","This feature only replaces the check for keywords. All additional checks must be met for the entry to be inserted: trigger%, character filters, inclusion groups, etc.","The \"Scan Depth\" setting from Activation Settings or entry overrides is not used. The Vector Storage \"Query messages\" value is utilized instead to get the text to match against. This allows for a configuration like \"Scan Depth\" set to 0, so no regular keyword matches will be made, but entries still can be activated by vectors.","A \"Vectorized\" status is only an additional marker. The entry would still behave like a normal, enabled, non-constant record that will be activated by keywords if they are set. Remove the keywords if you want them to be activated only by vectors.","Since the retrieval quality depends entirely on the outputs of the embedding model, it's impossible to predict exactly what entries will be inserted. If you want deterministic and predictable results, stick to keyword matching."]},{"l":"Timed Effects","p":["Usually, World Info evaluation is stateless, meaning that the result of the evaluation is the same, only depending on the current chat context. However, with the introduction of Timed Effects, you can create entries that have an activation delay, stay active after being triggered, or can't be triggered after the activation."]},{"l":"Timed Effects Rules","p":["The time frames for the effects are measured in messages (not pairs of messages/exchanges), with 0 meaning there is no effect.","Effects only apply in the chat where the entry was activated. Branches inherit the state of the parent chat.","Active timed effects are removed if the chat doesn't advance, e.g. if the last message was swiped or deleted.","Making any changes to the entry that is currently on timed effect will cause the effect to be forcibly removed.","Consequent triggering of keywords does not refresh the effect duration if it's already active."]},{"l":"Types of Timed Effects","p":["Sticky - the entry stays active for N messages after being activated. Stickied entries ignore probability checks on consequent scans until they expire.","Cooldown - the entry can't be activated for N messages after being activated. Can be used together with sticky: the entry goes on cooldown when the sticky duration ends.","Delay - the entry can't be activated unless there are at least N messages in the chat at the moment of evaluation.","Delay = 0 -> The entry can be activated at any time.","Delay = 1 -> The entry can't be activated if the chat is empty (no greeting).","Delay = 2 -> The entry can't be activated if there is zero or only one message in the chat, etc."]},{"l":"Timed Effects Example","p":["Entry configuration: sticky = 3, cooldown = 2, delay = 2."]},{"l":"Activation Settings","p":["Collapsible menu at the top of the World Info screen."]},{"l":"Scan Depth","p":["Can be overridden on an entry level.","Defines how many messages in the chat history should be scanned for World Info keys.","If set to 0, then only recursed entries and Author's Note are evaluated.","If set to 1, then SillyTavern only scans the last message.","2 = two last messages, etc."]},{"l":"Include Names","p":["Defines if the names of the chat participants should be included in the scanned text buffer as message prefixes. This allows activating entries that use names as keywords without directly mentioning the names in messages.","See an example of the text to be scanned below, assuming the chat participants are named Alice and Bob.","Enabled (default):","Disabled:"]},{"i":"context---budget","l":"Context % / Budget","p":["Defines how many tokens could be used by World Info entries at once. You can define a threshold relative to your API's max-context settings (Context %) or an objective token threshold (Budget)","If the budget is exhausted, then no more entries are activated even if the keys are present in the prompt.","Constant entries will be inserted first. Then entries with higher order numbers.","Entries inserted by directly mentioning their keys have higher priority than those that were mentioned in other entries' contents."]},{"l":"Min Activations","p":["This setting is mutually exclusive with Max Recursion Steps.","Minimum Activations: If set to a non-zero value, this will disregard the limitation of \"scan-depth\", seeking all of the chat log backward from the latest message for keywords until as many entries as specified in min activations have been triggered. This will still be limited by the Max Depth setting or your overall Budget cap.","Additional scan sweeps triggered by Min Activations will not check entries added by recursion on previous steps. Only chat messages and extension prompts can trigger these additional activations. However, the entries activated by Min Activations can trigger other entries as usual."]},{"l":"Max Depth","p":["Maximum Depth to scan for when using the Min Activations setting."]},{"l":"Recursive scanning","p":["Recursive scanning allows for entries to activate other entries or be activated by others, enabling complex interactions and dependencies between different World Info entries. This feature can significantly enhance the dynamic nature of your creative scenarios. Whether recursive scanning is enabled can be controlled with the global setting Recursive Scan. There are three options available to control recursion for each entry:","Non-recursable: When this checkbox is selected, the entry will not be activated by other entries. This is useful for static information that should not change or be influenced by other world info entries.","Prevent further recursion: Selecting this option ensures that once this entry is activated, it will not trigger any other entries. This is helpful to avoid unintended chains of activations.","Delay until recursion: This entry will only be activated during recursive checks, meaning it won't be triggered in the initial pass but can be activated by other entries that have recursion enabled. Now, with the added Recursion Level for those delays, entries are grouped by levels. Initially, only the first level (smallest number) will match. Once no matches are found, the next level becomes eligible for matching, repeating the process until all levels are checked. This allows for more control over how and when deeper layers of information are revealed during recursion, especially in combination with criteria as NOT ANY or NOT ALL combination of key matches.","Entries can activate other entries by mentioning their keywords in the content text.","For example, if your World Info contains two entries:","Both of them will be pulled into the context if the message text mentions just Bessie."]},{"l":"Max Recursion Steps","p":["This setting is mutually exclusive with Min Activations.","When set to zero, recursion nesting is only limited by your prompt budget. When set to a non-zero value, limits the total number of scan sweeps to desired maximum \"nesting level\".","Example values:","1 effectively disables recursion as the check stops after the first step.","2 can only activate recursive entries once.","3 can trigger recursion twice..."]},{"l":"Case-sensitive keys","p":["Can be overridden on an entry level.","To get pulled into the context, entry keys need to match the case as they are defined in the World Info entry.","This is useful when your keys are common words or parts of common words.","For example, when this setting is active, keys 'rose' and 'Rose' will be treated differently, depending on the inputs."]},{"l":"Match whole words","p":["Can be overridden on an entry level.","Entries with keys containing only one word will be matched only if the entire word is present in the search text. Enabled by default.","For example, if the setting is enabled and the entry key is \"king\", then text such as \"long live the king\" would be matched, but \"it's not to my liking\" wouldn't.","Important: this setting can have a detrimental effect when used with languages that don't use whitespace to separate words (e.g. Japanese or Chinese). If you write entries in these languages, it is advised to keep it off."]},{"l":"Alert on overflow","p":["Shows an alert if the activated World Info exceeds the allocated token budget."]}],[{"l":"User Settings","p":["UI Customization","Change the theme, look and feel of the chat interface to suit your preferences.","Visual Novel mode","Chat to characters with sprites, like in visual novels such as Doki Doki Literature Club and other famous VN games."]},{"l":"General Settings","p":["These are the core settings that affect your overall SillyTavern experience."]},{"l":"UI Language","p":["SillyTavern's user interface is available in multiple languages. The language selector provides these options:","Default: Uses your system language if available","English: Forces English UI regardless of system settings","Other languages available through the dropdown","Note: This setting only affects the user interface text. For AI conversation translation, please use the Chat Translation extension."]},{"l":"Software Version","p":["Your current version of SillyTavern is displayed in the top-right corner. This information is essential for:","Troubleshooting problems","Ensuring compatibility with extensions","Determining if updates are available","To update SillyTavern to the latest version, please refer to the Updating documentation."]},{"l":"Account Management","p":["Control your SillyTavern user account, back up your settings and user data, and manage user roles and permissions in multi-user mode."]},{"l":"Account","p":["Account Actions","Account creation date","Account handle","Change Password: Update your account security credentials","Critical account operations that should be used with caution:","Danger Zone","Display name (editable via pencil icon)","Download Backup: Export a complete backup of all your user data","In the Account dialog, you can view and edit your profile information, change your password, and manage account settings.","Password status (locked/unlocked icon indicates protection)","Profile Information","Reset Everything: Complete account wipe and factory reset","Reset Settings: Restore all settings to factory defaults","Settings Snapshots: Create, manage, and restore backups of your user settings","User avatar (can also be changed using Personas)","User role"]},{"l":"Admin Panel","p":["Multi-account features require enableUserAccounts to be set to true in config.yaml.","Select Manage Users to view and manage existing user accounts."]},{"l":"User Profile","p":["Custom avatar management (upload/remove)","Display name and handle","Role and status information","Account creation date","Password protection status"]},{"l":"Account Controls","p":["Edit display name","Enable account","Disable account","Promote to admin","Demote to regular user"]},{"l":"Management Actions","p":["Download user data backup","Change user password","Delete account"]},{"l":"New User","p":["Select New User to create a new user account.","Display Name*(e.g., \"John Snow\")","User Handle*(lowercase letters, numbers, and dashes only)","Password (optional)","Password Confirmation","Creating a new user automatically generates a subfolder in the /data/ directory using the user's handle as the folder name."]},{"l":"Logout","p":["Sign out of your current session."]},{"l":"Settings Search","p":["A convenient search bar that helps you quickly find specific settings:","Type any keyword to filter and highlight settings anywhere in User Settings","Searches through setting names and descriptions","Helps navigate complex settings more efficiently"]},{"l":"UI Theme","p":["Change the appearance of the chat interface to suit your preferences.","For more information on the settings in this section of User Settings, see UI Customization."]},{"l":"Character Handling","p":["Char List Subheader: Choose what additional information to display under character names in the Characters list:","Character Version","Created by","Import Card Tags: Controls how tags are handled when importing character cards:","Ask - Show dialog for each import","None - Don't import any tags","All - Import all tags","Existing - Only import tags that already exist","Advanced Character Search: When enabled, uses fuzzy matching and searches all character data fields, not just names.","Prefer Char. Prompt: If enabled, uses the character card's System Prompt override when available.","Prefer Char. Instructions: If enabled, uses the character card's Post-History Instructions override when available.","Never resize avatars: Prevents cropping/resizing of imported character images. When disabled, images are resized to 512x768.","Show avatar filenames: Displays actual filenames of character avatars in the character list.","Spoiler Free Mode: Hides character definitions behind a spoiler button in the editor panel."]},{"l":"Miscellaneous","p":["Reload Chat: Reloads and redraws the current chat.","Debug Menu: Access debugging options.","Smooth Streaming: Experimental feature for smoother text generation. Includes speed control slider.","Message Sound: Plays a sound when message generation completes.","Background Sound Only: Only plays sounds when browser tab is unfocused.","Relaxed API URLs: Reduces formatting requirements for API URLs.","Lorebook Import Dialog: Shows import dialog for World Info/Lorebook when importing characters with embedded lore.","Auto-select Input Text: Automatically selects text in certain input fields when clicked.","Markdown Hotkeys: Enables keyboard shortcuts for markdown formatting.","Restore User Input: Preserves unsaved user input when page is refreshed.","MovingUI: Allows repositioning UI elements by dragging (PC only).","Reset button to restore default positions","Preset system for saving/loading UI layouts"]},{"i":"chatmessage-handling","l":"Chat/Message Handling"},{"l":"Message Display Settings","p":["Controls how messages are loaded and displayed in the chat interface. These settings affect the overall chat experience and performance.","# Messages to Load: Number of chat history messages to load before pagination (0 = All)","Streaming FPS: Update speed of streamed text (5-100 FPS)","Example Messages Behavior:","Gradual push-out","Always include examples","Never include examples"]},{"i":"input--response-controls","l":"Input & Response Controls","p":["Settings that determine how messages are sent and how the AI continues its responses.","Enter to Send: Choose between Disabled, Automatic (PC), or Enabled","\"Send\" to Continue: Use Send button to continue AI responses","Quick \"Continue\" button: Show button to extend AI's last message","Quick \"Impersonate\" button: Show button for single-message character impersonation","Swipes: Show arrow buttons for alternative AI responses (PC and mobile)","Gestures: Enable swipe gestures for generation (Mobile only)"]},{"l":"Auto-Management","p":["Automated features that help manage chat flow and content.","Auto-load Last Chat: Automatically load the most recent chat on startup","Auto-scroll Chat: Automatically scroll to newest messages","Auto-save Message Edits: Save message edits without confirmation","Confirm message deletion: Prompt before deleting messages","Auto-fix Markdown: Automatically correct markdown formatting"]},{"l":"Auto-swipe","p":["Automatically reject and regenerate AI messages based on configurable criteria.","Enable Auto-swipe: Master toggle for the auto-swipe function","Minimum generated message length: Triggers an auto-swipe if the message is shorter than this value","Blacklisted words: List of words that can trigger auto-swipe, separated by commas","Blacklisted word count to swipe: Minimum number of blacklisted words that must be detected to trigger an auto-swipe"]},{"l":"Auto-Continue","p":["Automatically continues a response if the model stopped before reaching a certain length.","This lets your AI write a long response in multiple parts, so that you can have a short response length setting while still getting long replies.","It will not make the AI write more than it would have otherwise. Asking the AI to continue a message that it considers \"finished\" does not usually work. See How to make the AI write more? for other ideas.","Enable Auto-continue: Master toggle for automatic continuation","Allow for Chat Completion APIs: Enables auto-continue functionality for Chat Completion API endpoints","Target length (tokens): The desired message length in tokens - will trigger continue if message is shorter than this value (0-1024)"]},{"i":"message-formatting--display","l":"Message Formatting & Display","p":["Controls how messages are formatted and what content is displayed.","Forbid External Media: Block embedded media from external domains","Show {{char}}: in responses: Retain character name prefix in responses if generated","Show {{user}}: in responses: Retain user name prefix in responses if generated","Show tags in responses: Allow (some) HTML tags in responses to be displayed as HTML","Relax message trim in Groups: Allow AI to speak for other characters in group chats, rather than stopping the response generation","Show group chat queue: Display response order in the character list for group chats"]},{"l":"Prompt Inspection and Debugging","p":["Log prompts to console: Output prompts to browser console","Request token probabilities: Request token probabilities for AI responses from the API. Where available, these can be viewed in Token Probabilities."]},{"l":"AutoComplete","p":["Auto-hide details","Matching style (Starts with/Includes/Fuzzy)","Visual style (Theme/Dark/Light)","Keyboard selection options","Font scaling","Width controls"]},{"l":"STscript Settings","p":["Configuration options for the STscript parser."]},{"l":"STRICT_ESCAPING","p":["Pipes don't need to be escaped in quoted values.","A backslash in front of a symbol can be escaped to provide the literal backslash followed by the functional symbol.","See Strict Escaping for more information."]},{"l":"REPLACE_GETVAR","p":["Helps to avoid double-substitutions when the variable values contain text that could be interpreted as macros.","See Replace Variable Macros for more information."]},{"l":"Debug menu","p":["Do not use them unless you fully understand their consequences.","The Debug Menu provides functionality for troubleshooting, maintenance, and development purposes. These functions should be used with caution as they can significantly impact your SillyTavern installation.","Because extensions can add debug functions, the available options will vary depending on the extensions you have installed."]},{"i":"translation--locale-functions","l":"Translation & Locale Functions","p":["Get missing translations: Analyzes the current locale (or all locales if English is selected) for missing translations and outputs results to browser console","Apply locale: Forces a refresh of the current language settings by reapplying the selected locale"]},{"i":"cache--storage-management","l":"Cache & Storage Management","p":["Clear WebSearch cache: Removes all stored search results from local cache","Purge all vector indices: Completely removes all stored vectors across all sources","Reset token cache: Clears stored token counts, forcing complete re-tokenization of all chats","Delete itemized prompts: Removes all itemized prompts from local storage"]},{"i":"data--statistics","l":"Data & Statistics","p":["Refresh Stat File: Rebuilds the statistics file using existing chat data","Backfill token counters: Recalculates token counts for all messages in current chat","Useful when switching between models with different tokenizers","Triggers chat reload after completion","Visual changes only, does not modify chat content"]},{"i":"api--extension-testing","l":"API & Extension Testing","p":["Change Mancer base URL: Modify the base URL for Mancer API server","Test WebSearch extension: Performs a test search using current settings","Send a generation request: Tests text generation using the currently selected API"]},{"i":"system--debug-tools","l":"System & Debug Tools","p":["Force onboarding: Restarts the onboarding process","Toggle event tracing: Enables/disables event tracking for debugging","Copy ST setup: [Work in Progress] Copies system configuration data to clipboard for bug reports","Each function can be executed using the \"Execute\" button beneath its description. Consider backing up your data before using these tools, as some operations cannot be undone."]}],[{"l":"UI Customization"},{"l":"UI Theme"},{"l":"Theme Management","p":["Theme files allow you to save, share, and reuse your UI customizations. You can maintain multiple themes for different moods or purposes, and switch between them instantly.","Import/Export theme files","Delete existing themes","Save changes to current theme","Save as new theme","All the settings in this section are saved to the current theme. If you switch themes, the settings will be replaced by the settings of the new theme."]},{"l":"Display Settings","p":["These display options affect how characters and messages are presented in the chat interface."]},{"l":"Avatar Style","p":["Choose between Circle, Square, or Rectangle."]},{"l":"Chat Style","p":["Style","Description","Slash command","Flat","Clean and continuous \"chat log\" style, a flat canvas for your AI interactions to come to life.","/flat/default","Bubbles","\"Instant messenger\" style with distinct bubbles for each message, delightful rounded corners, and a subtle 3D effect.","/bubble/bubbles","Document","Compact, document-like appearance with click-to-edit mode and a text-focused layout. Hides avatars, timestamps, and message control buttons for past messages.","/single/story"]},{"l":"Theme Colors","p":["Customize the color scheme of every UI element to create your perfect theme. Colors can be selected using a color picker, and include transparency options where applicable.","Main Text","Italics Text","Underlined Text","Quote Text","Text Shadow","Chat Background","UI Background","UI Border","User Message","AI Message"]},{"i":"layout--visual-settings","l":"Layout & Visual Settings","p":["Fine-tune the visual presentation of the interface with these sliders.","Chat Width: Adjust chat window width (25-100% of screen)","Font Scale: Customize text size (0.5-1.5x)","Blur Strength: Control UI panel blur (0-30)","Shadow Width: Adjust text shadow intensity (0-5)"]},{"l":"Theme Toggles","p":["Avatar Hover Magnification: Zoom effect on avatar hover","Characters Hotswap: Quick-select buttons for favorite characters","Chat Timestamps: Display message timestamps","Compact Input Area: Single-row input (Mobile only)","Expand Message Actions: Always show full message context menu","Hide Chat Avatars: Remove avatars from chat","Mad Lab Mode: Unrestricted parameter ranges","Message IDs: Display sequential message numbers","Message Timer: Show AI response generation time","Message Token Count: Show token counts per message","Model Icons: Show AI model icons for messages","No Blur Effect: Remove background blur for better performance","No Text Shadows: Disable text shadow effects","Reduced Motion: Disable animations and transitions","Swipe # for All Messages: Show swipe numbers on all messages (Mobile)","Tags as Folders: Organize characters using tags as folders","These switches control various UI features and behaviors. Some options can improve performance on lower-end devices, while others add useful information or functionality to the chat interface.","Visual Novel mode: Compact chat with background sprite","Zen Sliders: Simplified parameter controls"]},{"l":"Custom CSS","p":["Allows you to apply custom CSS styles to further customize the appearance of the chat interface.","Use Expand to expand the editor window for better visibility and editing.","If you switch themes, your custom CSS will be replaced by the custom CSS of the new theme. Ensure you save your custom CSS to a theme if you want to keep it when switching themes.","If you use a lot of custom CSS, or want to use the same custom CSS with several themes, the unofficial CSS Snippets extension can help you manage and organize your custom CSS."]},{"l":"Message Sound","p":["To play your own custom sound on receiving a new message from bot, replace the following MP3 file in your SillyTavern folder:","public/sounds/message.mp3","Plays at 80% volume.","If the \" Background Sound Only\" option is enabled, the sound plays only if SillyTavern window is unfocused."]},{"l":"Formulas Rendering","p":["To enable math formulas rendering, use the LaTeX extension. To get the extension, you need to install it via the \"Download Extensions & Assets\" menu in SillyTavern.","Type your formulas in code blocks with latex or asciimath language identifiers for LaTeX and AsciiMath respectively. The extension uses KaTeX for rendering.","The legacy $ and $$ wrapper syntax is no longer supported. Please use the following regex scripts to polyfill the old syntax:","$$ - LaTeX","$ - AsciiMath"]}],[{"i":"visual-novel-vn-mode","l":"Visual Novel (VN) Mode","p":["Visual Novel Mode is a special screen layout in SillyTavern that allows you to chat to characters with sprites (or their character card image) that resembles that of a visual novel like Doki Doki Literature Club, The Fruits of Grisaia, Fate: Stay/night and other famous VN games."]},{"l":"Toggling Visual Novel Mode"},{"l":"Enabling Visual Novel Mode","p":["Visual Novel Mode comes built in with SillyTavern and can be toggle by going to User Settings(User Settings Icon) and checking Visual Novel Mode below No Text Shadows.","User Settings"]},{"l":"Disabling Visual Novel Mode","p":["Disabling Visual Novel Mode is the same steps as enabling it. Untoggle Visual Novel Mode and you should be back to the normal chat screen itself.","Some extensions (like the Prome VN Extension) will toggle 'Visual Novel Mode' on if you use their own respective VN modes. Enabling/Disabling VN Mode from the User Settings menu will also affect these extensions as well."]},{"l":"The Visual Novel UI","p":["VN Display","In Visual Novel Mode, the UI is altered slightly in order to accommodate character sprites (or the character card image) which is shown in the center. In a group chat with multiple characters however, the character sprites will spread themselves out, accommodating for each other as shown below.","Group VN Display"]},{"l":"VN Mode with MovingUI","p":["To toggle MovingUI, go to User Settings and check on MovingUI. Do note that this feature only works on Desktops.","If MovingUI is enabled in User Settings, the sprites (or character card image) can be moved around if you wish to move them around or place them in a more specific area on the screen.","If the size of your character sprites are relatively big it will be a challenge to try and move certain sprites around with MovingUI as the button to drag sprites around might be covered underneath a existing sprite. You will probably have to move them around a bit more than normal, especially if there is more characters on the screen for better placement.","Group VN Display (MovingUI)"]},{"l":"Obtaining Character Sprites","p":["Obtaining character sprites can be done by browsing the internet for existing sprites, for say, a existing character from a Visual Novel or a game that uses a Visual Novel feature such as DDLC or CounterSide. If the character you desire sprites form does not come with sprites already, you have several options remaining.","Search the character post for any sprite ZIP package or link to a sprite pack.","Some bot creators may release their bots with a sprite pack (either within the same post or in a sprites channel). Search those posts if someone hasn't made sprites of the character you want already.","Create your own using LoRAs and Stable Diffusion.","Generating sprites from scratch is time-consuming (especially if no LoRAs exist for your character and/or for the Stable Diffusion model you want to use) and will require decent hardware in order to generate them, more so if you plan on making 28 sprite expression than 6 and if you are using SDXL and/or upscaling sprites to a more higher resolution.","Use the character card image. It might not be like a sprite, but at least you have something to look at on-screen. However, multiple character cards cannot be used in VN mode.","With the Prome Visual Novel Extension 1.0.6+, there is a feature called Emulate Character Card as Sprite that allows you to have a group chat with both sprite and non-sprite characters by using their character card as a sprite in chat.","Character Card Group Chat"]},{"l":"VN Extensions"},{"l":"Prome Visual Novel Extension","p":["The Prome Visual Novel Extension is an endorsed third-party extension from Bronya Rand and Prometheus that enhances the visual novel experience in SillyTavern even further with features such as Letterbox Mode which makes the visual novel UI more \"cinematic\", Focus Mode with Darken Character Sprites, Traditional VN Mode where only the last message in chat appears in chat and more planned to come!","Letterbox Mode","Traditional VN Mode","Horizontal Letterbox Mode","Hide Sheld (Message Box)","Focus Mode (w/ Darken Sprites)","Sheld Hide","Focus Mode w/ Darken Sprites","To install the Prome Visual Novel Extension, you can either install by going to Download Extensions Assets and finding Prome Visual Novel Extension, or follow the installation instructions on the Prome Visual Novel Extension Github page. Adjusting Prome's settings can be found either in Extensions-> Prome (Visual Novel Extension) or via the \uD83E\uDE84 (Wand) menu."]}],[{"l":"Personas"},{"i":"what-is-a-persona","l":"What is a persona?","p":["A persona in SillyTavern represents a combination of a user name and a picture that create a unique identity for the character you play in your chats or identify yourself as.","Creating user personas is optional, but it is a good way to automate routine actions."]},{"i":"how-to-create-a-persona","l":"How to create a persona?","p":["To create a persona:","Open the Persona Management panel (smiley face icon) in the top bar.","Select an existing avatar, or create a blank persona with a dummy image (\"Create\" button).","Find the persona in the list and pick the leftmost context action button (\"Bind a name to that avatar\").","Input a desired name into the popup window. Confirm by clicking an \"OK\" button.","The avatar now represents a Persona. Click on the avatar to select it, and this will also automatically update the user name."]},{"l":"Persona Description","p":["The contents of this field represent any specific information that you want to bind to the selected persona. It could be any kind of description of your user character: mental and physical traits, age, occupation, etc. Here you can also use replacement macros like {{user}}, {{char}}, and other supported parameters.","If defined, the Persona Description will be inserted into the AI prompt in one of the chosen places:","In Prompt Manager (Chat Completion API) or Story String (other APIs). This is the default position.","Top of an Author's Note (if Author's Note is not disabled).","Bottom of an Author's Note (if Author's Note is not disabled).","However, keep in mind that picking a persona when you have set user description on an unbound avatar will not keep your changes.","To permanently save the user description, bind the currently selected avatar to a user name."]},{"l":"Persona locking","p":["One chosen persona could be locked to the currently open individual or group chats. If the currently selected persona differs from the locked one, it will be automatically selected when you open that chat."]},{"l":"To lock a persona","p":["Open a chat (either group or individual).","Select a desired persona by clicking on its avatar.","Click the lock icon in the buttons row next to a name input.","To revert this action, click the unlock icon. Then persona won't be changed automatically when the chat is reopened.","Alternatively, you could use /lock and /unlock slash commands to achieve the same result."]},{"l":"Default persona","p":["You can select one persona as your preferred default identity, automatically selecting it for all new chats and chats where a persona is not locked. The default persona is represented by a yellow outline on the Persona Management panel.","To set persona as a default, click the \"crown\" button in the persona block, then confirm your action.","To undo this action and unset the default persona, click the \"crown\" button again."]},{"l":"Pro Tips","p":["Switching user personas in chat does not automatically change the attribution of previously sent user messages. That way it is possible to use multiple user characters at once.","You can attribute all user-sent messages in the currently open chat to a currently selected persona by clicking the \"sync\" button on the Persona Management panel or by using the /sync slash command.","To change the persona image without deleting it, hover over the avatar on the Persona Management panel and click the bottom-left button. Then choose a new image and it will be replaced, preserving your set description and chat lock states.","To quickly change a persona while in chat without opening the Persona Management panel, use the /persona slash command. For example, /persona Blaze.","You can do backups of your Personas and restore them using the previously saved file if needed. Look for the \"Backup\" and \"Restore\" buttons in the Persona Management panel."]}],[{"l":"Characters","p":["Characters are the AI identities that you can create and manage to shape the AI's role in the conversation. Each character has a name, personality, and conversation history. You can create as many characters as you like, and switch between them at any time.","Characters can be used in solo chats, or add multiple characters to a group chat to let them interact with each other."]},{"l":"Character Management Panel","p":["Open the Characters panel from the navbar to access the character list. Click on a character or group to chat with them or edit them, or choose Create New Character to add a new character."]},{"l":"Panel Controls","p":["Pin Panel: Keep panel open while interacting","Character List: Return to character list view","HotSwap Bar: Quick access to favorite characters"]},{"l":"Character List","p":["Create New Character: Add a new character","Import Character: Load character from file","External Import: Import from URL","Create Group: Start a new group chat"]},{"l":"Search and sort","p":["Search Bar: Filter characters by name or attributes","Sort Dropdown: Multiple sorting options:","Alphabetical (A-Z, Z-A)","Chronological (Newest, Oldest)","Usage-based (Recent, Most/Least chats)","Size-based (Most/Least tokens)","Special (Favorites, Random)"]},{"l":"Filter characters by type or tag","p":["Favorites Filter: Show favorite characters","Groups Filter: Show only group chats","Tags as Folders: Organize by tag hierarchy","Manage Tags: Tag configuration","Tag List: View all available tags","Clear Filters: Reset all filters"]},{"i":"character-creationedit-panel","l":"Character Creation/Edit Panel","p":["Avatar Image: Upload and preview character profile picture","Token Count: Token usage for the character","Stats: Chat history and usage statistics","Tag management"]},{"l":"Quick Actions","p":["Favorite toggle","Advanced definitions","Character lore","Chat lore: link the chat to a World Info","Export character","Duplicate","Delete"]},{"l":"Extended Options","p":["World Info linking","Card lore import","Scenario override","Persona conversion","Character rename","Source linking","Replace/Update","Tag import","Gallery view"]},{"l":"Content Fields","p":["Character Description: Brief character summary","First Message: Initial greeting or prompt when starting a new chat","Alternative greetings: Define multiple first messages that you can swipe between when starting a chat"]},{"l":"Advanced Definitions Panel","p":["Click on the Advanced Definitions button to access the extended character settings."]},{"i":"prompt-overrides-chat-completioninstruct-mode","l":"Prompt Overrides (Chat Completion/Instruct Mode)","p":["Main Prompt: Replaces default main/system prompt, can use{{original}} placeholder to include the original prompt","Post-History Instructions: Overrides default post-history instructions"]},{"i":"creators-metadata","l":"Creator's Metadata","p":["Non-prompt information about the character:","Creator name/contact","Character version","Creator's notes","Embedded tags list"]},{"l":"Character Personality","p":["Personality Summary: Brief overview of character's traits","Scenario: Context and circumstances of the dialog","Character's Note: Custom message with selectable depth and message role (also see Author's Note)","Talkativeness(Group Chats): Slider for Shy → Normal → Chatty","Example Messages: Examples of character's writing style"]},{"l":"Group Chat Management","p":["If this is a group chat, you can manage the group members and settings from this panel.","See Group Chats for more details."]}],[{"l":"Character Design"},{"l":"Character Description","p":["Used to add the character description and the rest that the AI should know. This will always be present in the prompt, so all the important facts should be included here.","For example, you can add information about the world in which the action takes place and describe the characteristics of the character you are playing for.","It could be of any length (be it 200 or 2000 tokens) and formatted in any style (free text, W++, conversation style, etc)."]},{"l":"Methods and format","p":["Methods of character formatting is a complicated topic beyond the scope of this documentation page.","Recommended guides that were tested with or rely on SillyTavern's features:","Trappu's PLists + Ali:Chat guide: https://wikia.schneedc.com/bot-creation/trappu/creation","AliCat's Ali:Chat guide: https://rentry.co/alichat","kingbri's minimalistic guide: https://rentry.co/kingbri-chara-guide"]},{"l":"Character tokens","p":["TL;DR: If you're working with an AI model with a 2048 context token limit, your 1000 token character definition is cutting the AI's 'memory' in half.","To put this in perspective, a decent response from a good AI can easily be around 200-300 tokens. In this case, the AI would only be able to 'remember' about 3 exchanges worth of chat history."]},{"i":"why-did-my-characters-token-counter-turn-red","l":"Why did my character's token counter turn red?","p":["When we see your character has over half of the model-defined context length of tokens in its definitions, we highlight it for you because this can lower the AI's capabilities to provide an enjoyable conversation."]},{"i":"what-happens-if-my-character-has-too-many-tokens","l":"What happens if my Character has too many tokens?","p":["Don't worry - it won't break anything. At worst, if the Character's permanent tokens are too large, it simply means there will be less room left in the context for other things (see below).","The only negative side effect this can have is the AI will have less 'memory', as it will have less chat history available to process.","This is because every AI model has a limit to the amount of context it can process at one time."]},{"i":"context","l":"'Context'?","p":["This is the information that gets sent to the AI each time you ask it to generate a response:","Character definitions","Chat history","Author's Notes","Special Format strings","[bracket commands]","SillyTavern automatically calculates the best way to allocate the available context tokens before sending the information to the AI model."]},{"i":"what-are-a-characters-permanent-tokens","l":"What are a Character's 'Permanent Tokens'?","p":["These will always be sent to the AI with every generation request:","Character Name (keep the name short! Sent at the start of EVERY Character message)","Character Description Box","Character Personality Box","Scenario Box"]},{"i":"what-parts-of-a-characters-definitions-are-not-permanent","l":"What parts of a Character's Definitions are NOT permanent?","p":["The first message box - only sent once at the start of the chat.","Example messages box - only kept until chat history fills up the context (optionally these can be forced to be kept in context)"]},{"l":"Popular AI Model Context Token Limits","p":["LLaMA 3 and its finetunes - 8192","OpenAI GPT-4 - up to 128k","Anthropic's Claude - 200k (Claude 3) or 100k (Claude 2)","NovelAI - 8192 (Erato and Kayra, Opus tier; Clio, all tiers), 6144 (Kayra, Scroll tier), or 3072 (Kayra, Tablet tier)"]},{"l":"Personality summary","p":["A brief description of the personality.","Examples:","Cheerful, cunning, provocative","Aqua likes to do nothing and also likes to get drunk"]},{"l":"First message","p":["The First Message is an important thing that sets exactly how and in what style the character will communicate.","The character's first message should be long so that later it would be less likely that the character would respond with very short messages.","You can also use asterisks ** to describe the character's actions.","For example:"]},{"l":"Examples of dialogue","p":["Describes how the character speaks. Before each example, you need to add the <START> tag. The blocks of examples dialogue are only inserted if there's a free space in the context for them and pushed out of context block by block. <START> will not be present in the prompt as it is just a marker - it will be instead replaced with \"Example Separator\" from Advanced Formatting for Text Completion APIs and contents of the \"New Example Chat\" utility prompt for Chat Completion APIs.","Use {{char}} instead of the character name.","Use {{user}} instead of the user name.","Example:"]},{"l":"Scenario","p":["Circumstances and context of the dialogue."]},{"l":"Favorite Character","p":["Mark the character as a favorite to quickly filter on the side menu bar by selecting the \"Favorites\" sort option. Favorite characters have a golden highlight in the list. This will also make the character portrait appear in the hotswaps area (if enabled in User Settings)."]}],[{"i":"macros-replacement-tags","l":"Macros (replacement tags)","p":["This list may be incomplete or outdated. Use the /help macros slash command in any SillyTavern chat to get the list of macros that work in your instance.","Macros can be used in character description, author's notes, world info and many other places and replaced with the corresponding values when generating a response. They can be used to insert dynamic content into the prompt, such as the user's name, character's description, or the current time. Macros are enclosed in double curly braces, e.g. {{user}} and are usually case-insensitive. Please keep in mind that macro nesting is currently not supported.","Note: some extensions may also add special context-specific macros that only work in certain areas (i.e. special placeholders for extension prompts). These will not be documented here unless the macro is not bound to a specific functionality."]},{"l":"General Macros","p":["{{// (note)}}","{{banned text here}}","{{bias text here}}","{{char_version}}","{{char}} or BOT","{{charJailbreak}}","{{charPrompt}}","{{currentSwipeId}}","{{date}}","{{datetimeformat ...}}","{{description}}","{{firstIncludedMessageId}}","{{group}} or {{charIfNotGroup}}","{{groupNotMuted}}","{{idle_duration}}","{{input}}","{{isodate}}","{{isotime}}","{{lastCharMessage}}","{{lastGenerationType}}","{{lastMessage}}","{{lastMessageId}}","{{lastSwipeId}}","{{lastUserMessage}}","{{mesExamples}}","{{model}}","{{newline}}","{{noop}}","{{original}}","{{persona}}","{{personality}}","{{pick::(args)}}","{{pipe}}","{{random::arg1::arg2}}","{{random:(args)}}","{{reverse:(content)}}","{{roll:(formula)}}","{{scenario}}","{{time_UTC±X}}","{{time}}","{{timeDiff::(time1)::(time2)}}","{{trim}}","{{user}} or USER","{{weekday}}","1-based ID of the currently displayed last message swipe.","Allows leaving a note that will be replaced with blank content. Not visible for the AI.","Alternate syntax for random that supports commas in its arguments.","Alternative to random, but the selected argument is stable on subsequent evaluations in the current chat if the source string remains unchanged.","Can be used in Prompt Overrides fields to include the default prompt from system settings. Applied to Chat Completion APIs and Instruct mode only.","Character's description.","Character's examples of dialogue (unaltered and unsplit).","Character's Main Prompt override.","Character's name.","Character's personality.","Character's Post-History Instructions Prompt override.","Character's scenario or chat scenario override (if set).","Comma-separated list of group member names or character name in solo chats.","Contents of the user input bar.","Current date/time in specified format (e.g. {{datetimeformat DD.MM.YYYY HH:mm}}).","Current system date.","Current system time.","Current time in the specified UTC offset (timezone), e.g. for UTC+02:00 use {{time_UTC+2}}.","Description","Dynamically adds quoted text to banned word sequences for Text Generation WebUI backend. Does nothing for other backends. Quotes required.","Generates a random value using D&D dice syntax: XdY+Z (e.g. {{roll:d6}} generates a value 1-6).","Inserts a humanized string of the time range since the last user message was sent (examples: 4 hours, 1 day).","Inserts a newline.","Last chat message ID.","Last chat message sent by character.","Last chat message sent by user.","Last chat message text.","Macro","No operation, just an empty string.","Number of swipes in the last chat message.","Only for slash command batching. Replaced with the returned result of the previous command.","Returns a random item from the list (e.g. {{random:1,2,3,4}} will return 1 of the 4 numbers at random).","Reverses the content of the macro.","Same as {{group}} but excludes muted members.","Sets a behavioral bias for the AI until the next user input. Quotes around text are required.","Text generation model name for the currently selected API. Can be inaccurate!","The character's version number.","The current ISO date (YYYY-MM-DD).","The current ISO time (24-hour clock).","The current weekday.","The ID of the first message included in the context. Requires generation to be run at least once in the current session.","The time difference between time1 and time2. Accepts time and date macros.","Trims newlines surrounding this macro.","Type of the last queued generation request. Values: \"normal\", \"impersonate\", \"regenerate\", \"quiet\", \"swipe\", \"continue\".","User's name.","User's persona description."]},{"l":"Instruct Mode and Context Template Macros","p":["(enabled in the Advanced Formatting settings)","{{chatStart}}","{{defaultSystemPrompt}}","{{exampleSeparator}}","{{instructAssistantPrefix}}","{{instructAssistantSuffix}}","{{instructFirstAssistantPrefix}}","{{instructFirstUserPrefix}}","{{instructLastAssistantPrefix}}","{{instructLastUserPrefix}}","{{instructStop}}","{{instructSystemInstructionPrefix}}","{{instructSystemPrefix}}","{{instructSystemPrompt}}","{{instructSystemPromptPrefix}}","{{instructSystemPromptSuffix}}","{{instructSystemSuffix}}","{{instructUserFiller}}","{{instructUserPrefix}}","{{instructUserSuffix}}","{{maxPrompt}}","{{systemPrompt}}","Assistant first output sequence.","Assistant last output sequence.","Assistant message prefix sequence.","Assistant message suffix sequence.","Context template chat start line.","Context template example dialogues separator.","Description","Instruct stop sequence.","Instruct system prompt.","Instruct user first input sequence.","Instruct user last input sequence.","Macro","Max size of the prompt in tokens (context length reduced by response length).","System instruction prefix sequence.","System message prefix sequence.","System message suffix sequence.","System prompt content (excluding character prompt override).","System prompt content, including character prompt override if allowed and available.","System prompt prefix sequence.","System prompt suffix sequence.","User filler message text.","User message prefix sequence.","User message suffix sequence."]},{"l":"Chat variables Macros","p":["{{addglobalvar::name::value}}","{{addvar::name::increment}}","{{decglobalvar::name}}","{{decvar::name}}","{{getglobalvar::name}}","{{getvar::name}}","{{incglobalvar::name}}","{{incvar::name}}","{{setglobalvar::name::value}}","{{setvar::name::value}}","{{var::name::index}}","{{var::name}}","Description","Global variables = works in any chat for any character","Local variables = unique to the current chat","Macro","Replaced with empty string, adds a numeric value of \"increment\" to the global variable \"name\".","Replaced with empty string, adds a numeric value of \"increment\" to the local variable \"name\".","Replaced with empty string, sets the global variable \"name\" to \"value\".","Replaced with empty string, sets the local variable \"name\" to \"value\".","Replaced with the result of decrementing the value of global variable \"name\" by 1.","Replaced with the result of decrementing the value of variable \"name\" by 1.","Replaced with the result of incrementing the value of global variable \"name\" by 1.","Replaced with the result of incrementing the value of variable \"name\" by 1.","Replaced with the value at index of the scoped variable \"name\" (for arrays/objects in STscript).","Replaced with the value of the global variable \"name\".","Replaced with the value of the local variable \"name\".","Replaced with the value of the scoped variable \"name\" (STscript only)."]},{"l":"Extension-specific Macros","p":["Added by extensions and only work under certain conditions.","Macro","Description","{{summary}}","Replaced with the summary of the current chat session (if available)."]}],[{"l":"Chat File Management","p":["This page describes the ways you can manage your AI chat files.","Some of these options are available in the \"Manage chat files\" dialog that opens from the bottom left options menu."]},{"l":"Solo Chats vs Group Chats","p":["The simplest way to use a character card is a Solo chat; just click on their card and start chatting.","Once you have a few character cards, you can also use the \"Create New Chat Group\" button to create a group chat including multiple characters which will then interact with each other and you."]},{"l":"Chat import","p":["Import chats from Character.AI into SillyTavern.","To import Character.AI chats and bots, use the CAI Tools browser extension: https://github.com/irsat000/CAI-Tools.","Other programs and tools that you can import chats from include:","TavernAI (original): https://github.com/TavernAI/TavernAI","Text Generation WebUI (oobabooga): https://github.com/oobabooga/text-generation-webui","Agnai: https://github.com/agnaistic/agnai","KoboldAI Lite: https://github.com/LostRuins/lite.koboldai.net"]},{"l":"Export as .jsonl","p":["When clicking on \"Manage chat files\", each entry on the the chat file list will have a button to export it in a format that can then be re-imported as is. Use this to share or migrate chats including all their metadata (but excluding images and file attachments).","If you're mindful of privacy, be sure to inspect the exported JSONL file and scrub anything you don't want to share."]},{"l":"Export as .txt","p":["You can also export a simplified text-only version with the \"Download chat as plain text document\" button. It can't be re-imported again as it loses important metadata!"]},{"l":"Checkpoints","p":["\"Checkpoints\" are clones of the current chat, in that they copy all messages from the given chat up to a certain point, and they store a link to the source (by chat file name).","From the three dots button at the right of each chat message, you have two ways to create checkpoints:","\"Create Branch\" will clone the current chat up to that message and switch to it","\"Create Checkpoint\" will clone current chat up to that message, ask for a name and create it but NOT switch to it","You can think of them as roughly as \"open link in new tab\" and \"open link in new tab in the background\" in a browser.","You can go back to the parent from a checkpoint by entering the burger menu button on the left of the message text box, then clicking \"Back to parent chat\"."]},{"l":"Rename Chat","p":["By default chat files are given a named with the date and time they were started.","You can change this by clicking the pencil icon and typing in a new name.","Note that this will break links to that chat from checkpoints (since they are linked by chat file name)."]}],[{"l":"Group Chats"},{"l":"Reply order strategies","p":["Decides how characters in group chats are drafted for their replies."]},{"l":"Manual","p":["You can select the character to reply manually from the menu or with the /trigger command. The selected group member will be the only one to reply. User messages won't trigger any replies automatically. Triggering a generation with an empty user input will trigger a random unmuted group member to reply."]},{"l":"Natural Order","p":["Tries to simulate the flow of a real human conversation. The algorithm is as follows:","Mentions of the group member names are extracted from the last message in chat.","Only whole words are recognized as mentions! If your character's name is \"Misaka Mikoto\", they will reply only activate on \"Misaka\" or \"Mikoto\", but never to \"Misa\", \"Railgun\", etc.","Unless the \"Allow Self Responses\" setting is enabled, characters won't reply to mentions of their name in their own message!","Characters are activated by the \"Talkativeness\" factor.","Talkativeness defines how often the character speaks if they were not mentioned. Adjust this value on the \"Advanced Definitions\" screen in the character editor. Slider values are on a linear scale from 0% / Shy(character never talks unless mentioned) to 100% / Chatty(character always replies). The default value for new characters is 50% chance.","A random character is selected.","If no characters were activated at previous steps, one speaker is selected randomly, ignoring all other conditions."]},{"l":"List Order","p":["Characters are drafted based on the order they are presented in the group members list. No other rules apply."]},{"l":"Group generation handling mode","p":["This setting decides how to handle the character information of the group chat members. No matter the choice, the group chat history is always shared between all the members."]},{"l":"Swap character cards","p":["Default mode. Every time the message is generated, only the character card information of the active speaker is included in the context."]},{"l":"Join character cards","p":["The information of all of the group members is combined into one joint prompt in their list order. This can help in cases when altering large chunks of the context is undesirable, e.g. with llama.cpp prompt caching.","This mode has two sub-modes (you must choose one):","Include muted - muted characters will always be included into the joint prompt.","Exclude muted - muted characters won't be included if they aren't the current speaker.","The following fields are being combined:","Description","Scenario, if not overridden for the chat","Personality","Message examples","Character notes / Depth prompts","Important! Please be aware that due to how the typical character card is structured, the use of this mode can lead to unexpected behavior, including but not limited to: characters being confused about themselves, having merged personalities, uncertain traits, etc."]},{"l":"Join Prefix and Suffix","p":["When 'Join character cards' is selected, all respective fields of the characters are being joined together. This means that in the resulting prompt all character descriptions will be joined to one big blob of text. If you want those fields to be separated, you can define a prefix and/or suffix.","These options support normal macros and will also replace {{char}} with the relevant characters's name and <FIELDNAME> with the name of the part (e.g.: description, personality, scenario, etc.)"]},{"l":"Other Group Chat menu options"},{"l":"Mute Character","p":["The struck-out speech bubble icon next to the character avatar in the group chat menu can disable or enable replies from a particular character in the chat."]},{"l":"Force Talk","p":["The speech bubble icon next to the character avatar in the group chat menu will trigger a reply only from a particular character, bypassing the reply order strategy. It will work even if the group member is muted."]},{"l":"Auto-mode","p":["While auto-mode is enabled, the group chat will follow the reply order and trigger the message generation without user interaction. The next auto-mode turn is triggered after a 5-second delay when the last drafted character sends its message. When the user starts typing into the send message text area, the auto-mode will be disabled, but already queued generations are not stopped automatically."]},{"l":"Allow Self Responses","p":["Will allow consecutive replies from the character who sent the latest message of each turn if they happen to be triggered due to being self-mentioned when the Natural Order is selected. Has no effect on List order."]},{"l":"Group Chat Scenario Override","p":["All group members will use the entered scenario text instead of what is specified in their character cards. Branched chats inherit the scenario override from their parent and can be changed individually after that."]},{"l":"Peek Character Definitions","p":["Clicking on the character card icon next to the avatar in the group chat menu will quickly navigate to the usual character definitions screen. Any changes made here will be saved to the card itself.","To return back to the group chat, click the Group Name title link."]},{"l":"Member Management","p":["Any of your existing characters can be added, removed, muted, or re-ordered within the group chat. By default, a new member is added to the top of the group members list and then can be re-ordered using the arrow icons."]},{"l":"Group Chat pop-out","p":["The group chat menu pop-out can be activated by clicking on the icon next to the \"Current Members\" field. This creates a pop-out of the group chat menu. By enabling MovingUI from user settings, this menu can resized and dragged to any position within the interface and functions just like the regular group chat menu."]}],[{"l":"Tags","p":["Character cards and groups can be assigned zero or more tags. They are useful to organize quickly growing collections by themes, quality, provenance or whatever you like."]},{"l":"Tagging","p":["There are several ways to add or remove tags to a character card:","Import embedded tags during the import.","Open a card from the Character Management panel. From there you will be able to assign tags to a character card.","Mass tagging.","To do mass tagging, click the \"Bulk edit characters\" button (pencil icon), select the cards you want to tag, right click on any of them, then click \"Tag\" in the contextual menu.","Please note that groups cannot be mass tagged.","From this screen you will be able to:","Add or remove tags using the combo box.","Remove all tags from the selected cards (\"All\").","Remove the intersection of tags among all selected cards from those cards (\"Mutual\").","Import (create locally) all tags stored in the character card, in case you imported it (\"Import All\").","Import (create locally) tags stored in the character card which also exist locally with matching names (\"Import Existing\")."]},{"l":"Managing","p":["To view and manage all existing tags, open the Character Management panel then click on the \"Manage tags\" button (gear icon).","You can backup and restore all the information here (tag list, tag assignments to cards, colors, folder settings, etc) using the buttons on the top right.","You can use grip buttons on the left to reorder tags as they will appear in the tag filter in Character Management.","The tags backup JSON file is not intended for sharing with others as it contains information specific to your instance only, such as internal entity names!"]},{"l":"Importing tags when importing character cards","p":["When importing external character cards from downloaded images (or from the \"Import content from external URL\" button), you'll be prompted to optionally import the tags that it contains. They are not required for the card to function; tags are simply organizational.","Embedded card tags are stored in the \"Creator's Metadata\" section of \"Advanced Definitions\" menu of the character editor. If you wish to propose some tags to other users who would import that character, populate the \"Tags to Embed\" field with a comma-separated list of tags.","This popup will appear only if a User Settings option \"Import Card Tags\" is set to \"Ask\".","In the \"Import tags for CHARACTER NAME\" popup that opens, you'll see a list of Existing tags (which you already had locally with a matching name), and New tags (which you did not have locally).","You can either:","Trim the lists as needed and then hit \"Import\" - remaining Existing tags will be added to the imported character card, and remaining New tags will be created locally and then added to the card.","Or simply hit \"Import none\" to ignore tags contained in the character card and import ONLY the card.","Or \"Import All\" as a shortcut to import all tags found in the character card (NOTE: including any that you trimmed from the lists above; use the \"Import\" button if you did).","Or \"Import Existing\" as a shortcut to only import tags that existed locally with a matching name."]},{"l":"Filtering character cards","p":["After you create tags, you will see them on a row in the Character Management panel. You can click these to switch tag filtering state; in order:","One click will show cards tagged with this tag.","Another click to only show cards NOT tagged with this tag.","Another click to reset filtering by this tag.","You can filter by any number of tags at the same time."]},{"l":"Tags as Folders","p":["To use this functionality, it has to be enabled first in the User Settings, under the UI Theme column. The state of this toggle also saves with the UI theme.","From the \"Manage tags\" button (gear icon), each tag entry has a multi-state toggle button to cycle between these tags-as-folder modes (called \"bogus folder\" in the code):","one click to turn this tag into an \"open folder\". It will appear as a virtual entry in the card list; clicking into it will only show cards with that tag","another click to turn this tag into a \"closed folder\". As above, but cards tagged with this tag will not appear by default - you'll need to click into the folder to see them.","another click to reset tag-as-folder state for this tag."]}],[{"i":"authors-note","l":"Author's Note"},{"i":"what-is-it","l":"What is it?","p":["Author's Note is a powerful tool for customizing AI responses which inserts a section of text into the prompt at any position and at any frequency you desire."]},{"l":"Usage","p":["The Author's Note can be found in the Options menu on the left side of the chat input bar.","Options Menu","Author's Note Panel"]},{"i":"configuring-authors-notes","l":"Configuring Author's Notes"},{"i":"chat-specific-authors-note","l":"Chat-specific Author's Note","p":["The box at the top of the Author's Note panel contains the Author's Note for your current chat.","The Content of this box is not automatically transferred to any new chat."]},{"l":"Placement options"},{"l":"After Scenario","p":["This places the Author's Note towards the top of the context after the 'Scenario' section of the Character Definition. If no scenario is specified, it will be placed after the last portion of the Character Definition, and before the Example messages."]},{"l":"In-chat","p":["This places the Author's Note into the chat history at the specified depth.","Depth 0 = placed at the very end of the chat history.","Depth 4 = placed before the most recent 3 chat history messages, making it become the 4th entity in the chat history.","The closer the Author's Note is to the bottom of the prompt, the more impact it has on the next AI response."]},{"l":"Insertion Frequency","p":["This is how often you want the Author's Note to be included in the chat.","Frequency 0 = Author's Note will never be inserted.","Frequency 1 = Author's Note will be inserted with every user input prompt.","Frequency 4 = Author's Note will be inserted into every 4th user input prompt."]},{"i":"default-authors-note","l":"Default Author's Note","p":["The box at the bottom of the panel contains the Default Author's Note which will be applied to each new chat."]},{"l":"Common Use Cases"},{"l":"Remind AI of response formatting","p":["The Author's Note can be used to specify how the AI should write it's responses.","[Your next response must be 300 tokens in length.]","[Write your next reply in the style of Edgar Allan Poe]","[Use markdown italics to signify unspoken actions, and quotation marks to specify spoken word.]"]},{"l":"Reinforcing Instructions","p":["[Remember the instructions you were given at the beginning of this chat.]"]},{"i":"as-temporary-world-info-character-bias-or-instruct-for-non-instruct-models","l":"As temporary World Info, Character Bias, or Instruct for non-Instruct models","p":["[{{char}} is in the library]","[{{user}} has a fresh wound to his leg, so won't be able to run away.]","[{{char}} cannot speak and must communicate using hand signals.]"]}],[{"i":"data-bank-rag","l":"Data Bank (RAG)","p":["Retrieval-augmented generation (RAG) is a technique for providing external sources of knowledge to the LLM. It helps improve the accuracy of AI answers by accessing information outside of the model's training data.","SillyTavern provides a set of tools for building a multi-purpose knowledge base from a diverse number of sources, as well as using the collected data in LLM prompts."]},{"l":"Accessing the Data Bank","p":["The built-in Chat Attachments extension (included by default in release versions >= 1.12.0) adds a new option in the \"Magic Wand\" menu - Data Bank. This is your hub for managing the documents available for RAG in SillyTavern."]},{"l":"About Documents","p":["Data Bank stores file attachments, also known as documents. The documents are divided into three scopes of availability.","Global attachments - available in every chat, either solo or group.","Character attachments - available only for the currently chosen character, including when they are replying in a group. Attachments are saved locally and are not exported with the character card!","Chat attachments - available only in the currently open chat. Every character in the chat can pull from it.","While not formally a part of the data bank, you can attach files even to individual messages. Use the Attach File option from the \"Wand\" menu, or a paperclip icon in the message actions row.","What can be a document? Practically anything that is representable in plain text form!","Examples include, but are not limited to:","Local files (books, scientific papers, etc.)","Web pages (Wikipedia, articles, news)","Video transcripts","Various extensions and plugins can also provide new ways to gather and process data, more on that below."]},{"l":"Data Sources","p":["To add a document to any of the scopes, click \"Add\" and pick one of the available sources."]},{"l":"Notepad","p":["Create a text file from scratch, or edit an existing attachment."]},{"l":"File","p":["Upload a file from the hard drive of your computer. SillyTavern provides built-in converters for popular file formats:","PDF (text only)","HTML","Markdown","ePUB","TXT","You can also attach any text files with non-standard extensions, such as JSON, YAML, source codes, etc. If there are no known conversions from the type of a selected file, and the file can't be parsed as a plain text document, the file upload will be rejected, meaning that raw binary files are not allowed.","Importing Microsoft Office (DOCX, PPTX, XLSX) and LibreOffice documents (ODT, ODP, ODS) requires a Server Plugin to be installed and loaded. See the plugin's README page for installation instructions."]},{"l":"Web","p":["Scrape text from a web page by its URL. The HTML document is then processed through the Readability library to extract only usable text.","Some web servers may reject fetch requests, be protected by Cloudflare, or rely heavily on JavaScript to function. If you're facing issues with any particular site, download the page manually through the web browser and attach it using the file uploader."]},{"l":"YouTube","p":["Download a transcript of the YouTube video by its ID or URL, either uploaded by the creator or automatically generated by Google. Some videos may have the transcripts disabled, also parsing of age-restricted videos is unavailable as it requires login.","The script is loaded in the video's default language. Optionally, you can specify the two-letter language code to try and fetch the transcript in a specific language. This feature is not always available and may fail, so use it with caution."]},{"l":"Web Search","p":["This source requires to have a Web Search extension installed and properly configured. See the linked page for more details.","Perform a web search and download the text from the search result pages. This is similar to the Web source but fully automated. A chosen search engine will be inherited from the extension settings, so set it up in advance.","To begin, specify the search query, max number of links to be visited, and the output type: one combined file (formatted according to the extension rules) or an individual file for every single page. You can choose to save the page snippets as well."]},{"l":"Fandom","p":["This source requires to have a Server Plugin installed and loaded. See the plugin's README page for installation instructions.","Scrape articles from a Fandom wiki by its ID or URL. As some wikis are very large, it may be beneficial to limit the scope using the filter regular expression, it will be tested against the article's title. If no filter is provided, then all of the pages are subject to be exported. You may save them either as individual files for every page, or joint into a single document."]},{"i":"bronie-parser-extension-third-party","l":"Bronie Parser Extension (Third-Party)","p":["This source comes from a third-party and is not affiliated with the SillyTavern team. This source requires you to have Bronya Rand's Bronie Parser Extension installed as well as Server Plugins that require the parser to work.","Bronya Rand's Bronie Parser Extension allows the use of third-party scrapers, such as miHoYo/HoYoverse's HoYoLab into SillyTavern, similar to the other data sources.","Currently, Bronya Rand's Bronie Parser Extension supports the following:","miHoYo/HoYoverse's HoYoLab (for Genshin Impact/Honkai: Star Rail) via HoYoWiki-Scraper-TS","To begin, install Bronya Rand's Bronie Parser Extension by following it's installation guide and install a supported Server Plugin into SillyTavern. Restart SillyTavern and go to the Data Bank menu. Click + Add and you should see that your recently installed scrapers are added into the possible list of sources to obtain information from."]},{"l":"Vector Storage","p":["So, you've built yourself a nice and comprehensive library of information on your specific subject matter. What's next?","To use the documents for RAG, you need to use a compatible extension that will insert related data into the LLM prompt.","Vector Storage, which comes bundled with SillyTavern, is a reference implementation of such an extension. It uses embeddings (also known as vectors) to search for documents that relate to your ongoing chats.","Embeddings are arrays of numbers that abstractly represent a piece of text, produced by specialized language models. More similar texts have a shorter distance between their respective vectors.","Vector Storage extension uses the Vectra library to keep track of file embeddings. They are stored in JSON files in the /vectors folder of your user data directory. Every document is internally represented by its own index/collection file.","As the Vectors functionality is disabled by default, you need to open the extensions panel (\"Stacked Cubes\" icon on the top bar), then navigate to the \"Vector Storage\" section, and tick the \"Enabled for files\" checkbox under the \"File vectorization settings\".","By itself, Vector Storage does not produce any vectors, you need to use a compatible embedding provider."]},{"l":"Vector Providers"},{"l":"Local","p":["These sources are free and unlimited and use your CPU/GPU to calculate embeddings.","Local (Transformers) - runs on a Node server. SillyTavern will automatically download a compatible model in ONNX format from HuggingFace. Default model: jina-embeddings-v2-base-en.","Extras - runs under the Extras API using the SentenceTransformers loader. Default model: all-mpnet-base-v2.","Ollama - get it from https://ollama.com/. Set the API URL in the API connection menu (under Text Completion, default: http://localhost:11434). Must download a compatible model first, then set its name in the extension settings. Example model: mxbai-embed-large. Optionally, check an option to keep the model loaded in memory.","llama.cpp server - get it from ggerganov/llama.cpp and run the server executable with --embedding flag. Load compatible GGUF embedding models from HuggingFace, for example, nomic-ai/nomic-embed-text-v1.5-GGUF.","vLLM - get it from vllm-project/vllm. Set the API URL and API key in the API connection menu first."]},{"l":"API sources","p":["All these sources require an API key of the respective service and usually have a usage cost, but generally calculating embeddings is pretty cheap.","OpenAI","Cohere","Google MakerSuite","TogetherAI","MistralAI","NomicAI","Embeddings are only usable when they are retrieved using the same model that generated them. When changing an embedding model or source, it is recommended to purge and recalculate file vectors."]},{"l":"Vectorization Settings","p":["After you've selected your embedding provider, don't forget to configure other settings that will define the rules for processing and retrieving documents.","Splitting, vectorization, and retrieval of information from the attachments take some time. While the initial ingestion of the file may take a while, the RAG search queries are usually fast enough not to create a significant lag."]},{"l":"Message attachments","p":["These settings control the files that are attached directly to the messages.","The following rules apply:","Only messages that fit in the LLM context window can have their attachments retrieved.","When the vector storage extension is disabled, file attachments and their accompanying message are fully inserted into the prompt.","When file vectorization is enabled, then the file will be split into chunks and only the most relevant pieces will be inserted, saving the context space and allowing the model to stay focused.","Size threshold (KB) - sets a chunking splitting threshold. Only the files larger than the specified size will be split.","Chunk size (chars) - sets the target size of an individual chunk (in textual characters, not model tokens!).","Chunk overlap (%) - sets the percentage of a chunk size that will be shared between adjacent chunks. This allows for a smoother transition between the chunks, but may also introduce some redundancy.","Retrieve chunks - sets the maximum amount of the most relevant file chunks to be retrieved. They will be inserted in their original order."]},{"l":"Data Bank files","p":["These settings control how the Data Bank documents are handled.","The following rules apply:","When file vectorization is disabled, the Data Bank is not used.","Otherwise, all available documents from the current scope (see above) are considered for the query. Only the most relevant chunks across all the files are retrieved. Multiple chunks of the same file are inserted in their original order.","The inserted chunks will reserve a part of the context before fitting the chat messages.","Size threshold (KB) - sets a chunking splitting threshold. Only the files larger than the specified size will be split.","Chunk size (chars) - sets the target size of an individual chunk (in textual characters, not model tokens!).","Chunk overlap (%) - sets the percentage of a chunk size that will be shared between adjacent chunks. This allows for a smoother transition between the chunks, but may also introduce some redundancy.","Retrieve chunks - sets the maximum amount of the file chunks to be retrieved. This allowance is shared between all files.","Injection Template - defines how the retrieved information will be inserted into the prompt. You can use a special {{text}} macro to specify the position of the retrieved text, as well as any other macros.","Injection Position - sets where to insert the prompt injection. The same rules as for Author's Note and World Info apply."]},{"l":"Shared settings","p":["Query messages - how many of the latest chat messages will be used for querying document chunks.","Score threshold - adjust to allow culling the retrieval of chunks based on their relevance score (0 - no match at all, 1 - perfect match). Higher values allow for more accurate retrieval and prevent completely random information from entering the context. Sane values are in a range between 0.2 (more loose) and 0.5 (more focused).","Include in World Info Scanning - check if you want the injected content to activate lore book entries.","Vectorize All - forcibly ingests the embeddings for all unprocessed files.","Purge Vectors - clears the file embeddings, allowing to recalculate their vectors.","For \"Chat vectorization\" settings see Chat Vectorization."]},{"l":"Conclusion","p":["Congratulations! Your chatting experience is now enhanced with the power of RAG. Its capabilities are only limited by your imagination. As always, don't be afraid to experiment!"]}],[{"l":"Extensions","p":["SillyTavern comes with many extensions that can be enabled or disabled in the Extensions panel. Extensions can add new features, change the behaviour of existing features, or provide additional content for your AI to use. More extensions can be installed from the \"Download Extensions & Assets\" menu in the Extensions panel."]},{"l":"Extensions panel","p":["To open or close the Extensions panel, choose Extensions in the top bar.","Manage extensions: Activate, deactivate, and update extensions","Download Extensions & Assets: Install more extensions, characters, sounds, and backgrounds from the SillyTavern repository","Notify on extension updates: Check to be notified when there are updates available for installed extensions","Install extension: Import an extension from a Git repository URL","Using third-party extensions can have unintended side effects and may pose security risks. Always make sure you trust the source before importing an extension via Install extension. We are not responsible for any damage caused by third-party extensions."]},{"l":"Built-in extensions","p":["Auto-summary of the chat history","Chat Translation","Chat Vectorization","Converts text into tokens and counts the number of tokens","Expression Images","Finds relevant messages from chat history and adds them into the context","Generates text from images so your AI can \"see\" and respond to visual content in your conversations","Image Captioning","Image Generation","Images (aka 'sprites') of your AI character, shown next to or behind the chat window","Quick Reply","Reply to chat messages with a single click, run commands and STscripts, and more","Summarize","Text To Speech","These extensions are built into SillyTavern and do not need to be installed. They can be enabled or disabled in the Extensions panel.","Token Counter","Translate chat messages to a different language","Use local or cloud-based Stable Diffusion, FLUX or DALL-E APIs to generate images","Voice narration for your chat messages via ElevenLabs, Silero, your system TTS, AllTalk, XTTS, and more"]},{"l":"Installable extensions","p":["A set of 7 classic D&D dice for all your dice rolling needs.","AccuWeather","Adds \"idle prompting\" after the user has been idle for some time to organically continue the conversation.","Adds a button to quickly insert a /sendas command template for the selected group member.","Adds a button to quickly insert emojis into a chat message.","Adds a dropdown menu for selecting user personas from the chat bar.","Adds a place to store your notes. Supports rich text formatting.","Adds a silence audio player to the extensions menu. Can help if the browser tab is being killed in a background.","Adds a timeline navigation to the chat history.","Adds a top bar to the chat window with shortcuts to quick actions.","Adds ability to randomize API settings sliders with every generation.","Adds an ability to cluster characters by similarity groups to easily find duplicates.","Adds an option to inspect and edit output prompts before sending them to the server.","Adds immersive background music and ambient sounds to your chats.","Adds Mermaid diagrams & flowcharts rendering to SillyTavern chats.","Adds Realtime Voice Cloning capabilities to the Text-to-Speech module.","Adds support for live2d models. Customizable expressions, animations and interactions.","Adds support for VRM models. Customizable expressions, animations and interactions.","Adds web search results to LLM prompts.","Allows running JavaScript and STscript code from code blocks in chat.","Allows setting alternate greetings that are specific to group chats.","Allows to receive push notifications for incoming chat messages.","Animate the text of character messages with variable speed and play sound along the animation.","Blip","Chat Top Bar","Chess","Code Runner","Convert your speech to text using browser or extras.","D&D Dice","Duplicate Finder","Dynamic Audio","Easy way to view and modify variables.","Emoji Picker","EmulatorJS","Enhances the current visual novel experience with more features (Focus Mode, Letterbox Mode, and more)!","Gets the latest news from RSS feeds as a slash command or a function tool.","Group Greetings","Group SendAs","HypeBot","Idle","Image Metadata Viewer","Install any of these extensions from the \"Download Extensions & Assets\" menu in Extensions.","LaTeX","Live2d","Mermaid","Notebook","Objective","Parameter Randomizer","Play retro console games directly in SillyTavern chats.","Play the game of chess with the LLM.","Prome Visual Novel Extension","Prompt Inspector","Provides an interface for extensions to use language models directly in the browser.","Provides the screen image for multimodal models when you send a message.","Provides weather information using the AccuWeather API as a slash command or a function tool.","Push Notifications","Quick Persona","Render LaTeX and AsciiMath formulas in chat messages.","RSS","RVC","Screen Share","Set an Objective for the AI to aim for during the chat.","Show personalized suggestions based on your recent chats using the NovelAI's HypeBot engine. Requires an active NovelAI subscription.","Silence Player","Speech Recognition","The Extras project was discontinued in April 2024. You do not need to install Extras to use extensions.","Timelines","Variable Viewer","View metadata of enlarged images attached to a chat.","VRM","Web Search","WebLLM"]}],[{"l":"Blip","p":["This guide will walk you through setting up and customizing blip extension for your SillyTavern experience. This extension animate the text of messages with variable speed and play sound along the animation. You can use audio file or generate the sound."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Blip\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"l":"Blip global settings","p":["Blip user message:","Enable checkbox to play animation on user message.","Set a profile for the user or a default profile if you want blip animation for user.","Blip only for certain text:","Enable checkbox to only blip for text inside quotes.","Enable checkbox to ignore everything inside asterisks.","Automatic scroll down:","Enable checkbox to make the chat go down to follow the text animation, disable it if you wanna scroll freely during animation.","Audio volume","Mute the audio if just the animation of the text is desired.","You can adjust the global volume of blip audio."]},{"i":"character-animationvoice-profile","l":"Character animation/voice profile","p":["Any profile can be deleted using the remove button.","Audio parameters:","Blip origin: file:","Blip origin: Generated sound:","Choose a file in the list.","Enable the checkbox to force to wait entire file is played before playing again if needed.","If it does not have a profile yet the current parameters will become his profile settings.","If min/max are different a random sound in this range is played each time.","If only the current chat characters are shown in the list, click the checkbox to show all your characters.","including the user and an optional default profile that will be used when character have no profile.","Or put file directly into: \\SillyTavern\\data\\user-handle\\assets\\blip.","Select a character, if he have a profile it will be loaded.","Select the character to assign/update profile:","Set a volume multiplier that will only affect this voice profile if needed.","Set audio speed: the delay between each blip sound, independant of text speed.","Set comma/phrase delay superior to 0 to add a pause when special character are printed, can add more liveliness to animation. Audio is paused too in this case.","Set Min/max speed multiplier different to 1.0 for randomness of speed animation.","Set the text speed: the delay in milliseconds between each letter printed.","Text animation settings:","Thank you for following this guide! Your SillyTavern experience is now enriched with text animation and blip voices.","Use refresh button if your character does not appear in the list.","Use the min/max frequency slider to customize the blip sound played.","You can get official ST blip assets from the assets extension menu.","You can save a profile for each character:"]}],[{"l":"Chat Translation"},{"l":"Overview","p":["The Chat Translation Extension enables real-time translation of chat messages between different languages using various translation providers. It supports both manual and automatic translation modes.","Character message translated from English to Chinese using 'Translate Message/翻譯訊息' message action button","\"Translate Chat\", \"Translate Input\"","\"翻译聊天\", \"翻译输入\"","\"翻譯聊天內容\", \"翻譯輸入內容\"","\"채팅 번역하기\", \"입력 번역하기\"","\"Перевести чат\", \"Перевести моё сообщение\""]},{"l":"Usage","p":["All the ways to translate chat messages:","Translate Chat button in the Extensions menu","Translates the entire chat history at once","Translate Input button in the Extensions menu","Translates just the current input text","Useful before sending a message","Translate Message icon in the Message Actions toolbar of any message","Click to translate just that message","Click again to revert to original text","Auto-mode configuration in the Chat Translation drawer of the Extensions panel","Automatically translates user inputs, AI responses, or both","/translate slash command","Use /translate [target=language_code] text to translate text"]},{"l":"Configuration","p":["Configuration options are available in the Chat Translation drawer of the Extensions panel."]},{"l":"Provider","p":["Choose your preferred translation service","Click the API Key icon, if it appears, to enter an API key","Click the Custom URL icon, if it appears, to enter a custom API URL"]},{"l":"Target Language","p":["Select the language you want to write your messages in, or read AI responses in."]},{"l":"Auto-mode","p":["Configure automatic translation behavior.","None: No automatic translation","Translate responses: Automatically translates AI responses into the target language","Translate inputs: Automatically translates user inputs into English","Translate both: Translates both user inputs and AI responses"]},{"l":"Clear Translations","p":["The Clear Translations button removes all translations from messages in the current chat. The original messages are preserved."]},{"i":"configuration-example-chinese-to-english-chatting","l":"Configuration Example: Chinese to English Chatting","p":["To set up a workflow where a Chinese-speaking user can chat in Chinese with an AI that operates in English:","Set Auto-mode to \"Translate both\"","Set Target Language to \"Chinese (Simplified)\" or \"Chinese (Traditional)\"","Choose a translation provider with good language auto-detection (e.g., Google or DeepL)","This setup will:","Translate user's Chinese input to English for the AI","Translate AI's English responses back to Chinese for the user","This setup relies on automatic language detection for input. For more precise control, future updates may include explicit source language selection."]},{"l":"Translation providers","p":["Alternative front-end for Google Translate, open source (AGPL-3.0), privacy-focused","Bing Translator","Cloud-based Local, custom URL Requires API key","DeepL","DeepLX","Features","Good for Russian and Eastern European languages","Google Translate","High-quality translations, especially for European languages","Libre Translate","Lingva Translate","Location","Microsoft's translation service, integrates with Azure services","OneRing Translator","Provider","Self-hosted (AGPL-3.0) alternative to proprietary translation services, with cloud-hosted Pro tier","Self-hosted DeepL proxy, open source (MIT), free but proxying DeepL Pro requires DeepL API key","Self-hosted front-end to Google Translate and other providers, privacy-focused, open source (AGPL-3.0)","Widely used, supports many languages, good accuracy","Yandex Translate"]},{"l":"DeepL-specific configuration","p":["Formality levels available for German, French, Italian, Spanish, Dutch, Japanese, and Russian","Configure via deepl.formality in config.yaml"]},{"l":"Slash Commands","p":["Use /translate command for quick translations. Syntax: /translate [target=language_code] text. If target language is not provided, the value from the extension settings will be used."]},{"l":"Basic usage","p":["Translate text to the current target language and show it in a popup:","Popup in Chinese (Simplified), '欢迎来到酒馆/Welcome to the Tavern'","Translate text to Spanish and add it to the chat:","User message in Spanish, 'Hola Mundo/Hello world'"]},{"i":"testing-pipeline-translation-localization","l":"Testing, pipeline translation, localization","p":["Prompt the user for a message and a language, translate the message into that language, then re-translate it into the configured target language and show both translations in a popup. This example uses the /input and /buttons commands to gather user input:","This is useful for checking the quality of a translation into a language that you don't speak, before writing it somewhere important.","Popup, 'Welcome to the Tavern/欢迎来到酒馆/welcome to the pub', en, zh-CN, en Popup, 'My hovercraft is full of eels/我的氣墊船裡裝滿了鰻魚/My hovercraft is filled with eels', en, zh-TW, en","The UI controls are shown in the current locale, independent of the configured target language.","/input","/buttons","Input dialog, '发送测试消息/Send Test Message'","Buttons dialog, '语言/Language'","Popup, '我的氣墊船裡裝滿了鰻魚/My hovercraft is full of eels', zh-TW -> en -> zh-TW","Input language detection is relatively effective in the following examples:","Popup, '(My hovercraft is full of eels)/A légpárnás hajóm tele van angolnával/我的氣墊船裡裝滿了鰻魚', zh-TW -> hu -> zh-TW Popup, '我的氣墊船裡裝滿了鰻魚/Mi aerodeslizador está lleno de anguilas/My hovercraft is full of eels', zh-TW -> es -> en Popup, 'Il mio hovercraft è pieno di anguille/我的气垫船里装满了鳗鱼/My hovercraft is filled with eels', it -> zh-CN -> en"]},{"l":"Technical Notes","p":["UTF-8 encoding, special characters, and emojis are supported","Handles large messages by splitting into chunks when needed","Preserves formatting and embedded images in messages","Caches translations to avoid redundant API calls"]},{"l":"AI input language","p":["internal_language controls the language into which user messages are auto-translated before being sent to the AI. It is hardcoded to 'en' in the default settings and cannot be changed through the UI. Thus, the translation target language for messages to the AI is always English. Previous testing showed that AI performance was better when receiving English messages, but this may change as more LLMs are being trained on more varied language data. I suppose one could change internal_language in settings.json and find out."]},{"l":"Chinese variant handling","p":["The extension supports both Simplified and Traditional Chinese, but not all translation providers do. The UI presents these as 'Chinese (Simplified)' and 'Chinese (Traditional)' respectively, with language codes 'zh-CN' and 'zh-TW'. They are mapped to the following language codes for translation providers:","Libre Translate: 'zh-CN' to 'zh' and 'zh-TW' to 'zt'.","DeepL and DeepLX: both variants to 'ZH'.","Bing: 'zh-CN' to 'zh-Hans', 'zh-TW' as-is.","Other providers use 'zh-CN' and 'zh-TW' as provided."]},{"l":"Text length limits","p":["Some providers have character limits per request:","Yandex: 5000 characters","DeepLX: 1500 characters","Bing: 1000 characters","Google: 5000 characters","Longer texts are automatically split into chunks for translation."]}],[{"l":"Chat Vectorization","p":["The use of this extension does not guarantee a better chatting experience or improved memory of any sort. Only use if you understand all the implications of vector database utilization.","Chat vectorization searches for messages in your current chat history that seem relevant to your most recent messages. It temporarily shuffles the most relevant messages to the beginning or end of the chat history. This happens when the model's reply to your last message is generated.","The messages at the start and end of the chat history tend to have the greatest impact on the model's reply. Therefore, shuffling relevant messages to these locations can help the model focus on relevant information in its reply.","In particular, chat vectorization can find relevant messages that are too far back in the message history to fit into the request context. Shuffling these messages into context provides the model with information that it would not have otherwise.","Chat vectorization is a kind of retrieval-augmented generation (RAG). Retrieval-augmented generation increases the quality of responses generated by a model, by providing additional relevant information in the prompt.","Retrieval: the most recent messages are used to retrieve relevant past messages","Augmented: the model's context is augmented by inserting past messages in a useful way","Generation: the model is instructed to use the past messages when generating the response","A vector is a set of numbers that could represent the themes, content, style, or other characteristics of a piece of text.","Vectorization is calculating the vector that represents a piece of text. This is done by a vectorizing model. Just as text generation models make text from text, vectorizing models make vectors from text.","Vector search finds relevant results by comparing vectors rather than, say, keywords. If we calculate the vector for a search query, we can compare it to the stored vectors for a collection of pieces of text. This finds the texts in our collection that are most similar to the text in the search query. In the case of chat vectorization, the\"search query\" is the most recent 2 messages, and the \"texts in our collection\" are all the other messages in the chat."]},{"l":"Setting up","p":["To enable Chat vectorization, select \"Extensions\" > \"Vector Storage\" > \"Enabled for chat messages\".","Configure a vectorization source and vectorization model. Chat vectorization uses the same vector source as Data Bank, so you may have set this up already. The settings for the Vectorization Source and Vectorization Model are documented in Data Bank.","Chat vectorization uses the same vector storage as Data Bank, but this does not need to be set up or configured. There is also information about Vector Storage in Data Bank.","Chat vectorization does not use Data Bank to store the chat messages. The messages are stored in the chat."]},{"i":"preparing-chat-messages-for-search-vector-storage","l":"Preparing chat messages for search (vector storage)","p":["So that chat messages can be searched, a vector is calculated for each message and stored.","Vectorizing occurs in the background, whenever you send or receive a message.","Each message is stored individually, so that it can be found and shuffled individually during generation.","Large messages are split into \"chunks\" so that the model can be given the most relevant part of a long message. The chunk size is 400 characters. You can change this with \"Chunk size (chars)\".","Messages are divided into chunks by finding a chunk boundary such as a paragraph break, line break, or space between words. This is so that the all the chunks make sense, as far as possible. If your chat messages have some other way to mark natural splitting points, such as ----, you can add this to \"Chunk boundary\". The setting for \"Chunk boundary\" is shared with Data Bank."]},{"l":"Vector storage controls","p":["To calculate vectors for all messages in the current chat, without waiting for them to be processed in the background, choose \"Vectorize All\" from the settings.","To see how many messages in the current chat have been vectorized, choose \"View Stats\". This displays the total number of vectors stored. It also indicates the specific chat messages that have been vectorized, by marking them with a green ball.","To remove all the vectors for messages in the current chat, choose \"Purge Vectors\".","The controls for \"Vectorize All\" and \"Purge Vectors\" within Chat vectorization only affect the stored vectors for the current chat. However, there are identical buttons in File vectorization that affect the vectors for files in Data Bank. Ensure that you are purging the vectors that you intend to purge."]},{"i":"finding-relevant-messages-to-shuffle-vector-retrieval","l":"Finding relevant messages to shuffle (vector retrieval)","p":["To find the most relevant messages in the chat history, the most recent messages are converted (vectorized) into a query vector. By default, the 2 most recent messages are used. To change this, change the value of \"Query messages\". This value is also used when finding relevant content from Data Bank.","Past messages must have a relevance score of at least 25% to be included. You can change this with \"Score threshold\". The setting for score threshold is shared with Data Bank.","The 3 most relevant messages from chat history are shuffled. You can change this with \"Insert#\".","To avoid disturbing the most recent events in the chat, the 5 most recent messages are not shuffled. To change this, change the value of \"Retain#\"."]},{"i":"shuffling-messages-augmented-generation","l":"Shuffling messages (augmented generation)","p":["The messages are shuffled to one of 3 places:","The top of the chat, after the Main Prompt / Story String (the default)","The top of the chat and before the Main Prompt / Story String","The end of the chat, before the last 2 messages (\"In-chat @ Depth 2\"). Since you just sent a message, this position is usually just before the previous reply from the model.","You can change this with \"Injection Position\" and \"Depth\".","The messages are included in order of relevance, with more relevant messages shown after less relevant messages.","The name of the person or character who sent each message is included.","The messages are shown to the model as \"past events\". This assists the model to understand that the messages contain information from a different point in the chat history than the point at which they are inserted. You can change this with \"Injection Template\".","You can see the final prompt to the model using the Prompt Itemization popup, the terminal logs, or the browser console logs. The browser console logs are useful for understanding what all the steps in Chat vectorization are doing."]},{"l":"Vector summarization","p":["The Vector summarization feature is experimental.","Vector summarization does not create summaries of your chat. It does not turn the retrieved messages into summaries. It does not make your chat history shorter. It is not \"like Summarize but better\".","Vector summarization is intended to make vector search of chat messages more effective. It does this by introducing a summarizing step prior to vectorizing. The summarizing step extracts the most important parts of the message, so that the resulting vector is a better indicator of what the message relates to.","Vector summarization may make vector search less effective.","To summarize the messages in the chat history, and generate a vector for each summarized message, choose \"Summarize chat messages for vector generation\".","The summarized message does not replace the original message in chat. If a vector search matches the vector of a summarized message, the original message is retrieved from chat history and shuffled into context. The summarized versions of the messages are retained in Vector Storage, which may be of interest for debugging.","To summarize the content of the messages used to search the chat history (the last 2 messages by default), choose \"Summarize chat messages when sending\".","Each time a message is summarized for vectorising, a separate request is made to the summarizing model. You can choose which summarizing source is used with \"Summarize with\". Choosing \"Main API\" will generate the summaries using the same model and connection settings that you use for generating chat or text completions.","The request consists of the raw message content and an instruction about how the model should produce the summary. You can change the instruction with \"Summary Prompt\"."]}],[{"l":"Dynamic Audio","p":["This guide will walk you through setting up and customizing dynamic audio assets for your SillyTavern experience."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Dynamic Audio\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"i":"dynamic-audio-setup-browser","l":"Dynamic Audio Setup (Browser)","p":["Connect to the Assets Repository:","Launch SillyTavern and navigate to Extensions> Assets.","Click on the \"Connect\" button to establish a connection to the official assets repository.","Download the desired audio assets, such as background music (BGM) or ambient sounds, that correspond to the backgrounds you intend to use.","Enable Dynamic Audio Extension:","In SillyTavern, go to Extensions> Dynamic Audio.","Enable the extension, unmute and adjust the volume of BGM and ambient sounds to your preference.","When bgm end another one will play randomly, click on loop button to keep current bgm playing","Click on roll button to pick another bgm randomly","Expression based BGM:","Enable expression BGM switch if you want bgm to follow character expression (require bgm in character folder see below).","Adjust the cooldown timer (in seconds) between BGM updates. Increase it if you find the BGM changes too frequently in group chats or when using character-specific BGM with emotion detection."]},{"l":"Importing Music for Characters","p":["To set up custom music for your characters' emotions, follow these steps:","Navigate to Character Folder:","Go to the characters folder, e.g., \\SillyTavern\\data\\user-handle\\characters\\Seraphina.","Create BGM Folder:","Inside the character folder, create a subfolder named bgm.","Import Emotion Music:","Within the bgm folder, import the music files for each emotion. Supported audio extensions include .mp3, .ogg, and .wav.","Naming convention: [emotion]_[number].mp3, e.g., anger_0.mp3, joy_0.mp3.","Multiple Tracks for Emotions:","You can import multiple tracks for the same emotion by incrementing the number, e.g., neutral_1.mp3, neutral_2.mp3.","Default Music Selection:","When no emotion is detected, a random neutral track will play as the default. Emotions are detected similarly to updating sprites; refer to the expression images documentation for details."]},{"l":"Changing Default BGM Music","p":["If a character doesn't have custom BGM in their folder, a default track will play. Here's how you can change it:","Navigate to BGM Folder:","Go to the following folder: \\SillyTavern\\data\\user-handle\\assets\\bgm.","Replace/Add Music:","Replace or add music files (.mp3, .ogg, .wav) to this folder.","These are the official audio assets downloaded using the assets extension.","One of these tracks will play randomly when no character-specific BGM is found (solo or group chat)."]},{"l":"Changing Ambient Sounds","p":["Ambient sounds add depth to your scenes. Here's how you can customize them:","Navigate to Ambient Folder:","Go to the following folder: \\SillyTavern\\data\\user-handle\\assets\\ambient.","File Naming Convention:","Ambient audio filenames correspond to background image filenames, replacing spaces with dashes.","Example: bedroom-clean.mp3 corresponds to the \"bedroom clean.jpg\" background.","If the lock button is unlock the audio file corresponding to the background will play. Activating lock will keep current ambient playing.","Custom Ambients:","You can add your own ambient sounds for custom or existing backgrounds by following the same naming pattern.","Thank you for following this guide! Your SillyTavern experience is now enriched with dynamic audio."]}],[{"l":"EmulatorJS","p":["This extension allows you to play retro console games right from the SillyTavern chat."]},{"l":"Installation","p":["Prerequisites:","Latest release version of SillyTavern.","ROM files downloaded from the net. You can find them anywhere.","How to install:","Install using SillyTavern's extensions downloader.","Or use this link: https://github.com/SillyTavern/SillyTavern-EmulatorJS"]},{"l":"Usage","p":["Open the \"EmulatorJS\" extension menu.","Click \"Add ROM file\". ROMs are saved to your browser storage and not stored on a server.","Select the game file to add. Input the name and core (if it wasn't auto-detected). If the core requires a BIOS file, add it too.","Click the \"Play\" button in the list or launch via the wand menu.","You can customize controls and other settings in the emulator frame after launching the game.","Use save/load state functions if you need to take a break.","Check the EmulatorJS docs to see the list of available cores and their requirements: Systems."]},{"l":"Comments mode","p":["With the power of multimodal models such as GPT-4 Vision, your AI bots can see your gameplay and provide witty in-character comments."]},{"l":"Requirements","p":["A browser that supports ImageCapture. Tested on desktop Chrome. Firefox requires to enable it with config. Safari won't work.","Chat Completion API with image inlining mode is recommended. Requires OpenAI or OpenRouter API key with \"gpt-4-turbo\" or \"gpt-4o\" as the selected model; Google AI Studio with Gemini 1.5 Pro or Gemini 1.5 Flash model; Anthropic Claude (Opus 3 or Sonnet 3.5 models recommended). Check the API documentation of the chosen to see if the chosen model supports multimodal prompts.","If image inlining is disabled, make sure that the \"Image Captioning\" extension is enabled, then select the \"Multimodal\" captioning source:","OpenAI, Claude, MistralAI, Google AI Studio with access with any vision-supported model.","OpenRouter API with a compatible multimodal model.","Locally hosted Llava model in Ollama, KoboldCpp, oobabooga TextGen WebUI or vLLM."]},{"l":"How to enable comments","p":["Make sure you set the interval of providing comments in the EmulatorJS extension settings. This setting defines how often the character is queried for comments using a snap of your current gameplay. A value of 0 indicates that no comments are provided.","Select a character chat and launch the game. For the best performance, make sure that the ROM file is properly named so that AI can have more background context.","Start playing as you normally would. The vision model will be queried periodically to write a comment based on the latest screenshot it \"sees\"."]},{"l":"Settings","p":["Caption template - a prompt used to describe the in-game screenshot. {{game}} and {{core}} additional macro are supported.","Comment template - a prompt used to write a comment based on the generated caption. {{game}}, {{core}}, {{caption}} additional macro are supported. For image inlining mode, {{caption}} is replaced with see included image.","Force captions - will force the use of multimodal captioning even if image inlining is supported and enabled."]},{"i":"why-im-not-seeing-any-comments","l":"Why I'm not seeing any comments?","p":["Comments are temporarily paused (interval step skipped) if:","Emulator is paused (with a pause button, not in-game).","The browser window is out of focus.","The user input area is not empty. This is to let you type your reply in peace.","Another reply generation is currently in progress.","TTS voice is being read aloud. Comment is held off (20 seconds maximum) until it finishes, but not skipped.","Other common issues:","Make sure you've set a commenting interval before launching the game.","Make sure you have set a multimodal API key and there are no errors in the ST server console.","Still doesn't work? Send us your browser debug console logs (press F12)."]},{"l":"Credits","p":["EmulatorJS engine (GPLv3): https://github.com/EmulatorJS/EmulatorJS"]}],[{"l":"Expression Images"},{"i":"what-is-it","l":"What is it?","p":["Expression images are images (aka 'sprites') of your AI character which are shown next to (or behind) the chat window.","Expression images can use a classification model running alongside SillyTavern's main application. This allows the Expressions to change automatically based on the sentiment expressed in the AI's most recent chat response."]},{"i":"setup-instructions-offline-mode-without-extras","l":"Setup Instructions (Offline Mode without Extras)","p":["Open the Extensions Panel and expand the 'Expression images' section. If you have the character chat open, you will see a grid of image placeholders. Expression Drawer","Click the 'import' button at the top left of each image in the grid, and select the image you want to apply to that emotion. This will save the image with the correct filename inside the /data/user-handle/characters/(character_name_here)/ folder.","To show the image in your SillyTavern window, click the image in the grid after it has been uploaded."]},{"i":"how-does-the-classify-module-work","l":"How does the classify module work?","p":["The classify module uses a small 'sentiment parsing' model that runs on the SillyTavern host machine (eg. on your PC, or the colab machine). This model takes the new output from the AI and detects what kind of sentiment, or emotion, the text is expressing. While multiple sentiments may be expressed in a single message, the model only picks the most likely one and returns that to the SillyTavern. The frontend plugin then displays the image that is associated with that sentiment."]},{"l":"Change Expressions Manually","p":["Click on any of the uploaded expression images (sprites) to display them near the chat interface (with default UI mode) or at the center of the screen (in Visual Novel mode).","Use the /emote (name) slash command or matching Quick Reply to set the sprite without opening the extensions menu."]},{"i":"setup-instructions-local-classification","l":"Setup Instructions (local classification)","p":["Make sure you're on the latest version of SillyTavern.","Open the extensions panel and expand the \"Character Expressions\" plugin menu.","Select \"Local\" in the classification source dropdown.","This will start a one-time download of the classification model from HuggingFace Hub (about ~ 100 Mb).","Generate any message to verify that the classification works and the sprite appears. You may also check the server console for debug logs."]},{"i":"setup-instructions-with-extras","l":"Setup Instructions (with Extras)","p":["Have Extras installed and running with the classify module enabled: python server.py --enable-modules=classify","Import the expression images the same way as mentioned above.","Select \"Extras\" in the classification source dropdown.","The appropriate expression image will display automatically whenever the AI sends you a response."]},{"i":"setup-instructions-with-llm","l":"Setup Instructions (with LLM)","p":["Connect to any of the supported and properly configured Text Generation APIs.","Import the expression images the same way as mentioned above.","Select \"LLM\" in the classification source dropdown.","Optionally, configure the classification instruction prompt.","Generate any message to verify that the classification works and the sprite appears. You may also check the server console for debug logs."]},{"i":"how-do-i-get-more-expression-options","l":"How do I get more expression options?"},{"l":"Local","p":["Local classification defaults to 28 possible image labels: Cohee/distilbert-base-uncased-go-emotions-onnx","To use the 6-option classification model, open the config.yaml file with a text editor and change the value of the classificationModel variable to Cohee/bert-base-uncased-emotion-onnx","After that, restart the ST server to redownload the model. To revert it, change the value in config.yaml again."]},{"l":"Extras API","p":["Extras API uses a classification model with 6 options by default: nateraw/bert-base-uncased-emotion","There is also a model with 28 options: joeddav/distilbert-base-uncased-go-emotions-student","To use this model you need to change your Extras command line to include the following argument (with a space before and after):","--classification-model=joeddav/distilbert-base-uncased-go-emotions-student"]},{"i":"what-image-formats-are-supported-for-expressions","l":"What image formats are supported for Expressions?","p":["Any image format is allowed, including webp and animated gifs.","The most common format is a PNG file with a transparent background."]},{"i":"using-the-default-expressions","l":"Using the 'default expressions'","p":["This feature will only activate if local classification is enabled or with Extras API connected. There is no way to manually display default expression images.","Use Default Expressions","If you don't have custom expression images for a character, you can use the built-in default expressions which are included with the base SillyTavern installation. These are simple emoji-style images. Just click the checkbox at the top of the Expression images section inside the Extension panel. Default expressions will work alongside any available custom Expressions, and will display in cases when your custom image set has any missing images for a particular emotion."]},{"l":"Importing an Expression images zip file","p":["Using the 'import ZIP' button, you can import a zip file that contains a collection of expression images, and those images will automatically be added to the correct folder for your currently selected character. The zip file must have a flat internal structure (no subfolders) and the individual images should be named correctly. Importing a zip will not automatically rename any images to make them match the emotions."]},{"l":"Limitations"},{"i":"display-names-not-character-card-filenames-dictate-which-image-set-is-used","l":"Display names (not character card filenames) dictate which image set is used","p":["If you have more than one character with the same display name, they will both use the same set of expression images.","If you want a different image set to be used for each version of the same-named character, you can use the sprites folder override."]},{"l":"How to set an override","p":["Create a folder in the /data/user-handle/characters with any name and put images there, e.g. /data/user-handle/characters/Boris.","Open the chat with the character whose sprites you'd like to override.","Enter the name of the override folder into the \"Sprite Folder Override\" input and click \"Submit\".","The Sprites list will reload and the \"Sprite set\" indicator should show the override folder.","Alternatively, you can use the /costume slash command to achieve the same result: /costume Boris.","By prepending a backslash to the override folder name, it will resolve to a subfolder in the current character sprites folder, e.g. /costume \\tracksuit for the character named Boris will resolve to the /data/user-handle/characters/Boris/tracksuit folder."]},{"l":"Custom expressions","p":["You can add your custom expression labels to the list and upload sprites for them.","However, they won't be labeled automatically by the classification model. You need to set them manually (either by clicking or the /emote command)."]}],[{"l":"Image Captioning","p":["Image Captioning allows SillyTavern to automatically generate text descriptions for images used in chats.","Use Image Captioning when you want your AI character to \"see\" and respond to visual content in your conversations.","Create captions for images you upload or paste into messages","Add context to existing images in the chat history","Use various sources for generation, including local models, cloud APIs, and crowdsourced networks","There are options that require no setup, no money, and no GPU. There are also options that require some or all of those things. Choose the one that fits your needs and resources.","The image captioning extension is built-in to SillyTavern and does not need to be installed separately."]},{"l":"Quick start","p":["Set up:","Open the Image Captioning panel in the Extensions panel","Choose a captioning source (most likely \"Local\" or \"Multimodal\")","For \"Multimodal\" ensure you've set up the connection in the API Connections tab","Generate a caption:","Choose \" Generate Caption\" from the Extensions popup menu","Select an image file when prompted","Wait for the caption to be generated","Review and send:","The captioned image will be inserted into your message","See the caption using the image tooltip","Click Send to see what your character thinks of the image!"]},{"l":"Panel controls"},{"l":"Source Selection","p":["Choose the source for image captioning. Supported options:","Source","Description","Multimodal","Cloud: OpenAI, Anthropic, Google, MistralAI, and others. Local: Ollama, llama.cpp, KoboldCpp, Text Generation WebUI, and vLLM. Supports custom prompts so you can ask your images questions.","Local","Uses transformers.js running locally inside your SillyTavern server. Zero setup!","Horde","Uses the AI Horde network, a crowdsourced distributed network of image generation models. Nothing to download, configure, or pay for. Variable response times.","Extras","The Extras project was discontinued in April 2024 and is not maintained or supported."]},{"l":"Caption Configuration","p":["Caption Prompt: Enter a custom prompt for captioning. The default prompt is \"What's in this image?\"","Ask every time: Toggle to request a custom prompt for each image caption"]},{"l":"Message Template","p":["Message Template: Customize the caption message template. Use {{caption}} macro to insert the generated caption. The default template is [{{user}} sends {{char}} a picture that contains: {{caption}}]"]},{"l":"Auto-captioning","p":["Automatically caption images: Toggle to enable automatic captioning of images pasted or attached to messages","Edit captions before saving: Toggle to allow editing captions before they are saved"]},{"l":"Captioning images","p":["All the ways to caption images in SillyTavern:","Choose \" Generate Caption\" from the Extensions popup menu and select an image file when prompted","Click the Caption icon at the top of an image already in a message","Paste an image directly into the chat input with auto-captioning enabled","Attach an image file to a message using the Embed File or Image button in the actions of a message.","Send a message with an embedded image","Use the /caption slash command"]},{"i":"auto-captioning-1","l":"Auto-Captioning","p":["The auto-captioning feature allows you to automatically generate captions for images as they are added to the chat, without manually triggering the captioning process each time.","To enable, select the \"Automatically caption images\" checkbox in the Image Captioning panel. You can also choose to edit captions before they are saved by checking the \"Edit captions before saving\" box.","Once enabled, auto-captioning will trigger in the following scenarios:","When an image is pasted directly into the chat input.","When an image file is attached to a message.","When a message with an embedded image is sent.","The system will use your selected captioning source (Local, Extras, Horde, or Multimodal) and the configured settings to generate a caption for the image."]},{"i":"editing-captions-before-saving-refine-mode","l":"Editing captions before saving (Refine Mode)","p":["If you've enabled the \"Edit captions before saving\" option:","After an image is added, a popup will appear with the generated caption.","You can review and edit the caption as needed.","Click \"OK\" to apply the caption, or \"Cancel\" to discard the caption without saving."]},{"l":"Caption sending","p":["The generated (and optionally edited) caption will be automatically inserted into the prompt using the Message Template you've configured. By default, it will be sent in this format:"]},{"i":"slash-command-caption","l":"Slash Command: /caption","p":["The extension provides a /caption slash command to use in the chatbox or in scripts."]},{"l":"Usage","p":["prompt(optional): A custom prompt for the captioning model. Only supported by multimodal sources.","quiet=true|false: If set to true, suppresses sending a captioned message to the chat. Default is false.","mesId=number: Specifies a message ID to caption an image from an existing message instead of uploading a new one.","If no mesId is provided, the command will prompt you to upload an image. When quiet is false (default), a new message with the captioned image will be sent to the chat. The generated caption can be used as input for other commands."]},{"l":"Examples","p":["Caption a new image with the default settings:","Caption a new image with a custom prompt:","Caption an image from message #5 without sending a new message:","Caption an image from message #10 with a custom prompt then generate a new image based on the caption:"]},{"l":"Local source","p":["You can change the model in config.yaml. The key is called extras.captioningModel because reasons. Enter the Hugging Face model ID you want to use. The default is Xenova/vit-gpt2-image-captioning.","You can use any model that supports image captioning ( VisionEncoderDecoderModel or \"image-to-text\" pipeline). The model needs be to compatible with the transformers.js library. That is, it needs ONNX weights. Look for models with the ONNX and image-to-text tags, or that have a folder called onnx full of .onnx files."]},{"l":"Multimodal source"},{"l":"General configuration","p":["Model: Choose the model for image captioning. Options vary based on the selected API.","Allow reverse proxy: Toggle to allow using a reverse proxy if defined and valid (OpenAI, Anthropic, Google, Mistral)","API keys and endpoint URLs for captioning sources are managed in the API Connections panel. Set the connection up in API Connections first, then select it as your captions source in Captioning.","One last time: configure the API key/address/port in API Connections and use the connection in Captioning.","You can still use Claude for chats and Google AI Studio for image captioning, or whatever. Just set them both up in the 'API Connections' tab first. Then flip your Chat Completion source to Claude and your Captioning source to Google AI Studio.","For most local backends, you will need to set some options in the model backend rather than in SillyTavern. If your backend can only run one model at a time and doesn't support automatic switching, you are unfortunately going to have a hard time using the same backend for chat and captioning with different models.","Even if you run two instances of the backend on different ports, API Connections only allows one active configuration per backend type. But what if I told you... that you can probably connect to your backend in both Text Completion and Chat Completion modes? Now you can have two connections to the same backend type."]},{"l":"Sources","p":["\"I don't want to pay anything or run anything\": Google AI Studio free tier","\"I want the best captioning possible, and I don't mind paying for it\": Anthropic","\"I want to caption images locally and have it just work\": Ollama","\"I want to complain when it doesn't work\": Extras","\"I want to keep the dream of local AI alive\": KoboldCpp","01.AI (Yi)","Anthropic","API Provider","Cloud, free tier then paid, Gemini Flash/Pro","Cloud, llama-3.2-vision in 11B/90B, LLaVA","Cloud, paid (maybe free options), many models, pick from what's available within Captioning after configuring in API connections","Cloud, paid, Claude models with vision capabilities: claude-3-5-sonnet/haiku, claude-3-opus/sonnet","Cloud, paid, GPT-4 Vision, 4-turbo, 4o, 4o-mini","Cloud, paid, pixtral-large, pixtral-12B","Cloud, paid, yi-vision","Custom (OpenAI-compatible)","Description","For custom OpenAI-compatible APIs, uses currently configured model in API Connections tab","Google AI Studio","Groq","KoboldCpp","llama.cpp","Local","Local, can switch between available models and download additional vision models within Captioning after configuring in API Connections","Local, must configure model in KoboldCpp","Local, must configure model in llama.cpp","Local, must configure model in ooba","MistralAI","Ollama","OpenAI","OpenRouter","Text Generation WebUI (oobabooga)","To use one of these caption sources, select Multimodal in the Source dropdown.","vLLM"]},{"l":"KoboldCpp","p":["For general information on installing and using KoboldCpp, see the KoboldCpp documentation.","To use KoboldCpp for multimodal captioning:","get a multimodal-capable model, trained to process text and image prompts at the same time.","also get the multimodal projections for the model. These weights allow the model to understand how the text and image parts of the input relate to each other.","load the model and projections in the KoboldCpp launch GUI or command line interface.","The original and classic local multimodal model is LLaVA. GGUF-format files for the model and projections are available from Mozilla/llava-v1.5-7b-llamafile. To load them from the command line, set the model and projections with the --model and --mmproj flags. For example:","Some LLaVA finetunes you can try: xtuner/llava-llama-3-8b-v1_1-gguf, xtuner/llava-phi-3-mini-gguf.","You can use multimodal projections for the base model that your particular finetune was built from. Projections for some common base models are available from koboldcpp/mmproj."]}],[{"l":"Image Generation","p":["Ability to view all generated images in a character gallery","Advanced ComfyUI integration for highly customizable workflows","Automatically generate images as replies to your messages for full immersion, generate from chat history and character information from the wand menu or slash commands, or use the /sd (anything_here) command in the chat input bar to make an image with your own prompt.","Character-specific prompt prefixes for tailored character images","Customizable prompt templates and prefixes for consistent style and quality","Flexible visibility options for generated images in chat","Image swipes feature to regenerate images while keeping the same prompt","Integration with AI function calling for automatic image generation detection","Interactive mode to trigger image generation based on natural language requests","Most common Stable Diffusion generation settings are customizable within the SillyTavern UI.","Options to edit prompts before generation and extend free-mode prompts","Slash commands for easy image generation within chats","Style presets to quickly switch between different image generation settings","Supports multiple image generation sources, both local and cloud-based","Use local or cloud-based Stable Diffusion, FLUX or DALL-E APIs to generate images.","Various generation modes for characters, scenes, and custom prompts"]},{"l":"Supported sources","p":["All services will be discontinued on December 31, 2024","Block Entropy","Cloud","Cloud, free of charge","Cloud, open source (AGPL3), free of charge","Cloud, open source (MIT), free of charge","Cloud, paid","Cloud, requires an active subscription","ComfyUI","Deprecated, not recommended","Draw Things","HuggingFace Serverless","Local, Mac/iOS, free of charge","Local, open source (AGPL3), free of charge","Local, open source (GPL3), free of charge, see ComfyUI Configuration.","NovelAI Diffusion","OpenAI DALL-E 2/3","Pollinations","Remarks","SD.Next / vladmandic","SillyTavern Extras","Source","Stability AI","Stable Diffusion WebUI / AUTOMATIC1111","Stable Horde","TogetherAI"]},{"l":"Generation modes","p":["-","\"Background\"","\"Me\"","\"Raw Last Message\"","\"The Last Message\"","\"The Whole Story\"","\"Your Face\"","\"Yourself\"","A chat background based on story context.","A close-up portrait of the current character.","A full-body portrait of the current character.","A portrait of the user persona.","A visual recap of the chat events.","A visual recap of the last chat message.","background","Description","face","Forces a portrait aspect ratio.","Forces a wide landscape aspect ratio.","last","Last message used as a prompt verbatim.","me","raw_last","Remarks","scene","Slash command argument","Wand menu item","you"]},{"l":"How to generate an image","p":["Use the \"Image Generation\" item in the extensions context menu (wand).","Type a /sd (argument) slash command with an argument from the Generation modes table. Anything else would trigger a \"free mode\" to make SD generate whatever you prompted. Example: /sd apple tree would generate a picture of an apple tree.","Look for a paintbrush icon in the context actions for chat messages. This will force the \"Raw Message\" mode for the selected message.","Every generation mode besides raw message and free mode will trigger a prompt generation using your currently selected main generation API to convert chat context into the SD prompt. You can configure the instruction template for generating prompts for every generation mode using the \"SD Prompt Templates\" settings drawer in the extensions panel."]},{"i":"tips-and-tricks-for-the-sd-command-usage","l":"Tips and tricks for the /sd command usage"},{"l":"View all generated images","p":["To view all saved images for a character (including other chats), open a gallery from a \"More...\" dropdown menu on a character info panel, or use a /show-gallery slash command."]},{"l":"Specify a negative prompt","p":["Use a negative named argument before the prompt to enforce a specific negative prompt for this generation."]},{"l":"Include a character-specific prefix","p":["Use a special {{charPrefix}} macro in free-prompt mode to include positive and negative prompt prefixes (if defined) for the current character."]},{"l":"Suppress a chat message","p":["You can avoid posting a generated image into the chat by passing a quiet=true named argument. The image will still be added into the character gallery, and the command will produce a relative URL to the image that can be consumed by other commands.","The example below will send the generated image using Markdown as a user persona."]},{"l":"Image swipes","p":["Images swipes allow to reroll the image generation while keeping the same prompt. If a fixed seed is set, it will be randomized for the next generation.","To cycle through images, hover a mouse cursor (tap on mobile) over a generated image to reveal arrow buttons and swipes counter. Tapping right arrow on the latest image will generate a new one.","'Swipes' here is just a name, don't try the actual swiping gesture, as this will regenerate the message itself, not the attached image."]},{"l":"Options"},{"l":"Edit prompts before generation","p":["Allow to edit the automatically generated prompts manually before sending them to the Stable Diffusion API."]},{"l":"Use function tool","p":["Uses function calling to automatically detect the intention to generate an image.","Requirements:","Must have image generation configured with a supported source.","Must use a supported Chat Completion API model and have function tool calling enabled in the AI Response settings.","The \"Use function tool\" option must be enabled in the Image Generation settings.","The user should express an intent to generate an image in the chat message, e.g. \"Send me a picture of a cat\".","The interactive mode will not trigger when the function tool is enabled."]},{"l":"Use interactive mode","p":["Allows to trigger an image generation instead of text as a reply to a user message that follows the special pattern:","Contains one of the following verbs: send, mail, imagine, generate, make, create, draw, paint, render","Followed by one of the following nouns (not further than 10 characters away): pic, picture, image, drawing, painting, photo, photograph","Followed by a target subject of image generation, could be optionally preceded by phrases like \"of a\" or \"of this\".","Examples of valid requests and captured subjects:","Can you please send me a picture of a cat=> cat","Generate a picture of the Eiffel tower=> Eiffel tower","Let's draw a painting of Mona Lisa=> Mona Lisa","Some special subjects trigger a predefined generation mode:","'you, 'yourself' => \"Yourself\"","'your face', 'your portrait', 'your selfie' => \"Your Face\"","'me', 'myself' => \"Me\"","'story', 'scenario', 'whole story' => \"The Whole Story\"","'last message' => \"The Last Message\"","'background', 'scene background', 'scene', 'scenery', 'surroundings', 'environment' => \"Background\""]},{"l":"Extend free-mode prompts","p":["When using the interactive mode of the slash command, automatically extend free-mode generation subject descriptions by prompting your main API."]},{"l":"Snap auto-adjusted resolutions","p":["Snap image generation requests with a forced aspect ratio (portraits, backgrounds) to the nearest known resolution, while trying to preserve the absolute pixel counts. Refer to the \"Resolution\" dropdown for the list of possible options.","Recommended for SDXL models."]},{"l":"Common prompt prefix","p":["Added before every generated or free-mode prompt. Commonly used for setting the overall style of the picture.","Example: best quality, anime lineart.","Pro tip: Use {prompt} macro to specify where exactly the generated prompt will be inserted."]},{"l":"Negative prompt","p":["Characteristics of the image you don't want to be present in the output.","Example: bad quality, watermark."]},{"l":"Character-specific prompt prefix","p":["Any characteristics that describe the currently selected character. Will be added after a common prefix.","Example: female, green eyes, brown hair, pink shirt.","You can also specify a negative prompt prefix for any unwanted content. It will be combined with the general negative prompt.","Limitations:","Works only in 1-to-1 chats. Will not be used in groups.","Won't be used for backgrounds and free mode generations.","If you want to share the prefixes with others, tick the \"Shareable\" checkbox. This will save them with the character data, rather than your local settings.","Pro tip: If supported by the generation source, you can also use LoRAs/embeddings here, for example: lora:DonaldDuck:1."]},{"l":"Styles","p":["Use this to quickly save and restore your favorite style/quality presets to use them later or when switching between models. The following is included in the Style preset:","Common Prompt Prefix","Negative Prompt","You can also switch between styles using the /imagine-style command (or /sd-style or /img-style)."]},{"l":"Chat Message Visibility","p":["Generated images inserted into the chat are hidden in the main API prompts by default, but this can be overriden individually per generation initiator (\"Magic wand\" icon, slash command, interactive mode). This can be used for making the experience more immersive by letting the characters \"acknowledge\" the images. Multimodal models in Chat Completions API may also 'see' the images if \"Send inline images\" is enabled.","A text message can be customized by changing the \"Chat Message Template\" under Image Prompt Templates. All regular macros can be used in this template, plus a special {{prompt}} macro to specify where the image prompt will be added."]},{"l":"ComfyUI Configuration","p":["ComfyUI is a fast and very flexible option for image generation.","If you're familiar with ComfyUI, the tl;dr is: make your workflow in ComfyUI, download it in API format, and paste it into the SillyTavern ComfyUI Workflow Editor. ST will submit your workflow to ComfyUI's API and you will get an image in your chat. But with great power comes great responsibility, and the main responsibility is inserting placeholders in your workflow JSON so you can change settings from SillyTavern.","If you're not familiar with ComfyUI, you can still use it to generate images in SillyTavern using the default workflow. Later, when you want great power, you can learn how to use ComfyUI..."]},{"l":"Controls","p":["This panel allows you to configure and manage your ComfyUI integration with SillyTavern.","Enter the URL of your ComfyUI server in the ComfyUI URL input field. The default value is http://127.0.0.1:8188. If you are using SwarmUI, the default port for the managed ComfyUI server is 7821, 20 ports higher than the default port for SwarmUI.","After entering the URL, choose Connect to validate and establish a connection. The ComfyUI server must be accessible from the SillyTavern host machine."]},{"l":"Workflow Management","p":["Select a ComfyUI workflow from the dropdown menu. Two default workflows are provided:","Default_Comfy_Workflow.json: A basic text-to-image workflow supporting the most common image generation settings.","Char_Avatar_Comfy_Workflow.json: A sample image-to-image workflow that uses the character avatar, plus the prompt, to generate an image.","Use the following buttons to manage your workflows:","Open workflow editor to view and modify the selected workflow.","Create new workflow to create a new workflow with a custom name.","Delete workflow to remove the selected workflow."]},{"l":"Workflow Editor","p":["The ComfyUI Workflow Editor allows you to view and modify ComfyUI workflows for use with SillyTavern.","The main component of the editor is a large text area where you can insert or edit your ComfyUI workflow in JSON format.","To add a ComfyUI workflow to the editor, follow these steps:","Enable 'Dev Mode' in ComfyUI settings.","Use the 'Save (API Format)' option in ComfyUI to download the JSON data.","Create a new workflow in SillyTavern and open the editor.","Paste the downloaded JSON data into the text area.","Replace specific values with placeholders as needed for your use case.","You can add the API-format JSON file directly to the data/default-user/user/workflows directory in your SillyTavern installation. This will save you from steps 3 and 4.","Retain the original JSON file. If you need to open the workflow again in ComfyUI to make changes, it is much more convenient to edit the original file than the one with all the placeholders."]},{"l":"Placeholders","p":["The editor provides a list of predefined placeholders that can be used in your workflow JSON. These placeholders are replaced with dynamic values when the workflow is executed in SillyTavern.","Placeholders marked with ✅ are present in your workflow JSON. Placeholders marked with ❌ are not present in your workflow JSON. You can add these placeholders to your workflow JSON as needed. You do not need to add all the placeholders, only the ones that your workflow uses and you want to replace dynamically."]},{"l":"Prompts","p":["The %prompt% and %negative_prompt% placeholders are used to insert the image generation prompts into the workflow. These contain the final prompts generated by SillyTavern, including the generated prompt for your chosen /sd mode, the common prompt prefix, negative prompt, and character-specific prompt prefix.","For example, you may have tested your workflow with a prompt like \"forest elf\" in ComfyUI. To use this workflow in SillyTavern, you can replace the \"forest elf\" prompt with the %prompt% placeholder:","Notice that the placeholder is wrapped in double quotes. This is important for the JSON format, and required by SillyTavern's placeholder replacement system. Even for numbers, you must use double quotes in the template JSON.","Sometimes the prompt (or other value) doesn't appear where you might expect. ComfyUI will remove nodes from the API version of the workflow if they are not necessary for the workflow to function in API mode.","For instance, this workflow uses a LoRA tag loader node with a prompt primitive so the workflow is clearer in UI mode:","Prompt primitive and LoRA loader","The prompt primitive node will be removed from the API version of the workflow, so you insert the placeholder in the LoraTagLoader node. Find the text \"apple tree\" in the workflow and replace it with the %prompt% placeholder:","In some cases you may need to make several replacements in the workflow JSON, even if the prompt appears only once in the UI."]},{"l":"Model","p":["The %model% placeholder will insert the value of the selected model in the image generation settings.","An example from the default text-to-image workflow:","To load GGUF-quantized UNets, use a UNet Loader (GGUF) node in your workflow, choose a GGUF model in the SillyTavern model dropdown, and use the %model% placeholder in the node's settings like this:","Stable Diffusion checkpoints, SD UNets, and GGUF-quantized UNets all appear in the Model dropdown. Models of one type will not work with workflows/loader nodes expecting another type. If you choose an incompatible model type in ST, ComfyUI will report a problem with the loader node."]},{"l":"Avatar images","p":["Use the %user_avatar% and %char_avatar% placeholders to include the user and character avatars in the workflow. These placeholders are replaced with the PNG data of the avatars when the workflow is executed. The image data is encoded in base64 format, so you must decode it in your workflow. A popular choice for this task is the Load image (Base64) node.","In this example, the character avatar is loaded with a Load Image (Base64) node. It also uses an Image Resize node to rescale the image to whatever size is specified in the image generation settings:","Load image from base64 string and resize","Insert the %char_avatar%, %width%, and %height% placeholders into the JSON for the Load Image (Base64) and Image Resize nodes:","To get a base64-encoded image string for testing your workflow in ComfyUI, use any online tool that converts images to base64 strings. Here's an example string you can use for initial testing: sd-comfy-base64-test-string.txt."]},{"l":"Other placeholders","p":["Most other placeholders use the values of the corresponding controls in image generation settings, or the values that you specify with the /sd command:","%vae%, but most SD models include a VAE so the default workflows do not use this placeholder. Use it with custom workflows to load a VAE alongside a UNet, override the default VAE, etc.","%sampler%","%scheduler%","%steps%","%scale%","%width%","%height%","%denoise%: for the sample image-to-image workflow, vary the denoise amount between about 0.5 (barely-noticeable changes to the source image) and 1.0 (a completely different image as if no source image was used). Not used by the default text-to-image workflow because there's no point using a value other than 1.0 for text-to-image.","%clip_skip%: not used by the default workflows but available for custom workflows.","The %seed% placeholder will insert the seed value from the control if you have specified one. If you set the seed to -1, SillyTavern will generate a new random seed for each image in %seed%."]},{"l":"Custom placeholders","p":["You can add custom placeholders to your workflow:","Look for the \"Custom\" section below the predefined placeholders.","Click the \"+\" button to add a new custom placeholder.","Enter a name for the placeholder in the find field.","Enter the value that you want to replace the placeholder with in the replace field.","Custom placeholders will appear in a separate list below the predefined ones.","For example, you could replace the \"SillyTavern\" prefix for saved image filenames in the default workflow with a custom placeholder. Add a new custom placeholder with find set to filename_prefix and replace set to ServiceTesnor. Insert the new %filename_prefix% placeholder into your workflow JSON. Now you can change the filename prefix from SillyTavern to ServiceTesnor by changing the value of the custom placeholder."]},{"l":"Comfy tricks","p":["Read all the general information on this page so you're familiar with the image generation options. Options such as switchable styles and common prompt prefixes, when combined wih the total flexibility of ComfyUI workflows, allow you to create a wide variety of image generation setups."]},{"l":"Loading LoRAs","p":["Use a LoRA tag loader node (such as Load LoRA Tag) to load any LoRAs specified in the prompt. Now you can add as many LoRAs as you like to your prompt with tags like lora:CroissantStyle:0.8, and they will be loaded into your workflow. This will also make the \"pro-tip\" of using LoRAs in character-specific prompt prefixes work with ComfyUI."]},{"l":"Setting workflow values from styles or slash-commands","p":["You can use macros in custom placeholder values. As a practical example, let's say you sometimes want to generate images without a background, and you'd like this to be switchable with a slash-command or image style. Here's how you could do it:","Make a ComfyUI workflow that removes the image background, or not, depending on the value of an input","Use a custom placeholder to set the value of that input, but use {{getvar::remove_background}} as the replace value","Now you can set the value of remove_background with /setvar key=remove_background true or /setvar key=remove_background false before generating an image","The workflow will use the value you set to determine whether to remove the background","Make an image style \"No background\" with common prompt prefix {{setvar::remove_background::true}}","Use the style control or /imagine-style No background to set the value of remove_background to true before generating an image"]}],[{"l":"Live2D","p":["This guide will walk you through the process of setting up and customizing the Live2D extension for your SillyTavern experience. This extension allows you to use Live2D animated models for your character, providing a dynamic and interactive element to your virtual character."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Branch Selection: Make sure you're using the latest version of SillyTavern to access the latest features and updates.","Extension Installation: Install the \"Live2D\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (represented by the stacked blocks icon).","Model Folder Placement: Place your Live2D model folders into the /data/user-handle/assets/live2d directory. A properly organized live2d assets folder might look like this:","Asset folder example","A Live2D model folder should include all necessary components for the Live2D model, such as expressions, motions, textures, sounds, and settings files. Notably the ***.model.json file must be at the root of the Live2D model folder for the model to be detected by the extension. In this example the shizuku live2d model folder may look like this:","Live2d model folder example","Note: Models can also be placed in character-specific folders, such as /data/user-handle/characters/Shizuku/live2d/. However, models in character folders will only be accessible for that specific character."]},{"l":"Extension Settings","p":["The Live2D extension offers various settings to customize the behavior of your animated model. Here are the key settings:","UI global settings"]},{"l":"Global Settings","p":["Enabled:","Enable this checkbox to activate the extension, allowing your Live2D model to interact within SillyTavern.","You can disable the extension if you want to use normal sprites only.","You can disable the extension when you want to move normal sprites in a group chat and enable it again when you're ready to use Live2D models.","Follow Cursor:","Enable this checkbox to make the Live2D model follow your cursor, provided that the model supports this feature.","Auto-send Interaction:","Enable this checkbox to automatically trigger character interactions when you click on areas with mapped messages (refer to the hit areas section for details)."]},{"l":"Debug Settings","p":["These settings help you control the behavior and visibility of your Live2D model for debugging purposes.","Reset Model Before Animation:","Enable this checkbox to reload the model before any animation. This forces the animation to start and allows you to spam clicks if necessary. Some models may require this to ensure that animations begin from a compatible state.","Show Model Frames:","Enable this checkbox to display the model frame, making it easier to identify where to click to drag the model around. It also shows the hit area, if available. Hovering over a hit area will show its name.","Reload button","Click this button to reload every live2d model. Use it in case something glitches."]},{"l":"Character Selection","p":["These settings allow you to manage characters and assign Live2D models to them.","Refresh Button:","Click the refresh button to update the list of characters in the current chat.","Select Character:","Use the drop-down list to choose a character to assign a Live2D model to.","Remove Button:","Click this button to delete all assigned models for a character. A confirmation prompt will appear to confirm the deletion."]},{"l":"Model Selection","p":["UI model list","Refresh Button:","Click the refresh button if your Live2D model does not appear in the list.","Select Model:","Choose a model from the list to assign it to the selected character.","The model can be located in the asset folder or the current character's folder.","The list displays the model folder name, its origin (asset or character), and the name of the detected model setting file.","Note that some model folders may contain different versions of the same model. You can try different model files to see which one works best.","Selecting none will use normal sprites if there is any","Settings are saved per character and model"]},{"l":"Model Settings","p":["UI model settings","Model Scale:","Use the slider to adjust the size of the model, making it larger or smaller.","Model Center X Offset:","Use the slider to change the horizontal position of the model relative to the window center.","Model Center Y Offset:","Use the slider to adjust the vertical position of the model relative to the window center."]},{"l":"Remarks","p":["The settings are saved and carry over different chats.","You can also drag the model with your mouse, and those settings will be updated and saved.","Use these UI settings to bring your model back on the screen if you somehow made it out of view. Also, check the \"Show frame\" checkbox to see clearly where you can click to drag the model."]},{"l":"Model Talk","p":["UI model talk","Param mouth open Y id","Select from the list the ID of the parameter corresponding to the model's mouth Y value. Not all models have one, and names may vary from model to model. Usually something like \"PARAM_MOUTH_OPEN_Y\" or \"ParamMouthOpenY\". Check the model when selecting an element from the list; it will try to run the speak animation. If the mouth moves, you got it!","Mouth movement speed","Adjust the slider to change the movement speed of the mouth animation.","Time per character","Set the time duration of each character. The duration of the talk animation will be this time multiplied by the number of characters of the message."]},{"i":"remarks-1","l":"Remarks","p":["This mouth animation does not work on every model and every animation. Even if your model has animations where the mouth moves, it does not mean the mouth animation can be controlled by this extension. If nothing shows in the parameter list, your model is probably made with a too old version of Live2D to access the parameters properly."]},{"l":"Model Animations","p":["UI model animations","Starter animation","Select an expression and motion from the lists that will play when starting a chat with the character. You can also add a delay during which the model will be invisible if you need to hide the character for some time to achieve a perfect effect.","Default animation","Select an expression and motion from the list that will play when the character sends a message. Use a fallback animation when using the classify expression extension."]},{"i":"remarks-2","l":"Remarks","p":["Animations will play when you select one in the lists.","Use the replay button to replay the selected animation.","Some models have expressions defined as motions.","If nothing shows in the lists, it's probable your model's setting file has no expressions/motions defined."]},{"l":"Hit areas mapping","p":["UI model mapping","Default click animation","Select an expression and motion from the list that will play when you click on the model. You can also set a message that will be sent as a user message.","Hit areas","If the model has hit areas, they will be listed, and you can assign an animation/message to each of them."]},{"i":"remarks-3","l":"Remarks","p":["Some models have no hit areas, but the default click is detected for all.","The default click will trigger if you click on a hit area with nothing mapped or if you click outside of any hit area.","Hit areas have priority defined in the model; for example, \"mouth\" is inside \"head.\" If it does not behave properly, it may be due to the model file.","For some models, animations need to be finished before starting another one. Use the debug checkbox if you want to force the refresh and spam animations."]},{"l":"Classified Expressions Mapping","p":["UI model classify","Requirements","Requires the use of the classify expression extension; otherwise, it will fall back to the default animation.","Mapping","For each detected emotion by the classify extension, you can assign an expression/motion animation."]},{"i":"remarks-4","l":"Remarks","p":["If the previous animation did not finish when a new message is received, it's possible that the new animation will not play. This behavior is dependent on the Live2D model. Use the debug checkbox if you want to force the animation to play.","Thank you for following this guide! Your SillyTavern experience is now enriched with animated and interactive Live2D models."]}],[{"l":"Objective"},{"i":"what-is-it","l":"What is it?","p":["The Objective extension lets the user specify an Objective for the AI to strive towards during the chat. This objective is broken down into step-by-step tasks. Tasks may be branched, where child tasks can be created automatically or manually. This gives the ability to create complex task trees. The completion status of each task in the list will be checked at certain intervals.","This differs from adding static direction through prompting in that it adds sequential and paced directives for the AI to follow without user intervention. It gives a more genuine experience of the AI autonomously striving to reach a goal."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Objective\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"l":"Common Use Cases","p":["Your imagination is the limit, you can give the AI any objective you wish and it will plan out how to achieve it. You can ask it to plan how to slay a demon, rob a temple, throw a lavish party, or even take over the world.","Objective Settings Panel"]},{"l":"Configuration","p":["The extension is found in the Extensions menu under Objective.","Type an objective into the top text box, then click on Auto-Generate Tasks. This sends a request to the connected API and asks it to provide a list of tasks which match the objective you have typed in.","Note: Clicking Auto-Generate Tasks will delete all existing tasks for the currently selected Objective before adding new ones.","Upon receiving the response from the AI, a list of tasks will be created automatically in the space below the Objective input box. Tasks can be edited after creation.","At the bottom of the panel are two boxes: Position in Chat and Task Check Frequency","Position in Chat- This is how 'deep' in the chat section of the prompt you want the current task to be inserted. The lower the number, the more attention the AI will give to the task. Setting to 0 will make the task the primary thing in the AI's mind. Setting at high values will put the task in the background and allow the AI to focus on the conversation at hand, but setting it too high may cause the AI to never 'get around' to the task at all.","Task Check Frequency- This is how often you want the AI to check if the task has been completed. If it is set to 3, the AI will be asked if the current task has been completed every 3rd message.","Objectives, tasks, and their descriptions are saved in real-time to the current chat session. Custom prompts are saved globally."]},{"l":"Custom Prompts","p":["You can customize the prompts sent to the LLM to generate tasks, check task completion, and for prompt injection. Editing prompts will save them for the current session. Custom prompts can be saved and loaded for persistence.","Click Edit Prompts to open the prompt editor window. You can edit your prompts as desired.","To save prompts, enter a name and click Save Prompt.","To load prompts, select the prompt from the dropdown list.","To delete a saved prompt, select it from the dropdown list and click Delete Prompt","WARNING: Task Checking happens in a separate API request. Setting Task Check Frequency to 1 will double your API calls to the LLM service. Be careful with this if you are using a paid service."]},{"l":"Usage","p":["By default the Objective extension will keep track of all tasks and their respective completion status automatically.","The User can also manually create, update, delete, and complete tasks at any time."]},{"l":"Current Task Selection","p":["The current task will always be the first listed incomplete task. Any manual updates to tasks will trigger a check for what the current task should be. So if you add a task above a bunch of completed tasks, it will be set as the current task. Once it's completed, previously completed tasks will be skipped and the next incomplete task will be selected as 'Current'.","When using parent/child tasks in a task tree, tasks are selected depth-first, meaning all child tasks will be selected in order first, then continue down the list of tasks for the current Objective/Task."]},{"l":"Branch Tasks","p":["Click the Branch Task button to set the current task as an Objective where you can auto generate or manually create tasks as child tasks. You can continue to turn any child task into an Objective and keep generating to your hearts content.","Marking a parent task as complete will cause the extension to skip all subtasks. When all child tasks are complete, the parent task will be marked as complete"]},{"l":"Manually Complete Tasks","p":["You can manually toggle the completion status of a task by clicking the checkbox next to it. This will set the next incomplete task to be selected."]},{"l":"Manual Task Check","p":["If you want to manually trigger the AI to check for task completion, click on the Extras Extension button (the magic wand on the right side of the chat input bar) and select Manual Task Check."]},{"l":"Manually Add Tasks","p":["When no tasks are present, an Add Task button is visible, allowing you to manually create the first task.","If other tasks are already present, click the + button to the right of any task to insert a new task after it."]},{"l":"Delete Tasks","p":["Click the red x to delete an existing task. The next incomplete task will be selected as the current task automatically.","Deleting a task with child tasks will delete all child tasks and their descendants."]},{"l":"Hiding Tasks","p":["If you want to remain unaware of what tasks the AI is attempting to complete, check the Hide Tasks box to hide the task list and make the AI's intentions a mystery. For 100% mysteriousness, do this before clicking Auto-Generate Tasks!"]}],[{"i":"retrieval-based-voice-conversion-rvc","l":"Retrieval-based Voice Conversion (RVC)","p":["This guide will walk you through using RVC, a technique that allows transferring voice features from one audio clip to another, enabling voices to speak in different tones and styles.","Ever enjoyed those famous \"Presidents Play X\" videos? They were created using RVC. With the RVC extension, you can make your SillyTavern characters speak in any voice you desire, be it anime, movie, or even your own unique voice.","RVC is NOT TTS: it's more like speech-to-speech. It takes an audio clip as its input. In the background, what RVC does is work in tandem with SillyTavern's TTS extension: it waits for TTS to generate an audio file (which TTS would've done regardless of whether you use RVC or not), then RVC will perform a second pass that takes the TTS audio file and transforms it into the cloned voice from your RVC configuration."]},{"l":"RVC Setup","p":["SillyTavern's RVC supports several API sources that perform audio conversion:","rvc-python","SillyTavern Extras(deprecated)"]},{"l":"Common prerequisites","p":["Before you begin, ensure you've met the following prerequisites."]},{"l":"ffmpeg","p":["Make sure you have ffmpeg binary in your PATH environment variable. This tool is used to convert incoming audio.","Windows:","Use the Toolbox in SillyTavern Launcher script to install ffmpeg automatically: https://github.com/SillyTavern/SillyTavern-Launcher","Or download the build here: https://www.gyan.dev/ffmpeg/builds/","How to modify PATH variable: https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/","To test whether you did things correctly, open a command prompt and run ffmpeg. It should print the ffmpeg version and info.","Linux:","Install ffmpeg using your package manager.","macOS:","Install ffmpeg using Homebrew:"]},{"l":"Make sure TTS is enabled and works","p":["RVC depends on TTS, you need to enable a TTS extension. Your TTS has to be already working properly and narrating your chats before you try to add RVC to the mix!","Please note, that:","System TTS engine does not support voice conversion at all.","Streaming TTS will wait for the audio stream to end before conversion."]},{"l":"Install the extension","p":["Install the \"RVC\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"i":"enable-rvc-in-sillytavern","l":"Enable RVC in SillyTavern*","p":["In SillyTavern, navigate to Extensions> RVC and enable it."]},{"l":"Pick the source","p":["In the extension settings, choose an RVC source to use. Then proceed to the source-specific installation instructions."]},{"l":"rvc-python Setup"},{"l":"1. Install the package","p":["Follow the installation instructions from the GitHub page: rvc-python Installation. It is recommended to follow CUDA installation instructions if you have an Nvidia GPU.","If you're experiencing problems when installing on Windows (e.g. building fairseq step fails), make sure the following software is installed on your PC:","Windows 10 SDK","Visual Studio Build Tools 2022"]},{"l":"2. Prepare the models","p":["Create a directory for storing RVC models. By default it is named rvc_models and is picked up from your current directory when starting up the server. Every model is a subfolder (its name will be visible in the UI) that should contain .pth(required) and .index(optional) files.","Read more: rvc-python Model Management"]},{"l":"3. Start the API server","p":["Start the API server by running the following command:","Arguments:","5050- sets a listening port for the server. Change if you want to host on a different port.","models_path- sets a path for models. Remove if you want to use the default rvc_models directory.","-l- sets the server to listen on all network interfaces. Remove to only listen on localhost."]},{"l":"4. Connect to the server","p":["In the RVC extension settings, set an appropriate rvc-python API URL. By default, it will be http://localhost:5050.","Check the Use CUDA checkbox if you have installed rvc-python to support CUDA acceleration.","Press \"Refresh\" to load a list of available voices."]},{"l":"5. Configure a voice map","p":["Voice map defines voice conversion settings for every character or user persona.","To set up a voice map, choose your character or persona name from the \"Character\" dropdown, then choose an RVC \"Voice\", then click Apply.","Optionally, you can also configure other related settings such as pitch correction or filtering.","If you did everything correctly, the Voice Map debug area will show something like 'Betty:MyVoice(rvpme)'."]},{"l":"SillyTavern Extras Setup"},{"l":"1. Prepare RVC Model Files","p":["In a file browser, navigate to: \\SillyTavern-extras\\data\\models\\rvc.","Create a subfolder like 'Betty' and place the .pth and .index files into it. (Hint: you can download voice files from https://voice-models.com, make sure the voice name says it's RVPME.)"]},{"l":"2. Install Requirements","p":["Install the necessary requirements using the command:"]},{"l":"3. Run SillyTavern-extras with RVC enabled","p":["Launch SillyTavern-extras with the RVC module enabled. This example invocation assumes you used Edge TTS which comes pre-installed with SillyTavern-extras:","Optionally, you may wish to run RVC on your GPU if you have a capable one, by adding --cuda to the startup command. Based on a quick test, VRAM usage was 3.4GB for narrating 50 tokens (~ 36 words), and 7.6GB for 200 tokens (~ 150 words)."]},{"l":"4. Set Up Voice Mapping","p":["Create a Voice map for RVC. Set your Character to your desired SillyTavern character name, and set Voice to the RVC folder you created at step 1, then click Apply. If you did things correctly, the Voice Map will show something like 'Betty:MyVoice(rvpme)'."]},{"l":"5. Select Pitch Extraction","p":["Choose \"rmvpe\" as the pitch extraction method.","If you have trouble with \"rmvpe\" try other methods (for example, \"harvest\" or \"torchcrepe\")."]},{"i":"6-optional-configure-rvc-to-save-your-generations-to-file","l":"6. (Optional) Configure RVC to save your generations to file","p":["If for testing or troubleshooting purposes you wish to save the generated RVC audio, add --rvc-save-file to your startup command. This will save the last generation under SillyTavern-extras/data/tmp/rvc_output.wav:"]},{"l":"Expression-Based Dynamic Voice"},{"l":"1. Configure RVC Models","p":["In your RVC model folder, have separate .pth and .index files for each classified expression (e.g., anger, fear, joy, love, sadness, surprise)."]},{"l":"2. Enable Modules","p":["Enable both RVC and classify modules:"]},{"l":"3. Use RVC Module","p":["The remaining setup is similar to using the RVC module alone (as explained above)."]},{"l":"Train Your Own RVC Model"},{"i":"using-rvc-easy-menu-by-deffcolony-windows-only","l":"Using RVC Easy Menu by Deffcolony (Windows Only)","p":["Automatically install and launch Mangio-RVC: https://github.com/deffcolony/rvc-easy-menu"]},{"l":"1. Clone Repository","p":["Clone the repository to your desired location:"]},{"i":"2-launch-rvc-launcherbat","l":"2. Launch RVC-Launcher.bat","p":["Open the RVC-Launcher.bat file.","Choose option 1 to install RVC."]},{"l":"3. Complete Installation","p":["When prompted, install required packages and dependencies."]},{"l":"4. Open WebUI for Voice Training","p":["After installation, choose option 2 to open the WebUI for voice training."]},{"i":"mangio-rvc-training-a-voice-model","l":"Mangio-RVC: Training a Voice Model","p":["1. Access Training Tab:","1. Prepare Audio:","2. Configure Experiment:","3. Process Data and Extract Features:","4. Training Parameters:","Click \"Process data\" and \"Feature extraction\".","Click \"Train feature index\" and \"Train model\".","Click on the training tab in the WebUI.","Dataset Preparation:","Ensure the audio is free of background noise – only raw voice is needed.","Enter an experiment name (e.g., my-epic-voice-model).","Longer audio makes a better output quality.","Place the audio you want to train in the datasets folder.","Set \"Save frequency\" to 50.","Set \"Total training epochs\" to 300.","Set version to v2.","WebUI Training:"]}],[{"l":"Speech Recognition","p":["This guide will walk you through setting up speech recognition to transcribe your voice into text within SillyTavern."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Speech Recognition\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon).","Have ffmpeg binary installed. See RVC setup for more details."]},{"i":"speech-recognition-setup-browser","l":"Speech Recognition Setup (Browser)","p":["Append: Your message will be appended to the current user message text area.","Auto send: Your message will automatically be sent once the end of speech is detected.","Choose the \"Message Mode\" you want:","Choose the language you want to speak (Note: not every browser supports all languages).","Configure SillyTavern:","Enable Message Mapping(Optional):","For instance, by adding \"command delete = /del2\", the \"/del2\" command will replace your voice message when \"command delete\" is detected.","If your browser doesn't support voice recognition, an error popup will appear.","Launch SillyTavern and go to Extensions> Speech Recognition.","Recording:","Replace: Your message will replace the current user message in the text area.","Select \"Browser\" from the dropdown options.","Select Language:","Select Message Mode:","Setup phrases mapping for vocal shortcuts.","To start recording, click the microphone button to the right of the message area next to the send button. Click again to stop recording. Recording may stop automatically if no voice is detected.","Useful when combined with auto send mode for full voice control. Enable this by checking \"Enable messages mapping\"."]},{"i":"speech-recognition-setup-whispervosk","l":"Speech Recognition Setup (Whisper/Vosk)","p":["Enable Provider:","Enable the desired speech recognition provider on the extras server using the following command:","or","You can also use a custom model by adding the option --stt-vosk-model-path or --stt-whisper-model-path with the path to the model.","Configure SillyTavern:","Launch SillyTavern and go to Extensions> Speech Recognition.","Select \"Vosk\" or \"Whisper\" from the dropdown options (whisper is more accurate).","The settings are similar to the \"Browser\" provider setup (except for language) see above."]},{"i":"speech-recognition-setup-streaming","l":"Speech Recognition Setup (Streaming)","p":["Enable Provider:","Enable the streaming speech recognition module on Sillytavern-extras with the following command:","Configure SillyTavern:","(Optional) Specify a custom Whisper model as in the Whisper setup above.","(Optional but recommended) Set up trigger words in SillyTavern. Only messages starting with these trigger words will be sent to SillyTavern as actual messages. This prevents random speech or noise from being transcribed. Enable this with the checkbox. The trigger words can be included/excluded from the actual message using a checkbox.","Other settings are similar to other providers.","You're now ready to transcribe your voice into text using speech recognition in SillyTavern."]}],[{"l":"Summarize"},{"i":"what-is-it","l":"What is it?","p":["This extension allows you to create, store, and utilize automatically generated summaries based on the events happening in your chats. Summarization can help with outlining general details of what is happening in the story, which could be interpreted as a long-term memory, but take that statement with a grain of salt. Since the summaries are generated by language models, the outputs may lose some important details or contain hallucinations, so you're always advised to keep track of the summary state and correct it manually if needed."]},{"l":"Common configuration","p":["The summarization extension is installed in SillyTavern by default, thus it will show up in ST's Extensions panel (stacked cubes icon) list like this:","Summarize Config Panel","Current summary- displays and provides an ability to modify the current summary. The summary is updated and embedded into the chat file's metadata for the message that was the last in context when the summary was generated. Deleting or editing a message from the chat that has a summary attached to it, will revert the state to the last valid summary.","Restore Previous- removes the current summary, rolling it back to the previous state. This is useful if the summarizer does a poor job at any given point.","Pause- check this to prevent the summary from being automatically updated. This is useful if you want to provide a custom summary of your own or to effectively disable the summary by clearing the box and stopping updates.","Popup window- allows to detach the summary into a movable UI panel on the sidebar. Useful for the desktop layout to easily have access to summarization settings without having to navigate through the extensions menu.","Injection Template- defines how the summary will be wrapped when being inserted into regular chat prompts. A special {{summary}} macro should be used to denote the exact location of the current summary state in the prompt injection text.","Injection Position- sets the location of the prompt injection. The options are the same as for Author's Notes: before or after the main prompt, or in-chat at designated depth."]},{"l":"Supported summary sources"},{"l":"Main API","p":["Summarization will be powered by your currently selected AI backend, model and settings. This method requires no additional setup, just a working API connection.","This option has the following sub-modes that differ depending on how the summary prompt is built:","Raw, blocking. The summary will be generated using nothing but the summarization prompt and the chat history. Subsequent prompts will also include the previous summary with messages that were sent after the summary was generated (see example). This mode can (and will) generate prompts that have a lot of variability between them, so it is not recommended to use it with backends that have slow prompt processing times, such as llama.cpp and its derivatives.","Raw, non-blocking. Same as above, but the chat generation will not be blocked during the summary generation. Not every backend supports simultaneous requests, so switch to blocking mode if summarization fails.","Classic, blocking. The summarization prompt will be sent at the end of your usual generation prompt, as a neutral system instruction, not omitting the character card, main prompt, example dialogues and other parts of chat prompts. This usually results in prompts that play nicely with reusing processed prompts, so it is recommended to use with llama.cpp and its siblings."]},{"l":"Summary Settings explained","p":["Summary Prompt- defines the prompt that will used for creating a summary. May include any of the known macros, as well as a special {{words}} macro (see below).","Target summary length (words)- defines the value of the {{words}} macro that can be inserted into the Summary Prompt. This setting is completely optional and has no effect at all if the macro is not used.","API response length (tokens)- allows to set an override API response length for generating summaries that are different from the globally set value.","Max messages per request (raw modes only)- set to limit the maximum number of messages that will be included in one summarization prompt. 0 means no explicit limitation, but the resulting number of messages to summarize will still depend on the maximum context size, calculated using the formula: max summary buffer = context size - summarization prompt - previous summary - response length. Use this when you want to get more focused summaries on models with large context sizes.","No WI/AN- omit World Info and Author's Note from text to be summarized. Only has an effect when using the Classic prompt builder. The Raw prompt builder always omits WI/AN.","Update every X messages- sets the interval at which the summary is generated. 0 means that the automatic summarization is disabled, but you can still trigger it manually by clicking the \"Summarize now\" button. This should be adjusted based on how quickly the prompt buffer entirely fills with chat messages. Ideally, you'd want to have the first summary generated when the messages are starting to get dropped out of the prompt.","Update every X words- same as above, but using words (not tokens!) instead of messages, theoretically can be a more accurate measurement due to how unpredictable the contents of chat messages usually are, but your mileage may vary.","If both \"Update every\" sliders are set to a non-zero value, then both will trigger summary updates at their respective intervals, depending on what happens first. It is strongly advised to update these values accordingly when you switch to another model that has differing context sizes, otherwise, the summary generation may trigger too often, or never at all.","If you're unsure about the interval settings, you can click the \"magic wand\" button above the \"Update every\" sliders to try and guess the optimal values based on some simple heuristics. A brief description of the algorithm is as follows:","Calculate token and word counts for all chat messages","Determine target summary length based on desired prompt words","Calculate the maximum number of messages that can fit in the prompt based on the average message length","If \"Max messages\" is set, adjust the average to account for messages that don't fit the summary limit","Round down the adjusted average messages per prompt to a multiple of 5"]},{"l":"Example prompts","p":["Raw prompt","Classic prompt"]},{"l":"Extras API","p":["Extras server with the summarize module could run an auxiliary summarization model (BART).","It has a very small context size (~ 1024 tokens), so its ability to handle large summaries is quite limited.","To configure the Extras summary source, do the following:","Install or Update Extras to the latest version.","Run Extras with the summarize module enabled: python server.py --enable-modules=summarize"]},{"l":"Changing Summary Model","p":["By default, Summarize uses the Qiliang/bart-large-cnn-samsum-ChatGPT_v3 model for summarization purposes.","This can be changed by using the command line argument --summarization-model=(###Hugging-Face-Model-URL-Here###)","A known alternate Summarize model is Qiliang/bart-large-cnn-samsum-ElectrifAi_v10."]}],[{"l":"TTS","p":["SillyTavern has a wide range of TTS options. This page explains the setup and use."]},{"i":"what-is-it","l":"What is it?","p":["TTS is used to have a voice narrate parts of your chat."]},{"l":"Configuring TTS"},{"l":"TTS Provider Selectbox","p":["Used to select which TTS service you want to use.","ElevenLabs- paid subscription required, highest quality voices available at present.","Silero- free, runs on your PC, quality can vary widely","System- uses your OS TTS engine, if one exists. Quality can vary widely depending on the OS.","Edge- free, runs via Azure, generally quite fast, and voices feel natural but dry and emotionless. Like listening to the evening news or a radio announcer. When running with \"Plugin\" selected as the provider, you also need to install this server plugin, otherwise the TTS won't work.","Coqui-TTS- free, No API Implementation at this time. High-performance Text2Speech models (Tacotron, Tacotron2, Glow-TTS, SpeedySpeech) as well as Bark.","Novel- requires a paid NovelAI subscription, generated by NovelAI's TTS engine","RVC- free, voice cloning"]},{"l":"Checkboxes","p":["\"Good evening, senpai\"","\"Good evening, senpai\", she says.","\"nya\"... \"Good evening, senpai\"","Auto Generation- lets TTS start playing automatically when a new message enters the chat","Cohee approaches you with a faint \"nya\" \"Good evening, senpai\", she says.","Disabled","Enabled","Enabled- turns TTS playback on/off","Given the example text: *Cohee approaches you with a faint nya* Good evening, senpai, she says. Here's a table showing how the text will be modified based on the boolean states of Ignore *text, even \"quotes\", inside asterisks* and Only narrate \"quotes\":","having both \"only narrate quotes\" and \"ignore asterisks\" checkboxes both checked will result in the TTS only reading \"quotes\" which are not in asterisks, and ignoring everything else.","Ignore *text, even \"quotes\", inside asterisks*","Ignore *text, even \"quotes\", inside asterisks*- TTS will not play any text within *asterisks*, even \"quotes\" (internal variable name = narrate_dialogues_only)","Narrate only the translated text- this will make the TTS only narrate the translated text.","Only narrate \"quotes\"","Only narrate \"quotes\"- Limits TTS playback to only include text within quotation marks. This will *include quotes within asterisk lines*(internal variable name = narrate_quoted_only)","Output"]},{"l":"Sliders","p":["These will change depending on the API you select.","(explanation coming soon)"]},{"l":"Buttons","p":["Apply- this must be clicked after setting a TTS API and after editing the voice map.","Available voices- loads a popup with all voices available for your selected API, and lets you preview them with sample dialogues."]},{"l":"Using TTS","p":["Click the \"Enable\" checkbox, or nothing will ever happen.","Click the \"Auto-generation\" checkbox if you want the TTS to start automatically every time a new message arrives in chat.","Optionally, click the megaphone icon inside the top-right of any message to playback on demand.","Click the lower right \"Stop\" button (found inside the wand menu) to stop any playback."]},{"l":"Voice Map","p":["You must provide a voice map for the TTS to use, otherwise, it won't know what voices should be used for each character.","These must be in the exact format stated below:","CharacterName:TTSVoice,CharacterName2:TTSVoice2","For Coqui-TTS the format needs to include the speaker and language from the WebGUI:","CharacterName:TTSVoice[speakerid][langid] or Aqua:tts_models--multilingual--multi-dataset--your_tts\\model_file.pth[2][1]"]},{"l":"Bark ZeroShot Voice Cloning Speakers","p":["If using Bark you must create a voice folder with a voice file to clone. Ensure you add voices to homedir\\tts\\bark_v0\\speakers. On Windows it is probably C:\\Users\\USERACCOUNT\\AppData\\Local\\tts\\bark_v0\\speakers\\ type %appdata% in windows explorer then go UP a directory to local and you should see tts.","The directory should look like this:","homedir","tts","bark_v0","speakers","customvoice1","speaker.wav","speaker.npz","robinwilliams","speaker.mp3","me","One first load of this model and voice bark will clone the voice and create a .npz file, this is needed for faster TTS."]}],[{"l":"AllTalk TTS V2","p":["AllTalk is a voice cloning system based on Coqui XTTS, F5-TTS, VITS, Piper and other TTS model engines, designed to produce high-quality voice reproduction (either zero shot voice cloning or built-in voices). In AllTalk V2, significant updates enhance functionality and ease of use, including multiple TTS engine support, expanded customization, and performance optimizations. For a comprehensive list of features, refer to the AllTalk Wiki here."]},{"i":"key-features-in-alltalk-v2","l":"\uD83D\uDFE9 Key Features in AllTalk V2","p":["Multi-engine Support: Easily switch between Coqui XTTS, VITS, Piper, Parler, F5, and custom engines.","Voice Conversion (RVC): Enhanced retrieval-based voice cloning pipeline.","Customizable Settings: Adjust per-engine settings and save startup configurations.","Narrator Functionality: Specify separate voices for narration and characters.","Standalone and Integrated Use: Seamless integration with SillyTavern.","DeepSpeed and Low VRAM Modes: Performance optimization for resource-limited environments.","Screenshots: See AllTalk V2’s interface here."]},{"i":"setup-and-installation-options","l":"\uD83D\uDFE8 Setup and Installation Options","p":["AllTalk offers both standalone and integrated installation methods. The fastest setup involves using one of the quick installation options provided, with scripts automating most of the process.","Standalone Installation: Recommended for most users ( Standalone Guide)","Text-generation-webui Integration: For integration into Text-generation-webui ( TGWUI Installation Guide)"]},{"i":"manual-installation","l":"\uD83D\uDFE9 Manual Installation","p":["For advanced users requiring detailed control, follow the Manual Installation Guide for a step-by-step setup on Windows, Linux, or Mac (untested)."]},{"i":"google-colab-installation","l":"\uD83D\uDFE9 Google Colab Installation","p":["Run AllTalk in a cloud environment with the Google Colab Installation for users who prefer not to install locally."]},{"i":"using-alltalk-within-sillytavern","l":"\uD83D\uDFE8 Using AllTalk within SillyTavern","p":["Once AllTalk is loaded, select it within SillyTavern on the TTS page, ensuring to select the correct AllTalk server version in the settings.","Settings Management: AllTalk may enable or disable specific settings based on your selected configuration.","Loading Sequence: If SillyTavern is loaded before AllTalk, reload the TTS extensions page.","Performance Optimization: Enable DeepSpeed and Low VRAM modes selectively to improve performance based on system resources.","Narrator function: Details of the Narrator function can be found on the AllTalk Wiki.","Full details of the SillyTavern AllTalk Extension will be updated on the AllTalk Wiki page for SillyTavern","TGWUI Users who user the AllTalk extension for TGWUI need to disable Enable TGWUI TTS in the TGWUI chat interface, otherwise you will have duplicate TTS audio generated."]},{"i":"troubleshooting","l":"\uD83D\uDFE8 Troubleshooting","p":["If you experience issues that you believe are specific to AllTalk within SillyTavern, please refer to the AllTalk Wiki page for SillyTavern for the lastest information."]},{"i":"support-assistance-and-feature-requests","l":"\uD83D\uDFEA Support, Assistance, and Feature Requests","p":["For further assistance:","Refer to the Wiki and built-in documentation.","Join discussions on the Discussion Board.","Submit bugs or feature requests through the Issue Tracker."]}],[{"l":"XTTS with voice cloning","p":["Greetings! So, you've been blown away by those Reddit posts showcasing how far the technology went for the AI text-to-speech?","Feeling excited to give your robotic waifu/husbando a new shiny voice modulator?","Fear not, this stunning groundbreaking technology is already available at your local SillyTavern, you just need a simple..."]},{"l":"Prerequisites","p":["Latest version of SillyTavern.","Miniconda installed.","(Windows) Visual C++ Build Tools installed.","WAV files with voice clips to clone from (~ 10 seconds per file). File requirements: PCM, Mono, 22050Hz, 16-bit (convert via Audacity).","Create a folder with \"speakers\" and \"output\" subfolders. Put WAV files into \"speakers\".","Example folder structure:"]},{"l":"Installing","p":["daswer123 made an API server that runs the XTTSv2 model on your computer and connects to SillyTavern's TTS extension.","It's completely independent of Extras API and would use a separate environment.","Very important: Don't install the following requirements to your Extras environment or system Python. It will break your other packages, do unnecessary downgrades, etc.","The following instruction is provided using Miniconda, but you can also do it with venv (not covered here). Open the Anaconda command prompt and follow the instructions line by line."]},{"l":"Getting the server up and running","p":["Navigate to the folder you've created at step 4 of prerequisites.","Create a new conda env. From now on, we'll call it xtts.","Activate a newly created env.","Install Python 3.10 to your env. Confirm with \"y\" when prompted.","Install the XTTS server with its requirements.","Install PyTorch. This can take some time. The following line installs PyTorch with GPU acceleration support (CUDA). If you want to use just the CPU inference, drop the last part that starts with --index-url.","Start the XTTS server on the default host and port: http://localhost:8020","During your first startup, the model will be downloaded (about ~ 2 GB). Don't forget to read the legal notice from Coqui AI very carefully. Lol, I'm kidding, just hit \"y\" again."]},{"l":"Connecting to SillyTavern","p":["Open the extensions panel, expand the TTS menu, and pick \"XTTSv2\" in the provider list.","Choose your text-to-speech language in the Language dropdown (I'll be sad if it's not Polish).","Verify that the provider endpoint points to http://localhost:8020 and \"Available voices\" shows a list of your voice samples.","Pick any character and set a mapping between the voice sample and the character. If the characters list is empty, hit \"Reload\" a couple of times.","Configure the rest of the TTS settings according to your preferences."]},{"i":"youre-all-set-now","l":"You're all set now!","p":["Click on the bullhorn icon in the context actions menu for any message and hear the beautiful cloned voice emanating from your speakers. The generation takes some time and it's not real-time even on high-end RTX GPUs."]},{"i":"streaming","l":"Streaming?","p":["It's possible to use HTTP streaming with the latest version of the XTTS server to get the chunks of generated audio as soon as it is available!"]},{"i":"this-doesnt-work-with-rvc","l":"This doesn't work with RVC!","p":["The audio will still be generated (assuming you're using the latest version of the RVC extension) and converted, but not streamed as RVC requires to have the full audio file before initiating the conversion. Streamed RVC is still being investigated..."]},{"i":"how-to-get-streaming-support","l":"How to get streaming support?","p":["Update SillyTavern to the latest version.","Update the XTTS server to the latest version.","Start and connect XTTS to ST as usual.","Enable the \"Streaming\" XTTS extension setting in SillyTavern."]},{"i":"choppy-audio","l":"Choppy audio?","p":["Try increasing the \"chunk size\" setting.","For reference: with a chunk size of 200, RTX 3090 can produce uninterrupted audio at the cost of slightly increased audio latency."]},{"i":"how-to-restart-the-tts-server","l":"How to restart the TTS server?","p":["Just do steps 1, 3 and 7 from the installation instruction."]},{"i":"android","l":"Android??","p":["Unlikely, it can't run apps that require PyTorch without some arcane black magic that we don't provide support for. You can try it out at your own risk, but no support will be provided if you face any problems.","Your best solution is to host the TTS API on your PC over the local network, just don't forget to specify the host and port to listen on - see README."]}],[{"l":"VRM","p":["This guide will walk you through the process of setting up and customizing the VRM extension for your SillyTavern experience. This extension allows you to use VRM animated models for your character, providing a dynamic and interactive element to your virtual character."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Branch Selection: Make sure you're using the latest version branch of SillyTavern to access the latest features and updates.","Extension Installation: Install the \"VRM\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (represented by the stacked blocks icon).","Model Folder Placement: Place your VRM model files (.vrm) into the /data/user-handle/assets/vrm/model directory and your animation files into the /data/user-handle/assets/vrm/animation directory. The currently supported animation file format are .fbx and .bvh that are compatible with VRM models. This include any animation you can get from Mixamo ( https://www.mixamo.com/) and any animation you can export from tools like XR Animator ( https://github.com/ButzYung/SystemAnimatorOnline)."]},{"l":"Extension Settings","p":["The VRM extension offers various settings to customize the behavior of your animated model. Here are the key settings:","UI global settings"]},{"l":"Global Settings","p":["Enabled:","Enable this checkbox to activate the extension, allowing your VRM model to interact within SillyTavern.","You can disable the extension if you want to use normal sprites only.","Look at camera:","Enable this checkbox to make the VRM model eyes look at the camera.","Blink:","Enable this checkbox to make the VRM model eyes blink at random intervals. Model expressions should define properly blinking weight property otherwize model can blink with closed eyes for example, if that happens either:","correct the model if you have the .vroid file","don't use that incorrect face experession","disable blinking completly with this checkbox","TTS Lip sync","Enable this checkbox to have the VRM mouth movement follow the sound of your TTS when it's played. Only work with TTS whose sound is played by Sillytavern itself like XTTS (not in streaming mode). If disabled, mouth will be animated according to the message text length when a new character message is received.","Auto-send Interaction:","Enable this checkbox to automatically trigger character interactions when you click on areas with mapped messages (refer to the hit areas section for details)."]},{"l":"Performances Settings","p":["Body hitboxes","Enable this checkbox to activate detection of click on several part of the VRM model depending on the model the following area can be detected: head/chest/hands/groin/butt/legs/feets. Hitboxes location are computed at each frames and follow the body animation, disabling this option can improve performance.","Use model cache","Enable this checkbox to keep in memory VRM model when switching models, allows to switch back to previous model faster. Usefull if you use different model for the same character to change outfit or form for example. Can affect performance.","Use animation cache","Enable this checkboxx to keep in memory all animations played during the session. All animation assigned to a model will also be loaded the first time the model appear. Will increase the time you load the model the first time but make all animation switch instant. Can affect performance."]},{"l":"Debug Settings","p":["Show grid","Enable this checkbox to visualize the 3d grid, model dragging box and body hitboxes.","Reload button","Click this button to reload the 3d scene, clear the cache and all VRM models. Use it if some bug occurs or if cache starts to hit performance."]},{"l":"Scene Settings","p":["UI scene settings","Light Color","Set the color of the light in the 3d scene. Click on the reset button to set it back to the default white color. Depending on your browser you can use a color picker, for example you can color pick the color of your background image to add more immersion.","Light intensity","Set the light intensity in percent using the slider. Click on the reset button to set it back to the default value of 100%. VRM model can react differently to light depending on the baked shaders into the model, play with the value and see how it goes.","UI model settings"]},{"l":"Character Selection","p":["These settings allow you to manage characters and assign VRM models to them.","Refresh Button:","Click the refresh button to update the list of characters in the current chat.","Select Character:","Use the drop-down list to choose a character to assign a VRM model to.","Remove Button:","Click this button to delete the assigned model for a character."]},{"l":"Model Selection","p":["Refresh Button:","Click the refresh button if your VRM model does not appear in the list.","Select Model:","Choose a model from the list to assign it to the selected character.","The model has to be located in /data/user-handle/assets/vrm/model directory.","Reset button","Click this button to reset the model settings to its default. If you have animation files that correspond to the default value they will be auto mapped. See the naming mapping at the end of this README."]},{"l":"Model Settings","p":["Model Scale:","Use the slider to adjust the size of the model, making it larger or smaller.","Model Center X/Y Offset:","Use those sliders to change the horizontal/vertical position of the model relative to the window center.","Model X/Y Rotation","Use those sliders to change the horizontal/vertical rotation of the model relative to the model hips."]},{"l":"Remarks","p":["UI hitboxes settings"]},{"l":"Hitboxes mapping","p":["UI classify settings"]},{"l":"Classified Expressions Mapping","p":["Requirements","Requires the use of the classify expression extension; otherwise, it will fallback to the default animation.","Mapping","For each detected emotion by the classify extension, you can assign an expression/motion/message. The message can contain commands."]},{"l":"Commands","p":["\"/vrmmotion idle\" or \"/vrmmotion character=Seraphina motion=idle loop=true random=false\"","/vrmexpression","/vrmlightcolor","/vrmlightintensity","/vrmmodel","/vrmmotion","arguments: character, expression","arguments: character, model","arguments: character, motion, loop, random","arguments: color","arguments: intensity","assign the vrm model to the character","change the animation of the model","change the expression of the model","example: \"/vrmexpression happy\" in solo chat or \"/vrmexpression character=Seraphina expression=happy\" in group chat","example: \"/vrmlightcolor white\" or \"/vrmlightcolor purple\".","example: \"/vrmlightintensity 0\" or \"/vrmlightintensity 100","example: \"/vrmmodel Seraphina.vrm\" in solo chat or \"/vrmmodel character=Seraphina model=Seraphina.vrm\" in group chat","set the light color","set the light intensity in percent"]},{"l":"Animations default mapping","p":["If your animation file are named in the following way they will be mapped automatically when reseting a model settings. For example the files named \"assets/vrm/animation/neutral.bvh\" and \"assets/vrm/animation/neutral1.fbx\" will be automatically mapped as a group for default and neutral classified animation. Same goes for the hitboxes.","Thank you for following this guide! Your SillyTavern experience is now enriched with animated and interactive 3D models."]},{"i":"remarks-1","l":"Remarks"}],[{"l":"Web Search","p":["Adds web search results to LLM prompts."]},{"l":"Available sources"},{"l":"Selenium Plugin","p":["Requires an official server plugin to be installed and enabled.","See SillyTavern-WebSearch-Selenium for more details.","Supports Google and DuckDuckGo engines."]},{"l":"Extras API","p":["Requires a websearch module and Chrome/Firefox web browser installed on the host machine.","Supports Google and DuckDuckGo engines."]},{"l":"SerpApi","p":["Requires SerpApi key and provides access to Google search.","Get the key here: https://serpapi.com/dashboard"]},{"l":"SearXNG","p":["Requires a SearXNG instance URL (either private or public). Uses HTML format for search results.","Learn more: https://docs.searxng.org/"]},{"l":"Tavily AI","p":["Requires an API key. Get the key here: https://app.tavily.com/"]},{"l":"KoboldCpp","p":["KoboldCpp URL must be provided in Text Completion API settings. KoboldCpp version must be >= 1.81.1 and WebSearch module must be enabled on startup: enable Network => Enable WebSearch in the GUI launcher or add --websearch to the command line.","See: https://github.com/LostRuins/koboldcpp/releases/tag/v1.81.1"]},{"l":"How to use","p":["Make sure you use the latest version of SillyTavern.","Install the extension via the \"Download Extensions & Assets\" menu in SillyTavern.","Open the \"Web Search\" extension settings, set your API key or connect to Extras, and enable the extension.","The web search results will be added to the prompt organically as you chat. Only user messages trigger the search.","To include search results more organically, wrap search queries with single backticks: Tell me about the `latest Ryan Gosling movie`. will produce a search query latest Ryan Gosling movie.","Optionally, configure the settings to your liking."]},{"l":"Settings"},{"l":"General","p":["Enabled - toggles the extension on and off.","Sources = sets the search results source.","Cache Lifetime - how long (in seconds) the search results are cached for your prompt. Default = one week."]},{"l":"Prompt Settings","p":["Prompt Budget - sets the maximum capacity of the inserted text (in characters of text, NOT tokens). Rule of thumb: 1 token ~ 3-4 characters, adjust according to your model's context limits. Default = 1500 characters.","Insertion Template - how the result gets inserted into the prompt. Supports the usual macro + special macro: {{query}} for search query and {{text}} for search results.","Injection Position - where the result goes in the prompt. The same options as for the Author's Note: as in-chat injection or before/after system prompt."]},{"l":"Search Activation","p":["Use function tool - uses function calling to activate search or scrape web pages. Must use a supported Chat Completion API and be enabled in the AI Response settings. Disables all other activation methods when engaged.","Use Backticks - enables search activation using words encased in single backticks.","Use Trigger Phrases - enables search activation using trigger phrases.","Regular expressions - provide a JS-flavored regex to match the user message. If the regex matches, the search with a given query will be triggered. Search query supports `` and $1-syntax to reference the matched group. Example: /what is happening in (.*)/i regex for search query news in $1 will match a message containing what is happening in New York and trigger the search with the query news in New York.","Trigger Phrases - add phrases that will trigger the search, one by one. It can be anywhere in the message, and the query starts from the trigger word and spans to \"Max Words\" total. To exclude a specific message from processing, it must start with a period, e.g. .What do you think?. Priority of triggers: first by order in the textbox, then the first one in the user message.","Max Words - how many words are included in the search query (including the trigger phrase). Google has a limit of about 32 words per prompt. Default = 10 words."]},{"l":"Page Scraping","p":["Visit Links - text will be extracted from the visited search result pages and saved to a file attachment.","Visit Count - how many links will be visited and parsed for text.","Visit Domain Blacklist - site domains to be excluded from visiting. One per line.","File Header - file header template, inserted at the start of the text file, has an additional {{query}} macro.","Block Header - link block template, inserted with the parsed content of every link. Use {{link}} macro for page URL and {{text}} for page content.","Save Target - where to save the results of scraping. Possible options: trigger message attachments, or chat attachments of Data Bank."]},{"l":"More info","p":["Search results from the latest query will stay included in the prompt until the next valid query is found. If you want to ask additional questions without accidentally triggering the search, start your message with a period.","Web Search function tool always overrides other triggers if enabled and available.","Priority of triggers (if multiple are enabled):","Backticks.","Regular expressions.","Trigger phrases.","To discard all previous queries from processing, start the user message with an exclamation mark, for example, a user message !Now let's talk about... will discard this and every message above it.","This extension also provides a /websearch slash command to use in STscript. More info here: STscript Language Reference"]},{"i":"what-can-be-included-in-the-search-result","l":"What can be included in the search result?"},{"i":"serpapi-1","l":"SerpApi","p":["Answer box. Direct answer to the question.","Knowledge graph. Encyclopedic knowledge about the topic.","Page snippets (max 10). Relevant extracts from the web pages.","Relevant questions (max 10). Questions and answers to similar topics."]},{"l":"Selenium Plugin and Extras API","p":["Google - answer box, knowledge graph, page snippets.","DuckDuckGo - page snippets."]},{"i":"searxng-1","l":"SearXNG","p":["Infobox.","Page snippets."]},{"i":"tavily-ai-1","l":"Tavily AI","p":["Answer.","Page contents."]},{"i":"koboldcpp-1","l":"KoboldCpp","p":["Page titles.","Page snippets."]}],[{"l":"Extras","p":["The Extras project was discontinued in April 2024 and won't receive any new updates or modules. The vast majority of modules are available natively in the main SillyTavern application. You may still install and use it but don't expect to get immediate support if you face any issues."]}],[{"l":"Running Extras in Colab","p":["The Extras project was discontinued in April 2024 and won't receive any new updates or modules. The vast majority of modules are available natively in the main SillyTavern application. You may still install and use it but don't expect to get immediate support if you face any issues."]},{"l":"Instructions","p":["API key will appear in the colab's console output, for example: Your API key is fee2f3f559","Click \"Connect\"","Click the Start button on the left (looks like a triangle 'play' button)","Copy the API URL link that is listed under that line. ( DO NOT copy the 'localhost' URL, use the other one)","If you have enabled the secure option, paste the generated API key into the API Key box.","If you have NOT enabled the secure option, make sure the API Key box is completely empty when using the official colab.","It will start with the text Running on","Look for the trycloudflare.com link at the bottom of the output. Ignore the localhost link, it won't work (we tried!).","Navigate to SillyTavern's Extensions menu (click the 'stacked blocks' icon at the top of the page).","Not required, but recommended: select the secure option to generate the API key to protect your shared instance.","Open the Official Extras Colab","Paste the API URL into the box at the top. ( NOT the API Key box)","Select the desired \"Extra\" options","select use_cpu to run Extras without requiring GPU credit","Start SillyTavern with extensions support: (set enableExtensions to true in your config.yaml if necessary)","this will make Stable Diffusion slower, but everything else will run normally","Wait for it to finish loading everything"]}],[{"l":"Extras Installation","p":["This page contains instructions for installing SillyTavern Extras on your local device.","The Extras project was discontinued in April 2024 and won't receive any new updates or modules. The vast majority of modules are available natively in the main SillyTavern application. You may still install and use it but don't expect to get immediate support if you face any issues.","Local installation of Extras can be difficult or impossible on your OS (especially Termux)."]},{"l":"Use the Official Extras Colab","p":["Simple to setup","Free to use","No Colab GPU credits required (use the use_cpu options)","See the Colab Guide Page for details."]},{"l":"Installation Methods"},{"i":"miniconda-recommended","l":"MiniConda (recommended)","p":["(Chads who installed SillyTavern with git to begin with can skip this step!)","(Important!) Read how to use Conda","Activate the new environment","After you have both of them installed...","cd SillyTavern-extras","Clone the Extras GitHub repo","conda activate extras(you should see (extras) pop up on the left side of your command prompt)","conda create -n extras","conda install python=3.11 git","Create a new Conda environment (let's call it extras):","git clone https://github.com/SillyTavern/SillyTavern-extras","Install Extras' requirements by using one of the following commands (will take time, again):","Install git","Install Miniconda","Install the required system packages (this will take some time)","Navigate to your cloned Extras repo","pip install -r requirements-coqui.txt- for Coqui TTS (not recommended)","pip install -r requirements-rvc.txt- for real-time voice cloning","pip install -r requirements.txt- for basic features","See below 'Running Extras After Install'","See the Common Problems page if you get errors at this step!","This method is recommended because Conda makes a 'virtual environment' for the Extras requirement packages to live inside, so they do not affect your system-wide Python setup.","Type/paste the commands below ONE BY ONE IN THE CONDA COMMAND PROMPT WINDOW and hit Enter after each one."]},{"l":"System-Wide Installation","p":["This is easier, but will affect your system-wide Python installation.","This can cause conflicts if you work with many Python programs that have different requirements.","If this is your first time touching anything Python-related, that should not be a problem.","Install Python 3.11: https://www.python.org/downloads/release/python-3115/","Install git: https://git-scm.com/downloads","Open a command prompt window and go to a folder in which you have complete access permissions.","Clone the repo: git clone https://github.com/SillyTavern/SillyTavern-extras, hit Enter.","After the clone has finished, type cd SillyTavern-extras, hit Enter.","Type python -m pip install -r requirements.txt","See below 'Running Extras After Install'"]},{"l":"Running Extras After Install"},{"l":"Confirm extensions are enabled","p":["Open the file called config.yaml in a text editor. The file is located in ST's base install folder.","Look for the line that reads enableExtensions.","Make sure that line has true, and not false."]},{"l":"Decide which module to use","p":["(This only needs to be done once)","Below is a table that describes each module.","caption","chromadb","classify","Coqui TTS","coqui-tts","Decide which modules you want to add to your Python command line.","Description","edge-tts","Example: python server.py --enable-modules=caption,summarize,classify","Extras is always started with a Python command line.","Image captioning","Microsoft Edge TTS client","Name","NOTE: There must be no spaces at all in your Python command's module list!","python server.py is the bare minimum, but it does not enable any useful modules.","Real-time voice cloning","rvc","sd","Silero TTS server","silero-tts","Stable Diffusion image generation","summarize","Text sentiment classification","Text summarization","They will be used in the next step.","This would enable Image Captioning, Chat Summary, and live updating Character Expressions.","to enable modules you must use the --enable-modules= modifier, with a comma-separated list of module names","Vector storage server"]},{"l":"Start Extras Server","p":["While still in your command prompt window inside the Extras installation folder...","Make sure your conda environment is active (if you used the Conda install method)","Type activate extras if the environment is not active.","Type python server.py --enable-modules=YOUR,SELECTED,MODULE,LIST,HERE","The extras server will load.","After a while it will show you a URL at the end. For local installs, this defaults to http://localhost:5100.","Copy the API URL."]},{"l":"Connect ST to the Extras server","p":["Start your SillyTavern server, and view the SillyTavern interface in your browser.","Open the Extensions panel (via the 'Stacked Blocks' icon at the top of the page)","Paste the API URL into the input box.","Click Connect.","To run Extras again, simply activate the environment and run these commands in a command prompt.","conda activate extras, Hit Enter. python server.py, Hit Enter.","Be sure to the additional options for server.py (see below) that your setup requires."]},{"l":"Make a .bat File for Easy Startup","p":["This is Optional and only applies to Windows, but something similar should be possible on MacOS.","View your Windows Desktop","Right-click, select New, and then click Text Document","A new file will appear on your Desktop, asking for a name.","Name the file STExtras.txt","Open the newly created file in a text editor.","Paste the following code into it:","Replace the placeholder folder path with your actual Extras install folder path.","Replace the python command line with your actual command line","Save the file with a new name STExtras.bat(Use File>> Save As in most text editors)","You can now simply double-click on this .bat file to easily start Extras.","If you ever want to change the module list (or any other command line modifiers for the extras server), simply edit the python command inside the .bat file."]}],[{"l":"Extras Install Common Problems","p":["This page lists common questions and problems encountered while installing SillyTavern Extras.","Local installation of Extras can be difficult or impossible on your OS (especially Termux)."]},{"l":"Use the Official Extras Colab","p":["Simple to setup","Free to use","No Colab GPU credits required (use the use_cpu options)","See the Colab Guide Page for details."]},{"i":"error-could-not-import-the-talkinghead-module-on-linux","l":"Error: Could not import the 'talkinghead' module on Linux","p":["It requires the installation of an additional package because it's not installed automatically due to incompatibility with Colab. Run this after you install other requirements:","pip install wxpython"]},{"i":"extras-server-cant-connect-to-automatic1111s-stable-diffusion-web-ui","l":"Extras server can't connect to AUTOMATIC1111's Stable Diffusion Web UI","p":["Could not connect to remote SD backend at http://127.0.0.1:7860! Disabling SD module...","Make sure webui-user.bat that you start Stable Diffusion with contains --api command line option in the COMMANDLINE_ARGS variable.","Find and replace that line in your \"webui-user.bat\": set COMMANDLINE_ARGS=--api","How it shoud look","If the API mode is disabled for SD Web UI, the Extras server won't be able to make a connection and you won't be able to generate images!"]},{"i":"still-doesnt-work","l":"Still doesn't work?","p":["Ensure that you start everything in the proper order, waiting for every program to finish loading before proceeding to the next step:","Stable Diffusion Web UI","SillyTavern Extras","SillyTavern","The extras server can't reconnect to the Stable Diffusion API if it was loaded after."]},{"l":"hnswlib wheel building error when installing ChromaDB","p":["ERROR: Could not build wheels for hnswlib, which is required to install pyproject.toml-based projects","Before installing the ChromaDB module you must first do one of the following:","Install Visual C++ build tools: https://visualstudio.microsoft.com/visual-cpp-build-tools/","Install the hnswlib package with conda: conda install -c conda-forge hnswlib"]},{"l":"Error when installing Python requirements on Mac","p":["ERROR: No matching distribution found for torch== 2.0.0+cu117","Mac does not support CUDA, so torch packages should be installed without CUDA support.","Install the requirements using the requirements-silicon.txt file instead."]},{"i":"missing-modules","l":"Missing modules?","p":["You must specify a list of module names in your Python command line, with the --enable-modules modifier.","See Modules section."]},{"i":"what-is-the-api-key-box-for","l":"What is the API Key box for?","p":["The API Key box in SillyTavern's Extensions panel is only used when you have:","created a text file named api_key.txt in your Extras install folder, which contains your chosen Extras 'password'.","started extras with the --secure commandline argument.","This makes the Extras API 'password locked', so only users who have that key in their API Key box can access it.","This is mainly useful for people who want to make their own public deployment of Extras (colab, etc).","Users running Extras on their own PC for personal use should not type anything into the API Key box."]},{"i":"what-about-mobile-android-termux","l":"What about mobile/Android/Termux? \uD83E\uDD14","p":["There are some folks in the community having success running Extras on their phones via Ubuntu on Termux.","However, Extras were not made with mobile support in mind.","No support will be provided for people running Extras on their Android devices.","Direct all your questions to the creator of the guide linked below instead."]},{"i":"this-is-unsupported","l":"❗ This is UNSUPPORTED","p":["https://rentry.org/STAI-Termux#downloading-and-running-tai-extras"]}],[{"l":"Smart Context"},{"i":"this-extension-is-no-longer-maintained-and-not-recommended-to-use-consider-chat-vectorization-as-a-possible-alternative","l":"THIS EXTENSION IS NO LONGER MAINTAINED AND NOT RECOMMENDED TO USE. CONSIDER CHAT VECTORIZATION AS A POSSIBLE ALTERNATIVE.","p":["The use of this extension does not guarantee a better chatting experience or improved memory of any sort. Only use if you understand all the implications of vector database utilization."]},{"i":"what-is-it","l":"What is it?","p":["Smart Context is a SillyTavern extension that uses the ChromaDB library to give your AI characters access to information that exists outside the normal chat history context limit."]},{"i":"how-is-that-useful","l":"How is that useful?","p":["If you have a very long chat, the majority of the contents are outside the usual context window and thus unavailable to the AI when it comes to writing a response.","Smart Context automatically takes the entire history of the chat file and puts it into a vector database. This database is then searched each time you input something new into the chat, and if messages with matching keywords are found, those chat messages are placed into the context so the AI can see them when writing its next reply."]},{"l":"Setup Instructions","p":["Update SillyTavern to at least version 1.10.6.","Install the \"Smart Context\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon).","Install or Update Extras to the latest version. Alternatively, use the Colab notebook.","Local installs only: Install requirements-complete.txt for Extras (even if you did it once before in a prior install).","Run Extras with the chromadb module enabled: python server.py --enable-modules=chromadb"]},{"i":"getting-an-error-when-installing-chromadb","l":"Getting an error when installing ChromaDB?","p":["Installing chromadb package requires one of the following:","Have Visual C++ build tools installed: https://visualstudio.microsoft.com/visual-cpp-build-tools/","Installing hnswlib from conda: conda install -c conda-forge hnswlib"]},{"l":"Configuration","p":["Once Smart Context is enabled, you should configure it in the SillyTavern UI. Smart Context configuration can be done from within the Extensions menu STExtensionMenuIcon","Smart Context Config Panel","There are 4 main concepts to be aware of:","Chat History Preservation","Memory Injection Amount","Individual Memory Length","Injection Strategy"]},{"l":"SmartContext only starts after 10 mesages are in the chat history","p":["At the start of a new chat, ChromaDB is inactive.","Once the chat has accumulated 10 messages, it will begin recording all messages into the database, and recalling messages as needed."]},{"i":"chat-history-preservation-kept-mesages","l":"Chat History Preservation ('kept mesages')","p":["By default, ChromaDB will keep as many recent natural chat history messages as specified in the slider. Any messages beyond this amount will be removed from your sent prompt, and if 'memories' exist in the database they will be added in place of the older chat history messages (see Strategy below)."]},{"l":"Memory Injection Amount","p":["The maximum number of 'memories' Smart Context will insert into the context. Not every injection attempt will get this full amount. If you send an input related to 'dogs' and only one other message in the DB is related to dogs, then only 1 item will be inserted."]},{"l":"Individual Memory Length","p":["This is the maximum length allowed for each injected 'memory'. This is in CHARACTERS(not tokens). If set too small, the memory could be cut off midway.","Example:","Ross: I like dogs with long fur and fluffy tails. I dislike dogs with short fur and short tails.","This database 'memory' is 103 characters long, so you would need to set the slider to at least 103 in order to pull it entirely into the context.","If the slider is less than 103, the message would be cut off and injected like that."]},{"l":"Injection Strategy"},{"l":"Replace oldest history","p":["This strategy keeps X recent messages, removes all message before that, and replaces them with 'memories'.","Advantage","less likely to overflow your context limit","memories existing near the top of the context will have less immediate impact on the response while still providing 'background information'.","Disadvantage","old messages are inserted directly into the chat history with no special demarcation, and usually have no immediate natural relevance to the preserved natural chat history messages. This can confuse less intelligent AI models."]},{"l":"Add to Bottom","p":["This strategy leaves the chat history in its natural state and adds 'memories' after it inside a formatted [bracket header]. This means the 'kept messages' sliders is effectively disabled.","Advantage","does not shorten or alter the current natural chat history","'memories' exist after chat and have a stronger impact on the next AI response","Disadvantage","because no chat items are being removed/replaced, there is a higher chance you will overflow your context limit.","because the memories exist very close to the end of the prompt they can have TOO MUCH effect on the AI's response."]},{"l":"Custom Depth","p":["This strategy leaves the chat history in its natural state and adds 'memories' at the depth you determine within the template you specify. This means the 'kept messages' slider is effectively disabled. The custom injection message should include the `` template word which is where all queried memories will be placed.","Advantage","flexibility to experiment with memory placement","customizable introductions to memory within context","Disadvantage","because no chat items are being removed/replaced, there is a higher chance you will overflow your context limit."]},{"i":"use--strategy","l":"Use % Strategy","p":["Note: This is not compatible with the 'Add to Bottom' strategy, which does not remove any messages at all.","While using the 'Replace Oldest History' strategy, checking this box will enable the slider for selecting a percentage of the in-context chat history to replace with SmartContext memories. It will also disable the two sliders for manually selecting the number of messages.","This strategy automatically calculates a percentage of the chat history to be replaced with SmartContext memories, instead of a fixed number of messages.","Advantage","easier than manually calculating the number of messages yourself","adjusts with the available context size, applying the same percentage to small and large prompt spaces","Disadvantage","calculations for how much history to remove can be slightly innacurate as they are based on estimated tokens per message","it rounds the number of messages to remove to the nearest number divisible by 5 (0, 5, 10, 15, 20, etc), so it is not as fine grained as manual numeric selection."]},{"l":"Memory Recall Strategy"},{"l":"Recall only from this chat","p":["This is the default behavior of smart-context and pulls 'memories' only from the ChromaDB collection for this specific chat."]},{"l":"Recall from all character chats","p":["This is an experimental behavior of smart-context which pulls 'memories' from all ChromaDB collections for the selected character. Hypothetically this should allow for the development of a more robust memory set spanning many interactions. Reccomended that this be used with 'Add to Bottom' or 'Custom Depth' strategies and 'kept messages' set to a low number so that ChromaDB will pull from memory sooner."]},{"l":"Using Smart Context","p":["Once it is enabled and configured, Smart Context happens automatically.","ChromaDB makes a new database for each chat that is opened inside SillyTavern. This database is automatically filled with the entire chat history.","You can also manually insert text files into the database.","These text files do not have to be chats. They can be anything (wikipedia entries, fanfic, etc)."]},{"l":"Purging the Database","p":["You can use the 'Purge DB' button to clear the database for the current chat.","This can be helpful if you find inaccurate memories have been stored (such as chat message you have since deleted or edited)."]},{"l":"FAQ"},{"i":"what-happens-to-the-databases-when-im-done-chatting-can-i-save-them","l":"What happens to the databases when I'm done chatting? Can I save them?","p":["For locally installed Extras servers, Smart Context saves the databases. There is no need to save them manually in usual use cases.","For colab users, the databases are wiped when the extras server shuts down. Use the export button to save the database as a JSON file, and import it next time you want to use it.","Usually there is no need to save Smart Context databases.","Currently we have an Import/Export feature, which allows you to save the chat's DB and use it again at a later date."]},{"i":"can-i-make-one-big-database-for-all-of-my-chats-to-reference","l":"Can I make one big database for all of my chats to reference?","p":["This would not be a good use of Smart Context's capabilities. We recommend using World Info for this purpose."]}],[{"l":"talkinghead"},{"i":"what-is-it","l":"What is it?","p":["An implementation of Talking Head Anime 3 Demo for AITuber. It possesses the following features:","Generates random Live 2D-like motion actions from a single static image.","Lip-syncs to the sound output from any TTS output.","This extension contains the original demo programs for the Talking Head(?) Anime from a Single Image 3: Now the Body Too project. As the name implies, the project allows you to animate anime characters, and you only need a single image of that character to do so. There are two demo programs:","The manual_poser lets you manipulate a character's facial expression, head rotation, body rotation, and chest expansion due to breathing through a graphical user interface, so you can save them as default expressions IE Happy, sad, joy, etc. ifacialmocap_puppeteer lets you transfer your facial motion to an anime character."]},{"l":"Hardware Requirements","p":["You can use either CPU or GPU Modes (CPU is default). However, in CPU mode expect about 1 FPS, and in GPU mode on an RTX3060 I am getting about 9-10 FPS.","The ifacialmocap_puppeteer requires an iOS device that is capable of computing blend shape parameters from a video feed. This means that the device must be able to run iOS 11.0 or higher and must have a TrueDepth front-facing camera. (See this page for more info.) In other words, if you have the iPhone X or something better, you should be all set."]},{"l":"How to use","p":["You must launch extras with the following modules for talkinghead to work: classify and talkinghead! classify is required for the handling of the talkinghead.png file. Additionally, you may also use --talkinghead-gpu to load the blend models into GPU memory and make the animations 10x faster. It is highly recommended to use GPU acceleration! By default, once the program starts it will load a default image SillyTavern-extras\\talkinghead\\tha3\\images\\lambda_00.png. You can verify it is working by going to http://localhost:5100/api/talkinghead/result_feed or YOUR EXT URL:PORT/api/talkinghead/result_feed.","Once the server has started go to the Extension API tab and connect. Then simply select a character card to load. (--enable-modules=classify,talkinghead --talkinghead-gpu when starting server.py)","Now select the Character Expressions, if you check the image type talkinghead box the script will replace your current character expression with the result of YOUR EXT URL:PORT/api/talkinghead/result_feed unchecking the box SHOULD return the image back to the original expression, however sometimes you have to send a new message to the chat to \"reload\" the image.","If you do not have a talkinghead.png file in the character directory it will simply show either the default image or the last character card that had a talkinghead.png file. The animation source image is changed when the character card is changed.","Now open the character expressions scroll down to the talkinghead image and upload an image file that meets the requirements in the section below called \"Constraints on Input Images\".","Then check and uncheck the talkinghead box to reload the character. If the image is funny looking it is probably because it is not transparent / has no alpha layer. Otherwise, follow the instructions and template below."]},{"l":"Constraints on Input Images","p":["In order for the system to work well, the input image must obey the following constraints:","It should be of resolution 512 x 512. (If the program receives an input image of any other size, it will resize the image to this resolution and also output at this resolution.) It must have an alpha channel. It must contain only one humanoid character. The character should be standing upright and facing forward. The character's hands should be below and far from the head. The head of the character should roughly be contained in the 128 x 128 box in the middle of the top half of the image. The alpha channels of all pixels that do not belong to the character (i.e., background pixels) must be 0.","Input Constraints"]},{"l":"ADVANCED SECTION"},{"l":"Python Environment","p":["In addition to the base feature (app.py), both manual_poser and ifacialmocap_puppeteer are available as desktop applications. To run them, you need to set up an environment for running programs written in the Python language. The environment needs to have the following software packages:","Python >= 3.8","PyTorch >= 1.11.0 with CUDA support","SciPY >= 1.7.3","wxPython >= 4.1.1","Matplotlib >= 3.5.1","One way to do so is to install Anaconda and run the following commands in your shell:","conda create -n talking-head-anime-3-demo python=3.8 conda activate talking-head-anime-3-demo conda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorch conda install scipy pip install wxpython conda install matplotlib"]},{"l":"Additional Blend Models","p":["There is only one (lightest) model included, if you want the additional blend models you need to download the model files from https://www.dropbox.com/s/y7b8jl4n2euv8xe/talking-head-anime-3-models.zip?dl=0 and unzip it to the SillyTavern-extras\\talkinghead\\tha3\\models folder. In the end, the data folder should look like:","tha3","models","separable_float","editor.pt","eyebrow_decomposer.pt","eyebrow_morphing_combiner.pt","face_morpher.pt","two_algo_face_body_rotator.pt","separable_half","editor.pt:","standard_float","standard_half","The model files are distributed with the Creative Commons Attribution 4.0 International License, which means that you can use them for commercial purposes. However, Pramook Khungurn. Talking Head(?) Anime from a Single Image 3: Now the Body Too. https://github.com/pkhungurn/talking-head-anime-3-demo, is the creator."]},{"l":"Running the manual_poser Desktop Application","p":["Open a shell. Change your working directory to the repository's root directory. Then, run:","python tha3/app/manual_poser.py Note that before running the command above, you might have to activate the Python environment that contains the required packages.","conda activate extras if you have not already activated the environment."]}],[{"l":"Development and Automation","p":["SillyTavern's default package only provides a barebones platform that can be extended in a multitude of ways.","STscript","STscript is a powerful scripting language based on batched chat commands that can be approached without any prior coding knowledge.","Function Calling","Add more dynamic capabilities by letting the LLM use external sources of data or trigger specific functionality of the extension.","UI Extensions","UI extensions run in a browser environment and expand the functionality of SillyTavern by hooking into its events and API.","Server Plugins","Server plugins allow adding functionality such as new API endpoints by running code in the NodeJS environment.","Internationalization (i18n)","Learn how to translate SillTavern's UI into your language."]}],[{"l":"STscript Language Reference"},{"i":"what-is-stscript","l":"What is STscript?","p":["It's a simple yet powerful scripting language that could be used to expand the functionality of SillyTavern without serious coding, allowing you to:","Create mini-games or speed run challenges","Build AI-powered chat insights","Unleash your creativity and share with others","STscript is built using the slash commands engine, utilizing command batching, data piping, macros, and variables. These concepts are going to be described in the following document."]},{"l":"Security precaution","p":["With great power comes great responsibility. Be careful and always inspect the scripts before executing them."]},{"i":"hello-world","l":"Hello, World!","p":["To run your first script, open any SillyTavern chat and type the following into the chat input bar:","Hello World","You should see the message in the toast on top of the screen. Now let's break it down bit by bit.","A script is a batch of commands, each one starting with the slash, with or without named and unnamed arguments, and terminated with the command separator character: |.","Commands are executed sequentially, one after another, and transfer data between each other.","The /pass command accepts a constant value of \"Hello, World!\" as an unnamed argument and writes it to the pipe.","The /echo command receives the value through the pipe from the previous command and displays it as a toast notification.","Hint: To see a list of all available commands, type /help slash into the chat.","As constant unnamed arguments and pipes are interchangeable, we could rewrite this script simply as:"]},{"l":"User input","p":["Now let's add a little bit of interactivity to the script. We will accept the input value from the user and display it in the notification.","The /input command is used to display an input box with the prompt specified in the unnamed argument and then writes the output to the pipe.","Because /echo already has an unnamed argument that sets the template for the output, we use the {{pipe}} macro to specify a place where the pipe value will be rendered.","Slim Shady Input","Slim Shady Output"]},{"i":"other-inputoutput-commands","l":"Other input/output commands","p":["/popup (text)— shows a blocking popup, supports lite HTML formatting, e.g: /popup font color=redI'm red!/font.","/setinput (text)— replaces the contents of the user input bar with the provided text.","/speak voice=name (text)— narrates the text using the selected TTS engine and the character name from the voice map, e.g. /speak name=Donald Duck Quack!.","/buttons labels=[a,b] (text)— shows a blocking popup with the specified text and button labels. labels must be a JSON-serialized array of strings or a variable name containing such an array. Returns the clicked button label into the pipe or empty string if canceled. The text supports lite HTML formatting."]},{"i":"arguments-for-popup-and-input","l":"Arguments for /popup and /input","p":["/popup and /input support the following additional named arguments:","large=on/off- increases the vertical size of the popup. Default: off.","wide=on/off- increases the horizontal size of the popup. Default: off.","okButton=string- adds ability to customize the text on the \"Ok\" button. Default: Ok.","rows=number- (only for /input) increases the size of the input control. Default: 1.","Example:"]},{"i":"arguments-for-echo","l":"Arguments for /echo","p":["/echo supports the following values for the additional severity argument that sets the style of the displayed message.","warning","error","info(default)","success","Example:"]},{"l":"Variables","p":["/addglobalvar key=name or {{addglobalvar::name:increment}}— adds the increment to the value of the global variable.","/addvar key=name increment or {{addvar::name::increment}}— adds the increment to the value of the local variable.","/decglobalvar name or {{decglobalvar::name}}— decrements a value of the global variable by 1.","/decvar name or {{decvar::name}}— decrements a value of the local variable by 1.","/flushglobalvar name— deletes the value of the global variable.","/flushvar name— deletes the value of the local variable.","/getglobalvar name or {{getglobalvar::name}}— gets the value of the global variable.","/getvar name or {{getvar::name}}— gets the value of the local variable.","/incglobalvar name or {{incglobalvar::name}}— increments a value of the global variable by 1.","/incvar name or {{incvar::name}}— increments a value of the local variable by 1.","/setglobalvar key=name or {{setglobalvar::name::value}}— sets the value of the global variable.","/setvar key=name value or {{setvar::name::value}}— sets the value of the local variable.","All slash commands for variable manipulation write the resulting value into the pipe for the next command to use.","For macros, only the \"get\", \"inc\", and \"dec\" type macro returns the value, \"add\" and \"set\" are replaced with an empty string instead.","Global variables — saved to the settings.json and exist everywhere across the app.","If a command argument accepts a variable name and both local and global variables exist with the same name, then the local variable takes priority.","Increment in the /addvar command performs an addition or subtraction of the value if both increment and the variable value can be converted to a number, or otherwise does the string concatenation.","Local variables — saved to the metadata of the current chat, and unique to it.","Now, let's consider the following example:","Since the variables are saved and not flushed between the script executions, you can reference the variable in other scripts and via macros, and it will resolve to the same value as during the execution of the example script. To guarantee that the value will be discarded, add the /flushvar command to the script.","The default value of previously undefined variables is an empty string or a zero of it is first used in the /addvar, /incvar, /decvar command.","The getvar command is used to retrieve the value of the variable and pass it through the pipe.","The getvar macro is used to display the value in the /echo command.","The value is passed to the /imagine command (provided by the Image Generation plugin) to be used as its input prompt.","The value of the user input is saved in the local variable named SDinput.","Variables are used to store and manipulate data in scripts, using either commands or macros. The variables could be one of the following types:"]},{"l":"Arrays and objects","p":["Variable values can contain JSON-serialized arrays or key-value pairs (objects).","Examples:","Array: [apple,banana,orange]","Object: {fruits:[apple,banana,orange]}","The following modifications can be applied to commands to work with these variables:","/len commands gets a number of items in the array.","index=number/string named argument can be added /getvar or /setvar and their global counterparts to get or set sub-values by either a zero-based index for arrays or a string key for objects.","If a numeric index is used on a nonexistent variable, the variable will be created as an empty array [].","If a string index is used on a nonexistent variable, the variable will be created as an empty object {}.","/addvar and /addglobalvar commands support pushing a new value to array-typed variables."]},{"i":"flow-control---conditionals","l":"Flow control - conditionals","p":["You can use the /if command to create conditional expressions that branch the execution based on the defined rules.","/if left=valueA right=valueB rule=comparison else=(command on false) (command on true)","Let's review the following example:","This script evaluates the user input against a required value and displays different messages, depending on the input value."]},{"i":"arguments-for-if","l":"Arguments for /if","p":["left is the first operand. Let's call it A.","right is the second operand. Let's call it B.","rule is the operation to be applied to the operands.","else is the optional string of subcommands to be executed if the result of boolean comparison is false.","Unnamed argument is the subcommand to be executed if the result of boolean comparison is true.","The operand values are evaluated in the following order:","Numeric literals","Local variable names","Global variable names","String literals","String values of named arguments could be escaped with quotes to allow multi-word strings. Quotes are then discarded."]},{"l":"Boolean operations","p":["Supported rules for boolean comparison are the following. An operation applied to the operands results in either a true or false value.","eq(equals) => A = B","neq(not equals) => A != B","lt(less than) => A < B","gt(greater than) => A > B","lte(less than or equals) => A <= B","gte(greater than or equals) => A >= B","not(unary negation) => !A","in(includes substring) => A includes B, case insensitive","nin(not includes substring) => A not includes B, case insensitive"]},{"l":"Subcommands","p":["A subcommand is a string containing a list of slash commands to execute.","To use command batching in subcommands, the command separator character should be escaped (see below).","Since macro values are executed when the conditional is entered, not when the subcommand is executed, a macro could be additionally escaped to delay their evaluation to the subcommand execution time.","The result of the subcommands execution is piped to the command after /if.","The /abort command interrupts the script execution when encountered.","/if commands can be used as a ternary operator. The following example will pass a \"true\" string to the next command the variable a equals 5, and a \"false\" string otherwise."]},{"l":"Escape Sequences"},{"l":"Macros","p":["Escaping of macros works just like before. However, with closures, you will need to escape macros a lot less often than before. Either escape the two opening curly braces, or both the opening and closing pair."]},{"l":"Pipes","p":["Pipes don't need to be escaped in closures (when used as command separators). Everywhere where you want to use a literal pipe character instead of a command separator, you need to escape it.","With the parser flag STRICT_ESCAPING you don't need to escape pipes in quoted values."]},{"l":"Quotes","p":["To use a literal quote-character inside a quoted value, the character must be escaped."]},{"l":"Spaces","p":["To use space in the value of a named argument, you either have to surround the value in quote, or escape the space character."]},{"l":"Closure Delimiters","p":["If you want to use the character combinations used to mark the beginning or end of a closure, you have to escape the sequence with a single backslash."]},{"l":"Pipe Breakers","p":["To prevent the previous command's output from being automatically injected as the unnamed argument into the next command, put double pipes between the two commands."]},{"l":"Closures","p":["Closures (block statements, lambdas, anonymous functions, whatever you want to call them) are a series of commands wrapped between {: and :}, that are only evaluated once that part of the code is executed."]},{"l":"Sub-Commands","p":["Closures make using sub-commands a lot easier and get rid of the need to escape pipes and macros."]},{"l":"Scopes","p":["Closures have their own scope and support scoped variables. Scoped variables are declared with /let, their values set and retrieved with /var. Another way to get a scoped variable is the {{var::}} macro.","Within a closure, you have access to all variables declared within that same closure or in one of its ancestors. You don't have access to variables declared in a closure's descendants. If a variable is declared with the same name as a variable that was declared in one of the closure's ancestors, you don't have access to the ancestor variable in this closure and its descendants."]},{"l":"Named Closures","p":["Closures can be assigned to variables (only scoped variables) to be called at a later point or to be used as sub-commands.","/: can also be used to execute Quick Replies, as it is just a shorthand for /run."]},{"l":"Closure Arguments","p":["Named closures can take named arguments, just like slash commands. The arguments can have default values."]},{"l":"Closures and Piped Arguments","p":["The piped value from a parent closure will not be automatically injected into the first command of a child closure. You can still explicitly reference the parent's piped value with {{pipe}}, but if you leave the unnamed argument of the first command inside a closure blank, the value will not be automatically injected."]},{"l":"Immediately Executed Closures","p":["Closures can be immediately executed, meaning they will be replaced with their return value. This is helpful in places where no explicit support for closures exists, and to shorten some commands that would otherwise require a lot of intermediate variables.","In addition to running named closures saved inside scoped variables, the /run command can also be used to execute closures immediately."]},{"l":"Comments","p":["A comment is a human-readable explanation or annotation in the script code. Comments don't break pipes."]},{"l":"Block Comments","p":["Block comments can be used to quickly comment out multiple commands at once. They will not terminate on a pipe."]},{"l":"Flow Control"},{"i":"loops-while-and-times","l":"Loops: /while and /times","p":["If you need to run some command in a loop until a certain condition is met, use the /while command.","On each step of the loop it compares the value of variable A with the value of variable B, and if the condition yields true, then executes any valid slash command enclosed in quotes, otherwise exists the loop. This command doesn't write anything to the output pipe."]},{"i":"arguments-for-while","l":"Arguments for /while","p":["The set of available boolean comparisons, handing of variables, literal values, and subcommands is the same as for the /if command.","The optional guard named argument ( on by default) is used to protect against endless loops, limiting the number of iterations to 100. To disable and allow endless loops, set guard=off.","This example adds 1 to the value of i until it reaches 10, then outputs the resulting value (10 in this case)."]},{"i":"arguments-for-times","l":"Arguments for /times","p":["Runs a subcommand a specified number of times.","/times (repeats) (command)– any valid slash command enclosed in quotes repeats a number of times, e.g. /setvar key=i 1 | /times 5 /addvar key=i 1 adds 1 to the value of \"i\" 5 times.","{{timesIndex}} is replaced with the iteration number (zero-based), e.g. /times 4 /echo {{timesIndex}} echoes the numbers 0 through 4.","Loops are limited to 100 iterations by default, pass guard=off to disable."]},{"l":"Breaking out of Loops and Closures","p":["The /break command can be used to break out of a loop (/while or /times) or a closure early. The unnamed argument of /break can be used to pass a value different from the current pipe along./break is currently implemented in the following commands:","/while- exits the loop early","/times- exits the loop early","/run(with a closure or closure via variable) - exits the closure early","/:(with a closure) - exits the closure early"]},{"l":"Math operations","p":["/abs (a)– performs an absolute value operation of a value, e.g. /abs -10","/add (a b c d)– performs an addition of the set of values, e.g. /add 10 i 30 j","/cos (a)– performs a cosine operation of a value, e.g. /cos i","/div (a b)– performs a division of two values, e.g. /div 10 i","/log (a)– performs a natural logarithm operation of a value, e.g. /log i","/max (a b c d)– returns a maximum from the set of values, e.g. /max 1 0 4 k","/min (a b c d)– return a minimum from the set of values, e.g. /min 5 4 i 2","/mod (a b)– performs a modulo operation of two values, e.g. /mod i 2","/mul (a b c d)– performs a multiplication of the set of values, e.g. /mul 10 i 30 j","/pow (a b)– performs a power operation of two values, e.g. /pow i 2","/rand (round=round|ceil|floor from=number=0 to=number=1)– returns a random number between from and to, e.g. /rand or /rand 10 or /rand from=5 to=10. Ranges are inclusive. The returned value will contain a fractional part. Use round named argument to get an integral value, e.g. /rand round=ceil to round up, round=floor to round down, and round=round to round to nearest.","/round (a)– performs a rounding to the nearest integer operation of a value, e.g. /round 3.14","/sin (a)– performs a sine operation of a value, e.g. /sin i","/sqrt (a)– performs a square root operation of a value, e.g. /sqrt 9","/sub (a b)– performs a subtraction of two values, e.g. /sub i 5","All of the following operations accept a series of numbers or variable names and output the result to the pipe.","Invalid operations (such as division by zero), and operations that result in a NaN value or infinity return zero.","List of operations:","Multiplication, addition, minimum and maximum accept an unlimited number of arguments separated by spaces.","Sine, cosine, natural logarithm, square root, absolute value, and rounding accept one argument.","Subtraction, division, exponentiation, and modulo accept two arguments separated by spaces."]},{"i":"example-1-get-an-area-of-a-circle-with-a-radius-of-50","l":"Example 1: get an area of a circle with a radius of 50."},{"i":"example-2-calculate-a-factorial-of-5","l":"Example 2: calculate a factorial of 5."},{"l":"Using the LLM","p":["Scripts can make requests to your currently connected LLM API using the following commands:","/gen (prompt)— generates text using the provided prompt for the selected character and including chat messages.","/genraw (prompt)— generates text using just the provided prompt, ignoring the current character and chat.","/trigger— triggers a normal generation (equivalent to clicking a \"Send\" button). If in group chat, you can optionally provide a 1-based group member index or a character name to have them reply, otherwise triggers a group round according to the group settings."]},{"i":"arguments-for-gen-and-genraw","l":"Arguments for /gen and /genraw","p":["lock— can be on or off. Specifies whether a user input should be blocked while the generation is in progress. Default: off.","stop— JSON-serialized array of strings. Adds a custom stop string (if the API supports it) just for this generation. Default: none.","instruct(only /genraw) — can be on or off. Allows to use instruct formatting on the input prompt (if instruct mode is enabled and the API supports it). Set to off to force pure prompts. Default: on.","as(for Text Completion APIs) — can be system(default) or char. Defines how the last prompt line will be formatted. char will use a character name, system will use no or neutral name.","The generated text is then passed through the pipe to the next command and can be saved to a variable or displaced using the I/O capabilities:","Cthulhu Says"]},{"l":"Prompt injections","p":["Scripts can add custom LLM prompt injections, making it essentially an equivalent of unlimited Author's Notes.","/inject (text)— inserts any text into the normal LLM prompt for the current chat, and requires a unique identifier. Saved to chat metadata.","/listinjects— shows a list of all prompt injections added by scripts for the current chat in a system message.","/flushinjects— deletes all prompt injections added by scripts for the current chat.","/note (text)— sets the Author's Note value for the current chat. Saved to chat metadata.","/interval— sets the Author's Note insertion interval for the current chat.","/depth— sets the Author's Note insertion depth for the in-chat position.","/position— sets the Author's Note position for the current chat."]},{"i":"arguments-for-inject","l":"Arguments for /inject","p":["id— an identifier string or a reference to a variable. Consequent calls of /inject with the same ID will overwrite the previous text injection. Required argument.","position— sets a position for the injection. Default: after. Possible values:","after: after the main prompt.","before: before main prompt.","chat: in-chat.","depth— sets an injection depth for the in-chat position. 0 means insertion after the last message, 1 - before the last message, etc. Default: 4.","Unnamed argument is a text to be injected. An empty string will unset the previous value for the provided identifier."]},{"l":"Access chat messages"},{"l":"Read messages","p":["You can access messages in the currently selected chat using the /messages command.","The names argument is used to specify whether you want to include character names or not, default: on.","In an unnamed argument, it accepts a message index or range in the start-finish format. Ranges are inclusive!","If the range is unsatisfiable, i.e. an invalid index or more messages than exist are requested, then an empty string is returned.","Messages that are hidden from the prompt (denoted by the ghost icon) are excluded from the output.","If you want to know the index of the latest message, use the {{lastMessageId}} macro, and {{lastMessage}} will get you the message itself.","To calculate the start index for a range, for example, when you need to get the last N messages, use variable subtraction. This example will get you 3 last messages in the chat:"]},{"l":"Send messages","p":["A script can send messages as either a user, character, persona, neutral narrator, or add comments.","/send (text)— adds a message as the currently selected persona.","/sendas name=charname (text)— adds a message as any character, matching by their name. name argument is required. Use the {{char}} macro to send as the current character.","/sys (text)— adds a message from the neutral narrator that doesn't belong to the user or character. The displayed name is purely cosmetic and can be customized with the /sysname command.","/comment (text)— adds a hidden comment that is displayed in the chat but is not visible to the prompt.","/addswipe (text)— adds a swipe to the last character message. Can't add a swipe to the user or hidden messages.","/hide (message id or range)— hides one or several messages from the prompt based on the provided message index or inclusive range in the start-finish format.","/unhide (message id or range)— returns one or several messages to the prompt based on the provided message index or inclusive range in the start-finish format.","/send, /sendas, /sys, and /comment commands optionally accept a named argument at with a zero-based numeric value (or a variable name that contains such a value) that specifies an exact position of message insertion. By default new messages are inserted at the end of the chat log.","This will insert a user message at the beginning of the conversation history:"]},{"l":"Delete messages","p":["These commands are potentially destructive and have no \"undo\" function. Check the /backups/ folder if you accidentally deleted something important.","/cut (message id or range)— cuts one or several messages from the chat based on the provided message index or inclusive range in the start-finish format.","/del (number)— deletes last N messages from the chat.","/delswipe (1-based swipe id)— deletes a swipe from the last character message based on the provided 1-based swipe ID.","/delname (character name)— deletes all messages in the current chat that belong to a character with the specified name.","/delchat— deletes the current chat."]},{"l":"World Info commands","p":["World Info (also known as Lorebook) is a highly utilitarian tool for dynamically inserting data into the prompt. See the dedicated page for more detailed explanation: World Info.","/getchatbook– gets a name of the chat-bound World Info file or create a new one if was unbound, and pass it down the pipe.","/findentry file=bookName field=fieldName [text]– finds a UID of the record from the specified file (or a variable pointing to a file name) using fuzzy matching of a field value with the provided text (default field: key) and passes the UID down the pipe, e.g. /findentry file=chatLore field=key Shadowfang.","/getentryfield file=bookName field=field [UID]– gets a field value (default field: content) of the record with the UID from the specified World Info file (or a variable pointing to a file name) and passes the value down the pipe, e.g. /getentryfield file=chatLore field=content 123.","/setentryfield file=bookName uid=UID field=field [text]– sets a field value (default field: content) of the record with the UID (or a variable pointing to UID) from the specified World Info file (or a variable pointing to a file name). To set multiple values for key fields, use a comma-delimited list as a text value, e.g. /setentryfield file=chatLore uid=123 field=key Shadowfang,sword,weapon.","/createentry file=bookName key=keyValue [content text]– creates a new record in the specified file (or a variable pointing to a file name) with the key and content (both of these arguments are optional) and passes the UID down the pipe, e.g. /createentry file=chatLore key=Shadowfang The sword of the king."]},{"l":"Valid entry fields","p":["(see below)","0 = AND ANY","0 = before main prompt","0 = System","1 = after main prompt","1 = NOT ALL","1 = User","2 = Assistant","2 = NOT ANY","2 = top of Author's Note","3 = AND ALL","3 = bottom of Author's Note","4 = in-chat at depth","5 = top of example messages","6 = bottom of example messages","Boolean (1/0)","Case-Sensitive","caseSensitive","comment","constant","Constant Status","content","depth","Depth Role","disable","Disabled Status","excludeRecursion","Field","key","keysecondary","List of strings","Logic","Logic values","Match Whole Words","matchWholeWords","Non-recursable","Number","Number (0-100)","Number (0-999)","Optional Filter","order","position","Position values","Primary Keywords","probability","role","Role values(Position = 4 only)","Scan Depth","scanDepth","selectiveLogic","String","Title / Memo","Trigger%","UI element","Value type"]},{"i":"example-1-read-a-content-from-the-chat-lorebook-by-key","l":"Example 1: Read a content from the chat lorebook by key"},{"i":"example-2-create-a-chat-lorebook-entry-with-key-and-content","l":"Example 2: Create a chat lorebook entry with key and content"},{"i":"example-3-expand-an-existing-lorebook-entry-with-new-information-from-the-chat","l":"Example 3: Expand an existing lorebook entry with new information from the chat"},{"l":"Text manipulation","p":["There's a variety of useful text manipulation utility commands to be used in various script scenarios.","/trimtokens— trims the input to the specified number of text tokens from the start or from the end and outputs the result to the pipe.","/trimstart— trims the input to the start of the first complete sentence and outputs the result to the pipe.","/trimend— trims the input to the end of the last complete sentence and outputs the result to the pipe.","/fuzzy— performs fuzzy matching of the input text to the list of strings, outputting the best string match to the pipe.","/regex name=scriptName [text]— executes a regex script from the Regex extension for the specified text. The script must be enabled."]},{"i":"arguments-for-trimtokens","l":"Arguments for /trimtokens","p":["direction sets the direction for trimming, which can be either start or end. Default: end.","limit sets the amount of tokens to left in the output. Can also specify a variable name containing the number. Required argument.","Unnamed argument is the input text to be trimmed."]},{"i":"arguments-for-fuzzy","l":"Arguments for /fuzzy","p":["list is a JSON-serialized array of strings containing the candidates. Can also specify a variable name containing the list. Required argument.","Unnamed argument is the input text to be matched. Output is one of the candidates matching the input most closely."]},{"l":"Autocomplete","p":["Autocomplete is enabled both on the chat input, and the large Quick Reply editor.","Autocomplete works anywhere in your input. Even with multiple piped commands and nested closures.","Autocomplete supports three ways of looking up matching commands ( User Settings-> STscript Matching).","Starts with The \"old\" way. Only commands that begin exactly with the typed value will show up.","Includes All commands that include the type value will show up. Example: When entering /delete, the commands /qr-delete and /qr-set-delete will show up in the autocomplete list (/qr- delete, /qr-set- delete).","Fuzzy All commands that can be fuzzy-matched against the typed value will show up. Example: When entering /seas, the command /sendas will show up in the autocomplete list (/ se nd as).","Command arguments are supported by autocomplete as well. The list will show up for required arguments automatically. For optional arguments, press Ctrl+ Space to open the list of available options.","When entering /: to execute a closure or QR, autocomplete will show a list of scoped variables and QRs.","Autocomplete has limited support for macros (in slash commands). Type {{ to get a list of available macros.","Use the up and down arrow keys to select an option from the list of autocomplete options.","Press Enter or Tab or click on an option to place the option at the cursor.","Press Escape to close the autocomplete list.","Press Ctrl+ Space to open the autocomplete list or toggle the selected option's details."]},{"l":"Parser Flags","p":["The parser accepts flags to modify its behavior. These flags can be toggled on and off at any point in a script and all following input will be evaluated accordingly. You can set your default flags in user settings."]},{"l":"Strict Escaping","p":["Changes with STRICT_ESCAPING enabled are as follows."]},{"i":"pipes-1","l":"Pipes","p":["Pipes don't need to be escaped in quoted values."]},{"l":"Backslashes","p":["A backslash in front of a symbol can be escaped to provide the literal backslash followed by the functional symbol."]},{"l":"Replace Variable Macros","p":["This flag helps to avoid double-substitutions when the variable values contain text that could be interpreted as macros. The {{var::}} macros get substituted last and no further substitutions happen on the resulting text / variable value.","Replaces all {{getvar::}} and {{getglobalvar::}} macros with {{var::}}. Behind the scenes, the parser will insert a series of command executors before the command with the replaced macros:","call /let to save the current {{pipe}} to a scoped variable","call /getvar or /getglobalvar to get the variable used in the macro","call /let to save the retrieved variable to a scoped variable","call /return with the saved {{pipe}} value to restore the correct piped value for the next command"]},{"i":"quick-replies-script-library-and-auto-execution","l":"Quick Replies: script library and auto-execution","p":["Quick Replies is a built-in SillyTavern extension that provides an easy way to store and execute your scripts."]},{"l":"Configuring Quick Replies","p":["In order to get started, enable open the extensions panel (stacked blocks icon), and expand the Quick Replies menu.","Quick Reply","Quick Replies are disabled by default, you need to enable them first. Then you will see a bar appearing above your chat input bar.","You can set the displayed button text label (we recommend using emojis for brevity) and the script that will be executed when you click the button.","The number of buttons is controlled by the Number of slots settings (max = 100), adjust it according to your needs and click \"Apply\" when done.","Inject user input automatically recommended to be disabled when using STscript, otherwise it may interfere with your inputs, use the {{input}} macro to get the current value of the input bar in scripts instead.","Quick Reply presets allow to have multiple sets of predefined Quick Replies and switch between manually or by using the /qrset (name of set) command. Don't forget to click \"Update\" before switching to a different set to write your changes to the currently used preset!"]},{"l":"Manual execution","p":["Now you can add your first script to the library. Pick any free slot (or create one), type \"Click me\" into the left box to set the label, then paste this into the right box:","Then click 5 times on the button that appeared above the chat bar. Every click increments the variable clicks by one and displays a different message when the value equals 5 and resets the variable."]},{"l":"Automatic execution","p":["Open the modal menu by clicking the ⋮ button for the created command.","In this menu you can do the following:","Edit the script in a convenient full-screen editor","Hide the button from the chat bar, making it accessible only for auto-execution.","Enable automatic execution on one or more of the following conditions:","App startup","Sending a user message to the chat","Receiving an AI message in the chat","Opening a character or group chat","Triggering a reply from a group member","Activating a World Info entry using the same Automation ID","Provide a custom tool tip for the quick reply (text displayed when hovering over the quick reply in your UI)","Execute the script for test purposes","Commands are executed automatically only if the Quick Replies extension is enabled.","For example, you can display a message after sending five user messages by adding the following script and setting it to auto-execute on the user message."]},{"l":"Debugger","p":["A basic debugger exists inside the expanded Quick Reply editor. Set breakpoints with /breakpoint | anywhere in your script. When executing the script from the QR editor, the execution will be interrupted at that point, allowing you to examine the currently available variables, pipe, command arguments, and more, and to step through the rest of the code one by one.","QR Editor Debugger"]},{"l":"Calling procedures","p":["A /run command can call scripts defined in the Quick Replies by their label, basically providing the ability to define procedures and return results from them. This allows to have reusable script blocks that other scripts could reference. The last result from the procedure's pipe is passed to the next command after it.","Let's create two Quick Replies:","Label:","GetRandom","Command:","GetMessage","Clicking on the GetMessage button will call the GetRandom procedure which will resolve the {{roll}} macro and pass the number to the caller, displaying it to the user.","Procedures do not accept named or unnamed arguments, but can reference the same variables as the caller.","Avoid recursion when calling procedures as it may produce the \"call stack exceeded\" error if handled unadvisedly."]},{"l":"Calling procedures from a different Quick Reply preset","p":["You can call a procedure from a different quick reply preset using the a.b syntax, where a = QR preset name and b = QR label name","By default, the system will first look for a quick reply label a.b, so if one of your labels is literally \"QRpreset1.QRlabel1\" it will try to run that. If no such label is found, it will search for a QR preset name \"QRpreset1\" with a QR labeled \"QRlabel1\"."]},{"l":"Quick Replies management commands"},{"l":"Create Quick Reply","p":["/qr-create (arguments, [message])– creates a new Quick Reply, example: /qr-create set=MyPreset label=MyButton /echo 123","Arguments:","label- string - text on the button, e.g., label=MyButton","set- string - name of the QR set, e.g., set=PresetName1","hidden- bool - whether the button should be hidden, e.g., hidden=true","startup- bool - auto execute on app startup, e.g., startup=true","user- bool - auto execute on user message, e.g., user=true","bot- bool - auto execute on AI message, e.g., bot=true","load- bool - auto execute on chat load, e.g., load=true","title- bool - title / tooltip to be shown on button, e.g., title=My Fancy Button"]},{"l":"Delete Quick Reply","p":["/qr-delete (set=string [label])– deletes Quick Reply"]},{"l":"Update Quick Reply","p":["/qr-update (arguments, [message])– updates Quick Reply, example: /qr-update set=MyPreset label=MyButton newlabel=MyRenamedButton /echo 123","Arguments:","newlabel- string - new text fort the button, e.g. newlabel=MyRenamedButton","label- string - text on the button, e.g., label=MyButton","set- string - name of the QR set, e.g., set=PresetName1","hidden- bool - whether the button should be hidden, e.g., hidden=true","startup- bool - auto execute on app startup, e.g., startup=true","user- bool - auto execute on user message, e.g., user=true","bot- bool - auto execute on AI message, e.g., bot=true","load- bool - auto execute on chat load, e.g., load=true","title- bool - title / tooltip to be shown on button, e.g., title=My Fancy Button"]},{"i":"#","p":["qr-get- retrieves all of a Quick Reply's properties, eample: /qr-get set=myQrSet id=42"]},{"l":"Create or update QR preset","p":["/qr-presetupdate (arguments [label]) or /qr-presetadd (arguments [label])","Arguments:","enabled- bool - enable or disable the preset","nosend- bool - disable send / insert in user input (invalid for slash commands)","before- bool - place QR before user input","slots- int - number of slots","inject- bool - inject user input automatically (if disabled use {{input}})","Create a new preset (overrides existing ones), example: /qr-presetadd slots=3 MyNewPreset"]},{"l":"Add QR context menu","p":["/qr-contextadd (set=string label=string chain=bool [preset name])– add context menu preset to a QR, example: /qr-contextadd set=MyPreset label=MyButton chain=true MyOtherPreset"]},{"l":"Remove all context menus","p":["/qr-contextclear (set=string [label])– remove all context menu presets from a QR, example: /qr-contextclear set=MyPreset MyButton"]},{"l":"Remove one context menu","p":["/qr-contextdel (set=string label=string [preset name])– remove context menu preset from a QR, example: /qr-contextdel set=MyPreset label=MyButton MyOtherPreset"]},{"l":"Quick Reply value escaping","p":["|{} can be escaped with backslash in the QR message / command.","For example, use /qr-create label=MyButton /getvar myvar \\| /echo \\{\\{pipe\\}\\} to create a QR that calls /getvar myvar | /echo {{pipe}}."]},{"l":"Extension commands","p":["SillyTavern extensions (both built-in, downloadable and third-party) can add their own slash command. Below is just an example of the capabilities in the official extensions. The list may be incomplete, make sure to check /help slash for the most complete list of available commands.","/websearch (query)— searches snippets of the web pages online for the specified query and returns the result into the pipe. Provided by the Web Search extension.","/imagine (prompt)— generates an image using the provided prompt. Provided by the Image Generation extension.","/emote (sprite)— sets a sprite for the active character by fuzzy matching its name. Provided by the Character Expressions extension.","/costume (subfolder)— sets a sprite set override for the active character. Provided by the Character Expressions extension.","/music (name)— force changes a played background music file by its name. Provided by the Dynamic Audio extension.","/ambient (name)— force changes a played ambient sound file by its name. Provided by the Dynamic Audio extension.","/roll (dice formula)— adds a hidden message to the chat with the result of a dice roll. Provided by the D&D Dice extension."]},{"l":"UI interaction","p":["Scripts can also interact with SillyTavern's UI: navigate through the chats or change styling parameters."]},{"l":"Character navigation","p":["/random— opens a chat with the random character.","/go (name)— opens a chat with the character of the specified name. First, searches for the exact name match, then by a prefix, then by a substring."]},{"l":"UI styling","p":["/bubble— sets the message style to the \"bubble chat\" style.","/flat— sets the message style to the \"flat chat\" style.","/single— sets the message style to the \"single document\" style.","/movingui (name)— activates a MovingUI preset by name.","/resetui— resets the MovingUI panels state to their original positions.","/panels— toggles the UI panels visibility: top bar, left and right drawers.","/bg (name)— finds and sets a background using fuzzy names matching. Respect the chat background lock state.","/lockbg— locks the background image for the current chat.","/unlockbg— unlocks the background image for the current chat."]},{"l":"More examples"},{"i":"generate-chat-summary-by-ikaridevgit","l":"Generate chat summary (by @IkariDevGIT)"},{"l":"Buttons popup usage"},{"i":"get-nth-fibonaccis-number-using-binets-formula","l":"Get Nth Fibonacci's number (using Binet's formula)","p":["Hint: Set value of fib_no to the desired number"]},{"i":"recursive-factorial-using-closures","l":"Recursive Factorial (using closures)"}],[{"l":"Function Calling","p":["Function Calling allows adding dynamic functionality to your extensions by letting the LLM use structured data that you then can use to trigger a specific functionality of the extension.","This feature is currently under development. Implementation details may change."]},{"l":"Example use cases","p":["Query external APIs for additional information (news, weather, web search, etc.).","Perform calculations or conversions based on user input.","Store and recall important memories or facts, including RAG and database queries.","Introduce true randomness into the conversation (dice rolls, coin flips, etc.)."]},{"l":"Officially supported extensions using function calling","p":["Image Generation(built-in) - generate images based on user prompts.","Web Search- trigger a web search for a query.","RSS- fetch the latest news from RSS feeds.","AccuWeather- fetch the weather information from AccuWeather.","D&D Dice- roll dice for D&D games."]},{"l":"Prerequisites and limitations","p":["This feature is only available for certain Chat Completion sources: OpenAI, Claude, MistralAI, Groq, Cohere, OpenRouter and Custom API sources.","Text Completion APIs don't support function calls, but some locally-hosted backends like Ollama and TabbyAPI may run in Custom OpenAI-compatible mode under Chat Completion.","The support for function calling must be explicitly allowed by the user first. This is done by enabling the \"Enable function calling\" option in the AI Response Configuration panel.","There is no guarantee that an LLM will perform any function calls at all. Most of them require an explicit \"activation\" through the prompt (e.g., the user asking to \"Roll a dice\", \"Get the weather\", etc.).","Not all prompts can trigger a tool call. Continuations, impersonation, background ('quiet') prompts are not allowed to trigger a tool call. They can still use past successful tool calls in their responses."]},{"l":"How to make a function tool"},{"l":"Check if the feature is supported","p":["To determine if the function tool calling feature is supported, you can call isToolCallingSupported from the SillyTavern.getContext() object. This will check if the current API supports function tool calling and if it's enabled in the settings. Here is an example of how to check if the feature is supported:"]},{"l":"Register a function","p":["To register a function tool, you need to call the registerFunctionTool function from the SillyTavern.getContext() object and pass the required parameters. Here is an example of how to register a function tool:"]},{"l":"Unregister a function","p":["To deactivate a function tool, you need to call the unregisterFunctionTool function from the SillyTavern.getContext() object and pass the name of the function tool to disable. Here is an example of how to unregister a function tool:"]},{"l":"Tips and tricks","p":["Successful tool calls are saved as a part of the visible history and will be displayed in the chat UI, so you can inspect the actual parameters and results.","If you don't want to see the tool call in the chat history. If you want to stylize or hide them with custom CSS, target a toolCall class on .mes elements, i.e. .mes.toolCall { display: none; } or .mes.toolCall { color: #999; }."]}],[{"l":"UI Extensions","p":["UI extensions expand the functionality of SillyTavern by hooking into its events and API. You can easily create your own extensions.","Want to contribute your extensions to the official repository? Contact us!"]},{"l":"Examples","p":["See live examples of simple SillyTavern extensions:","https://github.com/city-unit/st-extension-example- basic extension template. Showcases manifest creation, local script imports, adding a settings UI panel, and persistent extension settings usage."]},{"l":"Bundling","p":["Extensions can also utilize bundling to isolate themselves from the rest of the modules and use any dependencies from NPM, including UI frameworks like Vue, React, etc.","https://github.com/SillyTavern/Extension-ReactTemplate- template repository of a barebone extension using React and Webpack.","To use relative imports from the bundle, you may need to create an import wrapper. Here's an example for Webpack:"]},{"i":"manifestjson","l":"manifest.json","p":["Every extension must have a folder in data/user-handle/extensions and have a manifest.json file which contains metadata about the plugin and a JS script file.","display_name is required. Displays in the \"Manage Extensions\" menu.","loading_order is optional. Higher number loads later.","requires specifies the required Extras modules dependencies. An extension won't be loaded unless the connected Extras API provides all of them.","optional specifies the optional Extras dependencies.","js is the main JS file reference, and is required.","css is an optional style file reference.","author is required. It should contain the name or contact info of the author(s).","auto_update is set to true if the extension should auto-update when the version of the ST package changes.","Downloadable extensions are mounted into the /scripts/extensions/third-party folder, so relative imports should be used based on that. Be careful about where you create your extension during development if you plan on installing it from your GitHub which overwrites the content in the third-party folder."]},{"l":"requires vs optional","p":["requires- extension could be installed, but will not be loaded until the user connects to the Extras API that provides all of the specified modules.","optional- extension could be installed and will always be loaded, but any of the missing Extras API modules will be highlighted in the \"Manage extensions\" menu.","To check which modules are currently provided by the connected Extras API, import the modules array from scripts/extensions.js."]},{"l":"Using getContext","p":["The getContext() function gives you access to the SillyTavern context:","Use this to interact with the main app state.","You can also use a globally defined window object: SillyTavern.getContext()."]},{"l":"Importing from other files","p":["Unless you're building a bundled extension, you can import variables and functions from other JS files.","For example, this code snippet will generate a reply from the currently selected API in the background:"]},{"l":"Important note","p":["Using imports from SillyTavern code is unreliable and can break at any time if the internal structure of ST's modules changes. getContext provides a more stable API.","If you're missing any of the functions/properties in getContext, please get in touch with the developers or send us a Pull Request!"]},{"i":"registering-slash-commands-new-way","l":"Registering slash commands (new way)","p":["While registerSlashCommand still exists for backward compatibility, new slash commands should now be registered through SlashCommandParser.addCommandObject() to provide extended details about the command and its parameters to the parser (and in turn to autocomplete and the command help)."]},{"i":"deprecated-registering-slash-commands-old-way","l":"(DEPRECATED) Registering slash commands (old way)","p":["Use registerSlashCommand() to register a new slash command:","Example of command execution:","Arguments explanation:","command- the main command name. It will be used in autocompletion and help commands.","callback- a function that will be executed when the command is triggered. A callback function can accept two arguments:","namedArgs- an object with named arguments","unnamedArgs- a string containing the unnamed argument","aliases- an array of alias strings. The command can be called using any of the aliases, but they won't be shown in the autocomplete but will be listed in the help command.","helpString- a string that will be displayed when the /help slash command is called. Must describe what your command does and which arguments it accepts. May contain HTML markup.","All registered commands can be used in STscript in any possible way.","In rare circumstances, the unnamed command argument can also receive a number so be sure to type check or convert if you expect a concrete type!"]},{"l":"Listening to event types","p":["Use eventSource.on() to listen for events:","The main event types are:","MESSAGE_RECEIVED","MESSAGE_SENT","CHAT_CHANGED","The rest can be found here."]},{"l":"Do Extras request","p":["The doExtrasFetch() function allows you to make requests to your SillyTavern Extra server.","For example, to call the /api/summarize endpoint:","getApiUrl() returns the base URL of the Extras serve.","The doExtrasFetch() function:","Adds the Authorization and Bypass-Tunnel-Reminder headers","Handles fetching the result","Returns the result (the response object)","This makes it easy to call your Extra's API from your plugin.","You can specify:","The request method: GET, POST, etc.","Additional headers","The body for POST requests","And any other fetch options"]}],[{"l":"Server Plugins","p":["These plugins allow adding functionality that is impossible to achieve using UI extensions alone, such as creating new API endpoints or using Node.JS packages that are unavailable in a browser environment.","Plugins are contained in the plugins directory of SillyTavern and loaded on server startup, but only if enableServerPlugins is set to true in the config.yaml file.","Plugins are not sandboxed, be careful what you install and run!"]},{"l":"Types of plugins"},{"l":"Files","p":["An executable JavaScript file with \".js\" (for CommonJS modules) or \".mjs\" (for ES modules) extension containing a module that exports an init function that accepts an Express router (created specifically for your plugin) as an argument and returns a Promise.","The module should also export an info object containing the information about the plugin ( id, name, and description strings). This will provide the information about the plugin to the loader.","You can register routes via the router that will be registered under the /api/plugins/{id}/{route} path. For example router.get('/foo') for plugin example will produce a route like this: /api/plugins/example/foo.","A plugin could also optionally export an exit function that performs clean-up on shutting down the server. It should have no arguments and must return a Promise.","TypeScript contract for plugin exports:","See below for a \"Hello world!\" plugin example:"]},{"l":"Directories","p":["You can load a plugin from a subdirectory in the plugins in one of the following ways (in the order of checks):","package.json file that contains a path to an executable file in the \"main\" field.","index.js file for CommonJS modules.","index.mjs file for ES modules.","A resulting file must export an init function and info object with the same requirements as for individual files.","Example of a directory plugin (with index.js file): https://github.com/SillyTavern/SillyTavern-DiscordRichPresence-Server"]},{"l":"Bundling","p":["It is preferable to use a bundler (such as Webpack or Browserify) that will package all of the requirements into one file. Make sure to set \"Node\" as a build target.","Template repository for plugins using Webpack and TypeScript: https://github.com/SillyTavern/Plugin-WebpackTemplate"]}],[{"i":"internationalization-i18n","l":"Internationalization (i18n)","p":["SillyTavern supports multiple languages. This guide explains how to add and manage translations.","You're probably here because some piece of text is untranslated in your language, and it's driving you nuts. First I'll show you how I fixed some missing translations in the Chinese (Traditional) locale. Each was missing for a different reason, so you'll get a good idea of how to fix your own missing translations.","In the second half, we look at","how i18n works in SillyTavern,","writing translations and code to use them,","debug functions to find missing translations,","adding a new language,","and contributing your changes.","If you're developing an extension or modifying the core code, write your HTML and JavaScript with i18n in mind. This way your work is ready for other people to translate it into their language.","Nobody knows 15 languages by themselves. We work together to make SillyTavern accessible to everyone.","Everyone in the world should be able to use their own language on phones and computers."]},{"i":"lets-fix-some-missing-translations","l":"Let's fix some missing translations!","p":["All 3 of these issues required code changes to fix. If you're adding a new translation, you might not need to touch the code at all. Just add the translation to the JSON file. It just so happens that somebody recently added a large number of missing translations to the Chinese (Traditional) JSON file, so the remaining issues were all in the code. In other locales there are plenty of missing translations you can fix without touching the code."]},{"l":"Generate Image","p":["... which we can add to the JSON file just after the \"Generate Image\" translation.","After some discussion with Claude, we're actually going to go with the following translations:","But while we have the HTML open, what's with Stop Image Generation just under it? The HTML doesn't look right.","First fix the HTML:","generate-image-lang.png","generate-image-post.png","generate-image-pre.png","If we generate an image and then open the wand menu while it's generating, we see untranslated text.","Japanese: \"Stop Image Generation\": \"画像生成を停止\"","Now it works! Reload the page and see.","Right-click on the element and inspect it. You'll see the HTML:","Simplified Chinese: \"Stop Image Generation\": \"中止图像生成\"","stop-generating-image-pre.png","stop-generating-post-2.png","The text \"Generate Image\" is untranslated in the Chinese (Traditional) locale. Why?","This isn't enough to fix the issue. There are no translations for \"Stop Image Generation\" in the Chinese (Traditional) file. We can add it! Here's one possible translation:","Traditional Chinese: \"Stop Image Generation\": \"終止圖片生成\"","We are in luck, that string Generate Image is in many of the language files, including in Chinese (Traditional).","Where is its data-i18n attribute? It's missing! Let's add it. We find it in the source code:","Why isn't it showing up? We have to wire the element up correctly:"]},{"l":"Generate Caption","p":["\"Generate Caption\" is untranslated in the Chinese (Traditional) locale. Let's fix it!","generate-image-post.png","Where is it? Inspect the element.","Turns out that this HTML is produced by JavaScript. Let's find the source code.","We will first have to fix the code:","There are also no translations for \"Generate Caption\" in the Chinese (Traditional) file. Let's add it!","We will use the following translations:","Traditional Chinese: \"Generate Caption\": \"生成圖片說明\"","Simplified Chinese: \"Generate Caption\": \"生成图片说明\"","Japanese: \"Generate Caption\": \"画像説明を生成\"","generate-caption-post.png"]},{"l":"Inspect Prompts","p":["The text \"Inspect Prompts\" is untranslated in the Chinese (Traditional) locale. Why? This one is a bit more complicated. The text is generated by JavaScript, and the translation is missing.","Well wouldn't you know it... neither phrase is in the i18n files. Let's add them.","Now we have to fix the JavaScript code. It has to use the t function to get the translation.","We got these suggestions from Claude. Keep the strings, ignore the code. They have to be added to the JSON files.","We will merge those into the JSON files.","toggle-prompt-inspection-post-tt.png","A pity about that tooltip. The problem is that the code doesn't use the t function.","We will have to fix that in the extension code.","We also need to add the translations to the JSON files.","Prompt inspector is a separate extension, so we will PR the code fixes to that repo: https://github.com/SillyTavern/Extension-PromptInspector/pull/1","The translations will be added to the main SillyTavern repo. https://github.com/SillyTavern/SillyTavern/pull/3198","start-inspecting-post.png"]},{"l":"Language files","p":["Each language has a JSON file in public/locales/ named with its language code (e.g., ru-ru.json).","The file contains key-value pairs where:","Keys are either the original English text or unique identifiers","Values are the translated text","Example:"]},{"l":"How translations work","p":["There are two ways translations are used in the application:","HTML Elements: Using data-i18n attributes","The default text in the HTML will be replaced with the translated text if available.","Template Strings: In the JavaScript code using the t function","These strings should be translated keeping the ${0}, ${1}, etc. placeholders intact.","SillyTavern uses HTML elements with data-i18n attributes to mark translatable content. There are several ways to use this:"]},{"l":"1. Translating Element Text","p":["For simple text content:","This replaces the element's text content with the translation of \"Role:\"."]},{"l":"2. Translating Attributes","p":["To translate an attribute like a title or placeholder:","The [title] prefix indicates which attribute to translate. The rest of the attribute value is the text that will be used as a lookup key in the JSON file. It is common for coders to use the English text as the key, but it is not required. The key can be any unique identifier.","The original English text must be present in the corresponding attribute ( title=Insert prompt) though. It's used as a fallback if the translation is missing. Most notably, there is no translation file for English.","Here is an example of using a unique identifier no_items_text as the key, rather than the English text:"]},{"l":"3. Multiple Translations Per Element","p":["Some elements need both content and attribute translations, separated by semicolons. The most common pattern is translating both the element's text content and its title attribute:","This translates:","The element's text content using the key \"Authorize\"","The title attribute using the key \"Get your OpenRouter API token using OAuth flow. You will be redirected to openrouter.ai\"","Note that both the title attribute and the element's text content are provided in English as fallbacks.","You can also translate multiple attributes:","The corresponding translations in your language file would look like:","When the page loads, the system:","Finds all elements with data-i18n attributes","Parses any attribute prefixes like [title] or [placeholder]","Looks up each key in your language's JSON file","Replaces the element's content or attributes with the translated text"]},{"l":"Dynamic Text","p":["For dynamic text in JavaScript code, translations use either:","Template literals with the t function:","Direct translation function:"]},{"l":"Variable Placeholders","p":["Some strings contain placeholders for dynamic values using ${0}, ${1}, etc:","Keep the placeholders the same for key and translation. The system will replace ${0} with the value of presetName, etc."]},{"l":"Finding missing translations","p":["Let's say you don't just want to fix one annoying missing translation, you want to find them all.","That's a big ambition! Even fixing one translation is worth it. But if you want to catch 'em all, you need a tool."]},{"l":"SillyTavern-i18n","p":["https://github.com/SillyTavern/SillyTavern-i18n","Tools for working with frontend localization files.","Features:","Automatically add new keys to translate from HTML files.","Prune missing keys from localization files.","Use automatic Google translation to auto-populate missing values.","Sort JSON files by keys."]},{"l":"Inbuilt debug functions","p":["These are under User Settings> Debug Menu."]},{"l":"Get missing translations","p":["Detects missing localization data in the current locale and dumps the data into the browser console. If the current locale is English, searches all other locales.","The console will show a table of missing translations with:","key: The text or identifier needing translation","language: Your current language code","value: The English text to translate"]},{"l":"Apply locale","p":["Reapplies the currently selected locale to the page","they don't catch missing translations in JavaScript code","they don't catch missing data-i18n attributes in HTML, they just catch untranslated keys","there are bugs in the code for getMissingTranslations: keys should not be prefixed with [title] or [placeholder]"]},{"l":"Adding a new language","p":["To add support for a new language:","Add your language to public/locales/lang.json:","Create public/locales/xx-xx.json with your translations"]},{"l":"Contributing","p":["When your translations are ready:","Verify your JSON file is valid","Test thoroughly in the application","Submit via GitHub pull request"]}],[{"l":"Administration","p":["Despite following many security best practices, the SillyTavern server is not secure enough for public internet exposure.","NEVER HOST ANY INSTANCES TO THE OPEN INTERNET WITHOUT ENSURING PROPER SECURITY MEASURES FIRST.","WE ARE NOT RESPONSIBLE FOR ANY DAMAGE OR LOSSES IN CASES OF UNAUTHORIZED ACCESS DUE TO IMPROPER OR INADEQUATE SECURITY IMPLEMENTATION.","Multi-user","To share your SillyTavern instance with others, you can create multiple user accounts. Each user has their own settings, extensions, and data. User accounts can also be password-protected.","Remote access","You can access your SillyTavern instance from your phone, tablet, or another computer.","VPNs and Tunneling","To access your SillyTavern instance from the internet, you can use a VPN or a tunneling service like Cloudflare Zero Trust, ngrok, or Tailscale.","Reverse proxying","For enthusiasts, you can set up a reverse proxy to access your SillyTavern instance from the internet."]},{"l":"Security checklist","p":["This is just a recommendation. Please consult a web application security specialist before making your ST instance live.","Keep your operating system and runtime software like Node.js updated. This will ensure that your system is up-to-date with the latest security patches and fixes which can help prevent potential vulnerabilities.","Use a whitelist and a network firewall. Only allow trusted IP ranges to access the server.","Enable basic authentication. It acts as a \"master password\" before you can proceed to the front-end app.","Alternatively, configure external authentication. Some known services for that are Authelia and authentik. See more in the SSO guide.","Never leave admin accounts passwordless. A server will warn you upon the startup if you have any unprotected admin accounts.","Use the discreet login setting outside of the local network. This will hide the user list from any potential outsiders.","Check the access logs often. They are written to the server console and the access.log file and provide information on incoming connections, such as IP address and user agent.","Configure HTTPS. For a localhost server, you can generate and use a self-signed certificate. Otherwise, you may need to deploy a proxying web server like Traefik or Caddy.","Find more on secure proxying in the following guide: Reverse Proxying SillyTavern."]}],[{"l":"Configuration File","p":["This documentation may be obsolete, incomplete, or incorrect. Please refer to the default config.yaml in your installation for the most up-to-date list of settings.","config.yaml is the main configuration file for the SillyTavern server that you can find in the repository root directory after completing the installation. It is a YAML file that contains various settings, such as the network settings, security settings, and backend-specific options. The changes made to this file will take effect after restarting the server.","New settings that added to the upstream version will be automatically populated with the default values when you run npm install(or specifically, the post-install.js script) after updating the repository. You can then modify these settings as needed.","For nested settings, dot notation is used to indicate the hierarchy. For example, protocol.ipv6: false refers to the ipv6 setting under the protocol section with a value of false."]},{"l":"Data Configuration","p":["./data","100","Any positive integer","Any valid directory path","cardsCacheCapacity","dataRoot","Default","Description","false","Permitted Values","Root directory for user data storage","Setting","Skip new default content checks","skipContentCheck","The maximum amount of memory that parsed character cards can use in MB.","true, false"]},{"l":"Network Configuration","p":["8000","Any valid port number (1-65535)","Default","Description","dnsPreferIPv6","Enable listening for incoming connections","Enable listening on IPv4 protocol","Enable listening on IPv6 protocol","false","listen","Permitted Values","port","Prefer IPv6 for DNS resolution","protocol.ipv4","protocol.ipv6","Server listening port","Setting","true","true, false"]},{"l":"Security Configuration","p":["[::1, 127.0.0.1]","Allow API keys exposure in the UI","allowKeysExposure","Array of valid IP addresses","Check forwarded headers for whitelisted IPs","Default","Description","Disable CSRF protection (not recommended)","Disable startup security checks (not recommended)","disableCsrfProtection","Enable CORS proxy middleware","Enable IP whitelist filtering","enableCorsProxy","enableForwardedWhitelist","false","List of allowed IP addresses","Permitted Values","securityOverride","Setting","true","true, false","whitelist","whitelistMode"]},{"l":"User Authentication","p":["''(auto-generated)","86400(24 hours)","Any number (-1 to disable, 0 for browser close, >0 for timeout)","Any string","autheliaAuth","Basic auth password","Basic auth username","basicAuthMode","basicAuthUser.password","basicAuthUser.username","cookieSecret","Default","Description","Enable Authelia-based auto login. See: SSO","Enable basic authentication","Enable multi-user mode","enableDiscreetLogin","enableUserAccounts","false","Hide user list on login screen","password","Permitted Values","perUserBasicAuth","Secret for signing session cookies","sessionTimeout","Setting","true, false","Use account credentials for basic auth","user","User session timeout in seconds"]},{"l":"Request Proxy Configuration","p":["[localhost, 127.0.0.1]","Array of hostnames/IPs","Default","Description","Enable proxy for outgoing requests","false","Hosts to bypass proxy","null","Permitted Values","Proxy server URL","requestProxy.bypass","requestProxy.enabled","requestProxy.url","Setting","true, false","Valid proxy URL (e.g., socks5://username:password@example.com:1080)"]},{"l":"AutoRun Configuration","p":["-1","-1(use server port), any valid port number","auto","auto, any valid hostname (e.g., localhost, st.example.com)","autorun","autorunHostname","autorunPortOverride","Avoid using 'localhost' for autorun","avoidLocalhost","Default","Description","false","Hostname used when autorun opens the browser","Open browser automatically on startup","Override port for browser autorun","Permitted Values","Setting","true","true, false"]},{"l":"Thumbnailing Configuration","p":["[160, 90]","[96, 144]","0-100","95","Array of two numbers (width, height)","Avatar thumbnails size","Background thumbnails size","Default","Description","Enable thumbnail generation","Image format for thumbnails","JPEG thumbnail quality","jpg","jpg, png","Permitted Values","Setting","thumbnails.dimensions.avatar","thumbnails.dimensions.bg","thumbnails.enabled","thumbnails.format","thumbnails.quality","true","true, false"]},{"l":"Backup Configuration","p":["-1","10000","50","Any positive integer","Any positive integer or -1","Backup throttle interval (ms)","backups.chat.enabled","backups.chat.maxTotalBackups","backups.chat.throttleInterval","backups.common.numberOfBackups","Default","Description","Enable automatic chat backups","Maximum total chat backups to keep","Number of backups to keep","Permitted Values","Setting","true","true, false"]},{"l":"Extensions Configuration","p":["Auto-update extensions","Cohee/distilbert-base-uncased-go-emotions-onnx","Cohee/jina-embeddings-v2-base-en","Default","Description","Disable automatic model downloads","Enable on-demand tokenizer downloads","Enable UI extensions","enableDownloadableTokenizers","enableExtensions","enableExtensionsAutoUpdate","extras.captioningModel","extras.classificationModel","extras.disableAutoDownload","extras.embeddingModel","extras.speechToTextModel","extras.textToSpeechModel","false","HuggingFace model ID for classification","HuggingFace model ID for embeddings","HuggingFace model ID for image captioning","HuggingFace model ID for speech-to-text","HuggingFace model ID for text-to-speech","Permitted Values","Setting","true","true, false","Valid model ID","Xenova/speecht5_tts","Xenova/vit-gpt2-image-captioning","Xenova/whisper-small"]},{"l":"Server Plugins","p":["Setting","Description","Default","Permitted Values","enableServerPlugins","Enable server-side plugins","false","true, false"]},{"l":"API Integration Settings"},{"l":"OpenAI Configuration","p":["Setting","Description","Default","Permitted Values","promptPlaceholder","Default message for empty prompts","[Start a new chat]","Any string","openai.randomizeUserId","Randomize user ID for API calls","false","true, false","openai.captionSystemPrompt","System message for caption completion"]},{"l":"MistralAI Configuration","p":["Setting","Description","Default","Permitted Values","mistral.enablePrefix","Enable reply prefilling. The prefix will be echoed in the response","false","true, false"]},{"l":"Ollama Configuration","p":["Setting","Description","Default","Permitted Values","ollama.keepAlive","Model keep-alive duration (seconds)","-1","-1(indefinite), 0(immediate unload), positive integer"]},{"l":"Claude Configuration","p":["IMPORTANT!","Use with caution and only when the prompt prefix is static and doesn't change between requests. {{random}} macro, lorebooks, vectors, summaries, etc. will likely invalidate the cache and you'll just waste money on cache misses. Behavior may be unpredictable and no guarantees can or will be made.","See: Prompt Caching","Setting","Description","Default","Permitted Values","claude.enableSystemPromptCache","Enable system prompt caching","false","true, false","claude.cachingAtDepth","Enable message history caching","-1","-1(disabled), 0 or positive integer"]},{"l":"DeepL Configuration","p":["Setting","Description","Default","Permitted Values","deepl.formality","Translation formality level","default, more, less, prefer_more, prefer_less"]}],[{"l":"Multi-user mode","p":["Multi-user mode allows several people to use one SillyTavern server. Each user has their own settings, extensions, and data. User accounts can also be password-protected.","User passwords provide basic privacy between users of a multi-user setup. They are not a security feature and should not be considered as such. All user data (including chat history, API keys, and other sensitive information) is stored in plain text on the server. It can be viewed and modified by anyone with access to the server's filesystem. Do not use SillyTavern on a public server or with untrusted users."]},{"l":"Configuration","p":["To enable and use the multi-user mode, edit the config.yaml file:","When the user account setting is disabled, a default-user fallback admin account is utilized for storing the user data.","When the discreet login setting is disabled, a list of active users is displayed on the login screen. If enabled, a user must enter their handle manually.","You can't delete the default-user account from the users list because it is used for serving the user data in case if enableUserAccounts is set to false. But you can disable it to hide it from the list and disallow logins."]},{"l":"User handles","p":["A handle is the unique identifier of a user. It can consist only of lowercase letters, numbers, and dashes.","A path to the user data directory assumes using the following pattern: %DATA_ROOT%/%USER_HANDLE%.","Examples of valid user handles:","default-user","juan555","flux-the-cat","cool-guy1337"]},{"l":"Roles","p":["Admin- can manage (create, delete, modify) other users.","User- can't manage other users.","Except for having admin panel access, both user roles are functionally identical and can use a full range of SillyTavern features without any restrictions. An implementation of user permissions is TBD.","All user accounts are created as regular users first, and then could be promoted to admins if needed."]},{"l":"Login screen","p":["There you can select a user account to use. Has two styles, depending on the enableDiscreetLogin config value.","The login screen is bypassed and not displayed when you have only one active user and it is not password protected."]},{"l":"User profile","p":["You can access an account self-management menu using an \"Account\" button under the \"User settings\" panel in the top menu bar.","Display name - used in the login screen, can be changed. Does not correlate with personas and is not visible for the AI APIs - you can still use as many personas as you want.","Profile picture - used in the login screen. You can either use a custom picture, the default persona picture (if set), or the last used persona otherwise.","Password - a lock icon reflects the account protection status (open lock = no password). A password can be set, changed, or removed using the \"Change Password\" button.","Settings Snapshots - access and review the backups of your settings.json file, with the ability to create or restore snapshots.","Download Backup - download an archive of your user data folder.","Reset Settings - reset factory default settings, while leaving other data (character, chats) intact."]},{"l":"Password recovery","p":["A password can be recovered from a login screen. You need access to the server console to get a one-time recovery code (consisting of 4 digits).","Alternatively, you can use a utility script in the SillyTavern server to reset a password by providing the user handle."]}],[{"i":"single-sign-on-sso","l":"Single Sign-On (SSO)","p":["SSO allows you to create users and secure many different pages using a login portal presented on sites you want to secure. While it is complex to setup, it is a good way to both learn SSO and secure your ST instance out on the internet more.","Authelia and Authentik are open-source SSO providers that can be used with SillyTavern."]},{"l":"Sign in with SSO","p":["If your SSO-provided username exactly matches the username of a SillyTavern user account, you can sign in to SillyTavern as that user by SSO.","To do this, enable autheliaAuth in config.yaml.","This augments or replaces the built-in password management component of a multi-user mode setup."]},{"l":"Replacing HTTP BA","p":["SSO can also replace HTTP Basic Authentication as an access control mechanism for remote connections.","This is recommended because SSO provides better security and functionality than HTTP BA.","To use an SSO provider in place of HTTP BA, enable securityOverride in config.yaml. Otherwise, SillyTavern will refuse to start."]}],[{"l":"Remote connections","p":["Most often this is for people who want to use SillyTavern on their mobile phones while their PC runs the ST server within the same WiFi network.","It is also the first step for allowing remote connections from outside the local network.","You should not use port forwarding to expose your ST server to the internet. Instead, use a VPN or a tunneling service like Cloudflare Zero Trust, ngrok, or Tailscale. See the VPN and Tunneling guide for more information.","NEVER HOST ANY INSTANCES TO THE OPEN INTERNET WITHOUT ENSURING PROPER SECURITY MEASURES FIRST.","WE ARE NOT RESPONSIBLE FOR ANY DAMAGE OR LOSSES IN CASES OF UNAUTHORIZED ACCESS DUE TO IMPROPER OR INADEQUATE SECURITY IMPLEMENTATION."]},{"l":"Allowing remote connections","p":["By default, the ST server only accepts connections from the machine that it's running on (localhost). To allow it to listen for connections from other devices, set the listen option in config.yaml to true.","When ST is listening for remote connections, you should see this message in the console:","and some explanation about what that means.","When ST is not listening for remote connections, you should see this message in the console:"]},{"l":"Access control","p":["After activating the remote connection listening, you must turn on at least one access control method, or the server will refuse to start."]},{"l":"Access control by whitelist","p":["Create a new text file inside your SillyTavern base install folder called whitelist.txt.","Open the file in a text editor, add a list of IPs you want to be allowed to connect.","Each IP must be on its own line.","127.0.0.1 MUST be included in the list, or you will not be able to connect on the host machine","Individual IPs, and wildcard (*) IP ranges are accepted.","CIDR masks are also accepted (eg. 10.0.0.0/24).","Save the whitelist.txt file.","Restart your SillyTavern server."]},{"i":"example-whitelisttxt-files","l":"Example whitelist.txt files","p":["Allows any device on the local network to connect:","If you are not sure what addresses your local network uses, use the whitelist above.","Allows two specific devices to connect:","Allows any device on the 192.168.0.* subnet to connect:","Change whitelistMode to false, remove (or rename) whitelist.txt in the SillyTavern base install folder, and restart the server."]},{"l":"Access control by HTTP Basic Authentication","p":["HTTP Basic Authentication does not provide strong security.","There is no rate-limiting to prevent brute-force attacks. If this is a concern, it is recommended to use a reverse proxy with TLS and rate-limiting, and a dedicated authentication service.","The server will ask for username and password whenever a client connects via HTTP. This only works if the Remote connections (listen: true) are enabled.","To enable HTTP BA, Open config.yaml in the SillyTavern base directory and search for basicAuthMode Set basicAuthMode to true and set username and password. Note: config.yaml will only exist if ST has been executed before at least once.","Alternatively you can enable basic auth as follows:","In this perUserBasicAuth mode the basic auth's username and password will be the same as any valid multi user account that has a password. Additionally SillyTavern will login directly to that account. Ensure you have an account with a password prior to enabling perUserBasicAuth.","Save the file and restart SillyTavern if it was already running. You should be prompted for username and password when connecting to your ST. Both username and password are transmitted in plain text. If you are concerned about this, you can serve ST via HTTPS."]},{"l":"Connecting to your SillyTavern instance"},{"l":"Getting the IP address for the ST host machine","p":["After the whitelist has been setup, you'll need the IP of the ST-hosting device.","If the ST-hosting device is on the same wifi network, you will use the ST-host's internal wifi IP:","For Windows: windows button > type cmd.exe in the search bar > type ipconfig in the console, hit Enter > look for IPv4 listing.","If you (or someone else) wants to connect to your hosted ST while not being on the same network, you will need the public IP of your ST-hosting device.","While using the ST-hosting device, access this page and look for for IPv4. This is what you would use to connect from the remote device."]},{"l":"Connecting to the ST server","p":["Whatever IP you ended up with for your situation, you will put that IP address and port number into the remote device's web browser.","A typical address for an ST host on the same wifi network would look like:","http://192.168.0.5:8000","Use http:// NOT https://"]},{"l":"Connection logging","p":["New connections to the server are displayed in the console window and logged in the access.log file in the SillyTavern base directory.","A console message for a browser on the same machine as the server looks like:","A console message for a browser on a different machine on the same network as the server might look like:","If a connection is refused, the console message will look like:","access.log will contain the connection information, with timestamps, but not whether the connection was accepted or refused."]},{"l":"Troubleshooting","p":["Still unable to connect?","If the connection attempt appears in the console, but is forbidden, it is a whitelist issue.","If ST is listening for remote connections but the connection attempt does not appear in the console, it is a network issue.","If ST is not listening for remote connections, it is a reading issue."]},{"l":"Network issues","p":["On Windows, the application may be blocked by the application firewall. The quickest way to fix this is to uninstall and reinstall node.js, and when prompted by the firewall, allow it to access the network. Otherwise, you will need to manually allow the node.js application through the Windows application firewall.","On Windows 11, enable the Private Network profile type in Settings > Network and Internet > Ethernet. This is VERY important for Windows 11, otherwise, you would be unable to connect even with the aforementioned firewall rules.","On Linux, you may need to allow the port through the firewall. The command to do this is sudo ufw allow 8000. This will allow traffic on port 8000.","Do not modify the port forwarding settings on your router. This is not necessary for accessing ST within your local network, and can expose your server to the internet.","If you are trying to access your ST server from outside your local network, and it's not working, identify whether the problem is between the remote device and the tunnel/VPN endpoint, or between the tunnel endpoint on the server and the ST service. Otherwise you will spend a lot of time troubleshooting the wrong thing."]},{"l":"HTTPS"},{"i":"start-sillytavern-with-tlsssl","l":"Start SillyTavern with TLS/SSL","p":["To encrypt traffic from and to your ST instance, start the server with the --ssl flag.","Example:","As per default, ST will search for your certificates inside the certs folder. If your files are located elsewhere, you can use the --keyPath and --certPath arguments.","The user you're running SillyTavern with requires read permissions on the certificate files."]},{"l":"How to get a certificate","p":["The simplest, quickest way to get a certificate is by using certbot."]}],[{"l":"VPNs and Tunneling","p":["VPNs and tunnels are a secure way to access your home network from anywhere in the world. This guide will show you how to use a VPN or a tunnel to access your SillyTavern instance from anywhere."]},{"l":"Methods","p":["Use a home-made VPN.","Several routers come with the ability to host a VPN server (primarily OpenVPN or WireGuard) in the router administration page. Refer to your router's manual to setup a VPN and add your devices to the VPN. Once connected, just go to the private IP you have set for SillyTavern and you can connect just fine. Easier for users and for Windows use.","Use Cloudflare Zero Trust.","Cloudflare Zero Trust is a free organizational feature in Cloudflare that allows you to add 50 users. This will proxy your traffic through Cloudflare and by adding your ST PC as a tunnel using cloudflared, you can connect to your ST instance as if you were home.","Do note that after making a tunnel, you will have to add a route to your router's private IP addresses and calculate IP CIDR values to have full local access on the go using Cloudflare Zero Trust.","Use a standalone Cloudflare or ngrok tunnel.","Similar to how AI backends can connect, you can also connect your ST instance via a Cloudflare Tunnel and open the Cloudflare Tunnel page. However, you will have to copy and paste each new link generated by Cloudflare/NGROK each time you want to use ST on-the-go.","Use Tailscale.","Tailscale is a VPN provider enabling a secure remote connection to your PC."]},{"l":"Tailscale setup","p":["Tailscale is a VPN provider enabling a secure remote connection to your PC. An open-source implementation of the Tailscale server exists and you can also host the server using Headscale, but that is outside of the scope of this tutorial."]},{"l":"1. Creating an account","p":["Go to Tailscale's website and create a new account.","NOTE: For everyday use by a single person Tailscale will be permanently free. If you fear hidden costs, just don't add any payment options."]},{"l":"2. Setting up clients","p":["Go to Tailscale's download page and download the client/app on the device you have SillyTavern running on and on the device you want to use from a remote location.","Log in on both devices with your previously created account.","Go to Tailscale's admin page and approve both devices.","Take note of both of the connected devices' names."]},{"l":"3. Adding your devices to the whitelist","p":["Add your connecting device's machine name (the one you want to use SillyTavern with) to SillyTavern's whitelist by following Managing whitelisted IPs."]},{"l":"4. Connecting","p":["Now whenever you want to use SillyTavern from anywhere all you have to do is:","Have Tailscale turned on on both the PC hosting SillyTavern and your device that wants to use it remotely.","Open a browser on the device that wants to connect and go to http://machine name of PC running st:8000/"]},{"i":"5-sharing-sillytavern-instance-with-a-friend-optional","l":"5. Sharing SillyTavern instance with a friend (optional)","p":["Tell your friend to create their own Tailscale account and download the client on their device.","Go to Tailscale's admin page.","Hover over the three-dot button on your PC hosting SillyTavern and press \"Share...\" or press the three-dot button and press \"Sharing settings...\".","Uncheck \"Allow use as an exit node\" (unless you want your friend to be able to route all their internet traffic through your PC).","Either send the link as an email or change the tab to \"Copy share link\", press the big blue button with the same text, and send it to your friend in any other way.","After clicking your share link, your friend will see your PC pop up in their Tailscale network.","Send your friend the same link you use to access SillyTavern as explained in the last step.","NOTE: This will give your friend full access to any services running locally on your PC like SillyTavern, automatic1111, etc. Only do this if you truly trust your friend."]}],[{"l":"Reverse proxying","p":["This section does not refer to OpenAI/Claude reverse proxies. This refers exclusively to HTTP/HTTPS Reverse Proxies.","Is Termux confusing to setup? Are you tired of updating and installing ST on every device you have? Want organization of your chats and characters? Well you are in luck. This guide will hopefully cover how to host SillyTavern on your PC where you can connect from anywhere and chat to your bots on the same PC you use to run AI models!","This guide is not meant for beginners. This will be very technical."]},{"l":"Fair Warning","p":["This guide is not for Windows users. We recommend using a Linux VM or WSL2 to follow this guide.","You must have prior knowledge of","Linux console commands","DNS Records","Public IP addresses","Docker","You will have to buy a domain for yourself and configure a CNAME for your SillyTavern page. We suggest adding or buying the domain on Cloudflare as this guide will cover how to do this with Cloudflare itself."]},{"l":"Installation"},{"i":"linux-bare-metal-sillytavern","l":"Linux (Bare-Metal SillyTavern)","p":["A","Auto","Before enabling perUserBasicAuth ensure you have a valid multi-user setup with working passwords.","cd into appdata/traefik and using nano or a similar editor, create a file name config.yml and paste the following. Replace PRIVATE_IP with the private IP you obtained, and silly.DOMAIN.com with the name of your subdomain and domain page, then save the file.","cd into secrets/cloudflare and using nano or a similar editor, create a file named CF_DNS_API_KEY and paste your key inside.","Click on Continue to summary followed by Create Token.","Click on Create Token then Create Custom Token and make sure you give your token the following permissions.","CNAME","Copy the Token Key given to you and store it somewhere secure.","Create a acme.json file using touch and set the permissions of it to 600.","Create another record of the CNAME type, then click Save. Here is an example on how it should appear on the Cloudflare dashboard.","Do not install Docker Desktop.","DOMAIN.com","Enjoy! :D","Execute chown, replacing with your Linux username to set the permissions in the docker folder.","Follow the steps in Manage Docker as a non-root user in the Docker post-installation guide here.","For Linux, we will reverse proxying SillyTavern through Traefik. There are other options such as NGINX or Caddy, but for this guide, we will use Traefik as it is what we use ourselves.","Get the private IP of your computer using ifconfig or from your router.","Get your public IP of your modem by Googling what's my ip.","Go to your root folder in Linux and make a new folder named docker.","Go to your SillyTavern folder and edit config.yaml to enable listen mode and basic authentication, whilst disabling whitelistMode.","If nothing happens after several minutes, check the container logs for Traefik for any possible errors.","Install Docker by following the Docker installation guide here.","It is recommended to set your private IP to a Static IP. Refer to your router's manual or Google to configure static IPs.","Login to Cloudflare and click on your Domain, followed by Get your API token.","Make a folder inside the docker folder, that being appdata and inside appdata being traefik. Enter the appdata/traefik folder afterwards.","Make a folder inside the docker folder, that being secrets and inside secrets being cloudflare.","Make sure to change the default username and password to something strong that you can remember.","Most residential/home networks use Dynamic IPs which are renewed after months of use. If you have a dynamic IP, use either DDClient or remember to check and change your public IP ever so often on the Cloudflare Dashboard.","N/A","Name (required)","Or to use the SillyTavern accounts as usernames and passwords:","Proxied","Proxy Status","PUBLIC_IP","Return back to the docker folder.","Return to your domain page and go to DNS. Create a new record using Add record and create two A type keys like the ones below. Replace PUBLIC_IP with your own public IP, then click Save.","Run Docker Compose using the following commands:","silly","Target (required)","TTL","Type","Using nano or a similar editor, create a file name docker-compose.yaml and paste the following. Save the file afterwards.","Using nano or a similar editor, create a file name traefik.yml and paste the following. Replace the template email with your own, then save the file.","Wait a few minutes, then open your domain page you made for ST. At the end of it, you should be able to open SillyTavern from anywhere you go just with one URL and one account.","www","Zone -> DNS -> Edit","Zone -> Zone -> Read"]},{"i":"linux-docker-sillytavern","l":"Linux (Docker SillyTavern)","p":["A","Auto","cd into secrets/cloudflare and using nano or a similar editor, create a file named CF_DNS_API_KEY and paste your key inside.","Click on Continue to summary followed by Create Token.","Click on Create Token then Create Custom Token and make sure you give your token the following permissions.","CNAME","Copy the Token Key given to you and store it somewhere secure.","Create another record of the CNAME type, then click Save. Here is an example on how it should appear on the Cloudflare dashboard.","Do note that we run SillyTavern on bare-metal over Docker. This is a rough idea of what we would do on Docker with other Docker containers we tend to use with ST.","DOMAIN.com","Enjoy! :D","Follow Steps 1-11 of Linux (Bare-Metal SillyTavern).","Git clone SillyTavern into the docker folder.","Go to your SillyTavern folder ( appdata/sillytavern/config) and edit config.yaml to enable listen mode and basic authentication, whilst disabling whitelistMode.","If nothing happens after several minutes, check the container logs for Traefik for any possible errors.","Login to Cloudflare and click on your Domain, followed by Get your API token.","Make sure to change the default username and password to something strong that you can remember.","N/A","Name (required)","Proxied","Proxy Status","PUBLIC_IP","Return to your domain page and go to DNS. Create a new record using Add record and create two A type keys like the ones below. Replace PUBLIC_IP with your own public IP and the example domain with your domain, then click Save.","Run Docker Compose using the following commands:","silly","Start the SillyTavern Docker container again.","Stop the SillyTavern Docker container.","Target (required)","TTL","Type","Using nano or a similar editor, create a file name docker-compose.yaml and paste the following. Replace silly.DOMAIN.com with the subdomain you added above, the save the file afterwards.","Wait a few minutes, then open your domain page you made for ST. At the end of it, you should be able to open SillyTavern from anywhere you go just with one URL and one account.","www","Zone -> DNS -> Edit","Zone -> Zone -> Read"]},{"l":"Updating your Cloudflare DNS","p":["DDClient allows you to sync your public IP to Cloudflare in the situation that your ISP changes it, allowing you to continue accessing your ST instance as if nothing ever happened."]}],[{"l":"License and credits","p":["This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.","See the GNU Affero General Public License for more details.","Original TavernAI 1.2.8 by Humi: MIT License"]},{"i":"pre-v190-contributors","l":"Pre-v1.9.0 Contributors","p":["The git commit history was squashed to the state of release 1.9.0.","Unfortunately, losing commit history also means losing the code contribution history. If you contributed to the SillyTavern development and want to see yourself credited in the README file and Docs website, please get in touch with us!"]},{"l":"Documentation Contributors","p":["Click the image below to see the full list of SillyTavern documentation contributors.","Contributors"]}]]
\ No newline at end of file
+[[{"i":"what-is-sillytavern","l":"What is SillyTavern?","p":["SillyTavern - LLM Frontend for Power Users","SillyTavern (or ST for short) is a locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models. Our goal is to empower users with as much utility and control over their LLM prompts as possible, embracing the steep learning curve as part of the fun.","SillyTavern is a passion project brought to you by a dedicated community of LLM enthusiasts and will always be free and open-sourced. Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 100 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists."]},{"l":"Screenshots","p":["API Connection","Chat UI","Advanced Formatting","World Info"]},{"l":"Installation Requirements","p":["The hardware requirements are minimal: it will run on anything that can run NodeJS 18 or higher. If you intend to do LLM inference on your local machine, we recommend a 3000-series NVIDIA graphics card with at least 6GB of VRAM.","Follow the installation guide for your platform:","Windows","Linux and Mac","Android","Docker"]},{"l":"Branches","p":["SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.","release-\uD83C\uDF1F Recommended for most users. This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users. Typically updated once a month.","staging- ⚠️ Not recommended for casual use. This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts. Updates several times daily."]},{"i":"what-do-i-need-other-than-sillytavern","l":"What do I need other than SillyTavern?","p":["Since SillyTavern is only an interface, you will need access to an LLM backend to provide inference. You can use AI Horde for instant out-of-the-box chatting. Aside from that, we support many other local and cloud-based LLM backends: OpenAI-compatible API, KoboldAI, Tabby, and many more. You can read more about our supported APIs in the API Connections section."]},{"l":"Character Cards","p":["SillyTavern is built around the concept of \"character cards\". A character card is a collection of prompts that set the behavior of the LLM and is required to have persistent conversations in SillyTavern. They function similarly to ChatGPT's GPTs or Poe's bots. The content of a character card can be anything: an abstract scenario, an assistant tailored for a specific task, a famous personality or a fictional character.","The name field is the only required character card input. To start a neutral conversation with the language model, create a new card simply called \"Assistant\" and leave the rest of the boxes blank. For a more themed chat, you can provide the language model with various background details, behavior and writing patterns, and a scenario to jump start the chat.","To have a quick conversation without selecting a character card or to just test the LLM connection, simply type your prompt input into the input bar on the Welcome Screen after opening SillyTavern. Please note that such chats are temporary and will not be saved.","To get a general idea on how to define character cards, see the default character (Seraphina) or download selected community-made cards from the \"Download Extensions & Assets\" menu.","You can also create your own character cards from scratch. Refer to the Character Design guide for more information."]},{"l":"Key Features","p":["Advanced text generation settings with many community-made presets","World Info support: create rich lore or save tokens on your character card","Group chats: multi-bot rooms for characters to talk to you and/or each other","Rich UI customization options: theme colors, background images, custom CSS, and more","User personas: let the AI know a bit about you for greater immersion","Built-in RAG support: add documents to your chats for the AI to reference","Extensive chat commands subsystem and own scripting engine"]},{"l":"Extensions","p":["SillyTavern has extensibility support.","Character emotional expressions (sprites)","Auto-Summary of the chat history","Automatic UI and chat translation","Stable Diffusion/FLUX/DALL-E image generation","Text-to-speech for AI response messages (via ElevenLabs, Silero, or the OS's System TTS)","Web Search capabilities for adding additional real world context to your prompts","Many more are available to download from the \"Download Extensions & Assets\" menu."]},{"i":"how-can-i-get-in-touch-with-the-developers-directly","l":"How can I get in touch with the developers directly?","p":["Discord: cohee, rossascends, wolfsblvt","Reddit: /u/RossAscends, /u/sillylossy, u/Wolfsblvt","Post a GitHub issue"]},{"i":"i-like-your-project-how-do-i-contribute","l":"I like your project! How do I contribute?","p":["We welcome pull requests! Follow the Contribution Guidelines to get started.","We also welcome helpful and informed bug reports that use the templates provided in our GitHub.","We do not accept monetary donations for the project itself."]},{"l":"Personal Donations","p":["Your support for individual contributors is appreciated, but it will not influence the overall development direction of SillyTavern.","RossAscends has a personal Patreon& Kofi"]},{"l":"License","p":["SillyTavern is a free and open-source project released under the AGPL-3.0 License."]}],[{"l":"Installation","p":["Follow the installation guide for your platform:","Windows","Linux and Mac","Android","Docker"]},{"l":"Branches","p":["SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.","release-\uD83C\uDF1F Recommended for most users. This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users. Typically updated once a month.","staging- ⚠️ Not recommended for casual use. This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts. Updates several times daily."]}],[{"l":"Windows Installation","p":["DO NOT INSTALL INTO ANY WINDOWS CONTROLLED FOLDER (Program Files, System32, etc).","DO NOT RUN START.BAT WITH ADMIN PERMISSIONS","INSTALLATION ON WINDOWS 7 IS IMPOSSIBLE AS IT CAN NOT RUN NODEJS 18.16"]},{"l":"Installing via Git","p":["Install NodeJS(latest LTS version is recommended)","Install Git for Windows","Open Windows Explorer ( Win+E)","Browse to or Create a folder that is not controlled or monitored by Windows. (ex: C:\\MySpecialFolder)","Open a Command Prompt inside that folder by clicking in the 'Address Bar' at the top, typing cmd, and pressing Enter.","Once the black box (Command Prompt) pops up, type ONE of the following into it and press Enter:","for Release Branch: git clone https://github.com/SillyTavern/SillyTavern -b release","for Staging Branch: git clone https://github.com/SillyTavern/SillyTavern -b staging","Once everything is cloned, double-click Start.bat to make NodeJS install its requirements.","The server will then start, and SillyTavern will pop up in your browser."]},{"l":"Installing via SillyTavern Launcher","p":["On your keyboard: press WINDOWS + R to open Run dialog box. Then, run the following command to install git:","On your keyboard: press WINDOWS + E to open File Explorer, then navigate to the folder where you want to install the launcher. Once in the desired folder, type cmd into the address bar and press enter. Then, run the following command:"]},{"l":"Installing via GitHub Desktop","p":["(This allows git usage only in GitHub Desktop, if you want to use git on the command line too, you also need to install Git for Windows)","Install NodeJS(latest LTS version is recommended)","Install GitHub Desktop","After installing GitHub Desktop, click on Clone a repository from the internet....(Note: You do NOT need to create a GitHub account for this step)","image","On the menu, click the URL tab, enter this URL https://github.com/SillyTavern/SillyTavern, and click Clone. You can change the Local path to change where SillyTavern is going to be downloaded.","To open SillyTavern, use Windows Explorer to browse into the folder where you cloned the repository. By default, the repository will be cloned here: C:\\Users\\[Your Windows Username]\\Documents\\GitHub\\SillyTavern","Double-click on the start.bat file. (Note: the .bat part of the file name might be hidden by your OS, in that case, it will look like a file called \" Start\". This is what you double-click to run SillyTavern)","After double-clicking, a large black command console window should open and SillyTavern will begin to install what it needs to operate.","After the installation process, if everything is working, the command console window should look like this and a SillyTavern tab should be open in your browser:","Connect to any of the supported APIs and start chatting!"]}],[{"i":"linuxmacos-install","l":"Linux/MacOS Install"},{"l":"Manual Git install","p":["For MacOS / Linux all of these will be done in a Terminal.","Install git and nodeJS (the method for doing this will vary depending on your OS)","Clone the repo","for Release Branch: git clone https://github.com/SillyTavern/SillyTavern -b release","for Staging Branch: git clone https://github.com/SillyTavern/SillyTavern -b staging","cd SillyTavern to navigate into the install folder.","Run the start.sh script with one of these commands:","./start.sh","bash start.sh"]},{"l":"SillyTavern Launcher"},{"l":"For Linux users","p":["Open your favorite terminal and install git","Download Sillytavern Launcher with: git clone https://github.com/SillyTavern/SillyTavern-Launcher.git","Navigate to the SillyTavern-Launcher with: cd SillyTavern-Launcher","Start the install launcher with: chmod +x install.sh ./install.sh and choose what you wanna install","After installation start the launcher with: chmod +x launcher.sh ./launcher.sh"]},{"l":"For Mac users","p":["Open a terminal and install brew with: /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)","Then install git with: brew install git","Download Sillytavern Launcher with: git clone https://github.com/SillyTavern/SillyTavern-Launcher.git","Navigate to the SillyTavern-Launcher with: cd SillyTavern-Launcher","Start the install launcher with: chmod +x install.sh ./install.sh and choose what you wanna install","After installation start the launcher with: chmod +x launcher.sh ./launcher.sh"]}],[{"i":"android-termux-installation","l":"Android (Termux) Installation","p":["SillyTavern can be run natively on Android phones using Termux.","Please refer to this guide by ArroganceComplex#2659:","https://rentry.org/STAI-Termux"]},{"l":"Common errors"},{"i":"unsupported-platform-android-arm-letime-web","l":"Unsupported platform: android arm LEtime-web","p":["32-bit Android requires an external dependency that can't be installed with npm.","Use the following command to install it:","pkg install esbuild","Then run the steps from the guide."]}],[{"l":"Docker Installation","p":["This guide assumes you installed SillyTavern in a non-root (non-admin) folder. If you installed SillyTavern in a root folder, you may have to run some of these commands with administrator rights [sudo, doas, Command Prompt (Administrator)]."]},{"l":"Installation"},{"l":"Linux","p":["Add a new line below 127.0.0.1 and put in the IP you copied from Docker. It should look something similar to the following afterwards.","Arch Linux (Manjaro/EndeavourOS/etc.)","Clone the SillyTavern repository.","Copy down the IP you see in Gateway as this will be important.","Debian (Ubuntu/Pop! OS/etc.)","Do not install Docker Desktop.","Enjoy! :D","Execute docker compose by running the following command within the Docker folder.","Execute the following Docker command to obtain the IP of your SillyTavern Docker container.","Fedora, Red Hat Enterprise Linux (RHEL), etc.","Follow the steps in Manage Docker as a non-root user in the Docker Post-Installation Guide.","Install Docker by following the Docker installation guide here.","Install Git using your package manager.","Note that if you configured Docker network as a bridge, you could also add external IP addresses to the whitelist as usual.","Open an new browser and go to http://localhost:8000. You should see SillyTavern load in a few moments.","Release (Stable Branch)","Restart the Docker Container to apply the new configuration.","Save the file by pressing Ctrl+S then exit nano by pressing Ctrl+X.","Staging (Development Branch)","Using sudo, open nano and run the following command.","Within nano, go down to whitelist. You should see something similar to the following below.","You should receive some sort of output similar to the following below."]},{"l":"Windows","p":["Add a new line below 127.0.0.1 and put in the IP you copied from Docker. It should look something similar to the following afterwards.","Clone the SillyTavern repository.","Copy down the IP you see in Gateway as this will be important.","Enjoy! :D","Execute docker compose by running the following command within the Docker folder.","Execute the following Docker command to obtain the IP of your SillyTavern Docker container.","Install Docker Desktop by following the Docker installation guide here.","Install Git for Windows.","It is highly suggested you install SillyTavern by following our Windows guide. This section is a rough idea of how it can be done on Windows.","Note that if you configured Docker network as a bridge, you could also add external IP addresses to the whitelist as usual.","Open an new browser and go to http://localhost:8000. You should see SillyTavern load in a few moments.","Release (Stable Branch)","Restart the Docker Container to apply the new configuration.","Running Notepad or a code editor of your choice with administrator rights, go to config and open config.yaml.","Save the file by pressing Ctrl+S then exit your editor.","Staging (Development Branch)","Using Docker on Windows is really complicated. Not only do you need to activate Windows Subsystem for Linux within Turn Windows features on or off, but also configure your system for Virtualization (Intel VT-d/AMD SVM) which differs from PC manufacturer to PC manufacturer (or motherboard manufacturer). Sometimes, this option is not present on some systems.","Within the editor of your choice, you should see something similar to the following below.","You should receive some sort of output similar to the following below."]},{"l":"macOS","p":["Add a new line below 127.0.0.1 and put in the IP you copied from Docker. It should look something similar to the following afterwards.","Clone the SillyTavern repository.","Copy down the IP you see in Gateway as this will be important.","Enjoy! :D","Even though macOS is similar to Linux, it doesn't have the Docker Engine. You will have to install Docker Desktop similarly to Windows. You will also need to install Homebrew in order to install Git on your Mac. This section is a rough idea on how it can be done on macOS.","Execute docker compose by running the following command within the Docker folder.","Execute the following Docker command to obtain the IP of your SillyTavern Docker container.","If you can't run nano, either install it via Homebrew or use TextEdit.","Install Docker Desktop by following the Docker installation guide here.","Install git using Homebrew.","Note that if you configured Docker network as a bridge, you could also add external IP addresses to the whitelist as usual.","Open an new browser and go to http://localhost:8000. You should see SillyTavern load in a few moments.","Release (Stable Branch)","Restart the Docker Container to apply the new configuration.","Save the file by pressing Ctrl+S then exit nano by pressing Ctrl+X.","Staging (Development Branch)","Using sudo, open nano and run the following command.","Within nano, go down to whitelist. You should see something similar to the following below.","You should recieve some sort of output similar to the following below."]},{"l":"Configuring SillyTavern","p":["SillyTavern's configuration file (config.yaml) will be located within the config folder. Configuring the config file should be no different than configuring it without Docker, however you will need to run nano or a code editor with administrator rights in order to save your changes.","Don't forget to restart the Docker container for SillyTavern in order to apply your changes! Make sure you execute this command within the docker folder."]},{"l":"Locating User Data","p":["SillyTavern's data folder will be within the data folder. Backing up your files should be easy to do, however, restoring or adding content into it may require you to do so with administrator rights."]},{"l":"Running Server Plugins","p":["Running plugins like HoYoWiki-Scraper-TS or SillyTavern-Fandom-Scraper within Docker is no different from running it on your system without Docker, however we will need to do a slight modification to the Docker Compose script in order to do so.","If you already see a plugins folder within the docker folder, you can skip Steps 1-2.","Using nano or a code editor, open docker-compose.yml and add the following line below volumes.","Create a new folder within the docker folder called plugins.","Follow your plugin's instructions on installing the plugin.","Using nano or a code editor with administrator rights, open config.yaml(within the config folder) and enable enableServerPlugins","Restart the Docker container.","Profit."]}],[{"l":"How to Update SillyTavern","p":["Find your OS below and follow the instructions to update ST.","This guide assumes you have already installed and run SillyTavern at least once."]},{"i":"linuxtermux-or-macos","l":"Linux/Termux or MacOS","p":["You definitely installed via git, so just 'git pull' inside the SillyTavern directory.","cd SillyTavern to enter the correct folder.","git pull to get the update.","./start.sh or bash start.sh to start ST."]},{"l":"Windows","p":["First try using the UpdateAndStart.bat which is located in your SillyTavern installation base folder.","If that fails, come back here and continue reading."]},{"i":"method-1---git","l":"Method 1 - GIT","p":["We always recommend users install using 'git'. Here's why:","When you have installed via git clone, all you have to do to update is type git pull in a command line in the ST folder. Alternatively, if the command prompt gives you problems (and you have GitHub Desktop installed), you can use the Repository menu and select Pull.","The updates are applied automatically and safely."]},{"i":"help-i-originally-installed-via-zip-and-now-want-to-convert-to-git-install","l":"\"Help I originally installed via Zip and now want to convert to Git install\"","p":["You have chosen a wise path.","Since your installation was done via Zip, you will need to make a new install using git.","Thankfully we have instructions on how to do so.","Once you have used git to install a NEW SillyTavern into a DIFFERENT folder, come back to this page and proceed to Step 4 of the 'Zip Update' instructions below."]},{"i":"method-2---zip","l":"Method 2 - ZIP","p":["(*) 'As necessary' = \"If you made any custom content related to those folders\".","1.12.0 includes an automated migration procedure. The steps below are required only if the migration was interrupted or errored.","Copy the /data directory and config.yaml file from one installation to another.","Copy the following files/folders as necessary(*) from your old ST installation:","Do the usual setup procedure for your OS to install NodeJS requirements.","Doing so could break the new install and prevent new features from being present.","Download the new release zip.","If everything shows up, you can safely delete the old ST folder.","If you insist on installing via a zip, here is the tedious process for doing the update:","None of the folders are mandatory, so only copy what you need.","NOTE: DO NOT COPY THE ENTIRE /PUBLIC/ FOLDER","Once those folders/files are copied, paste them into the /data/default-user folder (with secrets.json going into the folder root) of the new install.","Run the updated server install at least once to create the /data/default-user directory.","Start SillyTavern once again with the method appropriate to your OS, and pray you got it right.","Transfer the files from old /public to new /data/default-user as necessary.","Unzip it into a folder OUTSIDE of your current ST installation."]},{"l":"Common Update Problems"},{"i":"i-use-docker-and-all-my-data-is-gone-after-the-update","l":"I use Docker and all my data is gone after the update!","p":["You must follow the Migration guide for Docker containers to update volume mappings for the new data model introduced in 1.12.0"]},{"i":"there-are-unresolved-conflicts-in-the-working-directory","l":"\"There are unresolved conflicts in the working directory.\"","p":["This means that you've modified default files that have been changed in the remote repository (such as setting presets).","To fix this, run this in the terminal. Use cautiously, as it can be destructive. Make sure to have a backup if needed."]},{"l":"File changes prevent git pull","p":["If you change SillyTavern system files, git pull may not work.","Sometimes an update may require us to change an important file, which can cause the same problem.","Usually it is default preset files or package-lock.json.","In this case you can try moving the file to a different folder (or deleting the file) and then do git pull.","Another solution is using git pull --rebase --autostash"]},{"i":"error-cannot-find-module--when-starting-the-server","l":"Error: Cannot find module \"***\" when starting the server","p":["This means that SillyTavern added a new npm package requirement.","Run npm install in the SillyTavern directory to fix this. Provided Start.bat and start.sh scripts will do that automatically.","Didn't help? Remove the node_modules folder","Windows","Unix/Linux"]}],[{"i":"1120-migration-guide","l":"1.12.0 Migration Guide","p":["SillyTavern 1.12.0 (codename the \"Neo Server\" update) includes several critical changes that may affect the way you use SillyTavern.","This guide will prepare you for the update and provide some further guidance."]},{"l":"Data storage update","p":["1.12.0 changes the way SillyTavern handles the user data.","Previously, all of the persistent data was stored together with the frontend part in the /public directory, which created confusion and potential points of failure, as well as making containerization and system-wide app installation quite challenging."]},{"i":"whats-changed","l":"What's changed?","p":["All persistent information from /public such as settings and chats (full list below) was moved into a separate directory with the configurable path, making it portable and independent from the web server itself. When needed for compatibility purposes, for example, for hosting extensions, full-size character cards, user image uploads, etc. a smart redirect has been set up to automatically host user files from the data directory."]},{"l":"Setting a data root","p":["You can provide either an absolute or a relative (to the ST repository directory) path to the data root either by config.yaml or by starting the server with the --dataRoot console argument.","YAML example","Console example","The default data root path is ./data, which means the data directory in SillyTavern's repository.","The data root path should be either a full absolute or a full relative path. You can't use path shortcuts like ~ or %APP_DATA%, as these are resolved by a shell, not the operating system."]},{"l":"Migration"},{"i":"important-before-we-begin","l":"IMPORTANT! Before we begin","p":["Only if you want to move dataRoot from the default location. Otherwise, skip this part. Set the data root before first running the server after pulling an update. Run npm install for the config.yaml to populate with a new value, or pass a console argument.","All data will be migrated into a default-user account. See more on Users below."]},{"i":"containerless-bare-metal-installs","l":"Containerless (bare metal) installs","p":["You don't have to do anything! An automatic migration should handle everything for you when you start the ST server and it detects the old storage format (by checking the existence of the /public/characters directory).","Upon moving any files, an automatic backup will be created in the /backups/_migration/YYYY-MM-DD(resolved to the current date) directory, but it is always a good practice to make a full manual backup before running the migration."]},{"i":"containerized-docker-installs","l":"Containerized (Docker) installs","p":["Migrating the data in Docker volumes is a bit trickier but pretty straightforward. While docker-compose.yml provided with the repo was updated to reflect the changes, you may need to adjust your custom workflows/deployments.","Step 1. Create a new volume, and mount it to the \"/home/node/app/data\" path within the container. Don't remove the config volume.","Step 2. Move everything but the config.yaml file from the config volume into the default-user subdirectory of the data volume.","Step 3. Rebuild the container and start it up.","Soft links between the /public directory and the config volume are no longer needed and are not built into the Docker container!"]},{"i":"what-to-migrate","l":"What to migrate?","p":["/data/default-user/assets","/data/default-user/backgrounds","/data/default-user/characters","/data/default-user/chats","/data/default-user/content.log","/data/default-user/context","/data/default-user/extensions","/data/default-user/group chats","/data/default-user/groups","/data/default-user/instruct","/data/default-user/KoboldAI Settings","/data/default-user/movingUI","/data/default-user/NovelAI Settings","/data/default-user/OpenAI Settings","/data/default-user/QuickReplies","/data/default-user/secrets.json","/data/default-user/settings.json","/data/default-user/stats.json","/data/default-user/TextGen Settings","/data/default-user/themes","/data/default-user/thumbnails","/data/default-user/vectors","/data/default-user/worlds","/default/content/content.log","/public/assets","/public/backgrounds","/public/characters","/public/chats","/public/context","/public/group chats","/public/groups","/public/instruct","/public/KoboldAI Settings","/public/movingUI","/public/NovelAI Settings","/public/OpenAI Settings","/public/QuickReplies","/public/scripts/extensions/third-party","/public/settings.json","/public/stats.json","/public/TextGen Settings","/public/themes","/public/worlds","/secrets.json","/thumbnails","/vectors","After","Before","The following files and directories are subject to the data migration. Assuming the default configuration, the before and after paths are provided in the table below."]},{"l":"Users","p":["1.12.0 adds a (completely optional) ability to create a multi-user setup on the same server, allowing multiple users to use their own fully isolated SillyTavern instances even at the same time. User accounts can also be password-protected for an additional layer of privacy.","Please refer to the Users documentation for more information."]}],[{"i":"190-migration-guide","l":"1.9.0 Migration Guide"},{"i":"how-to-migrate-to-a-new-branch-if-i-use-maindev","l":"How to migrate to a new branch if I use main/dev?","p":["It is recommended to do a fresh install. However, if you wish to use an existing copy of SillyTavern, please follow the instructions below.","IMPORTANT! Before doing anything, make a complete backup of your installation. You may lose your data in the process, so don't ignore this warning.","Not sure of which files to back up? See the list here: How to Update SillyTavern"]},{"l":"git installs","p":["Open a terminal prompt (cmd, PowerShell, Termux, etc) in your SillyTavern installation folder.","Type git fetch and then git pull to pull the updates.","You may lose your settings. Have you made a backup? git switch release or git switch staging will change your branch, respectively","Skip to next item if you have no errors. You may have something like:","You will see a list of files affected. If you do not care about those settings files being replaced git switch -f release or git switch -f staging will set your branch. If you do care to save those changes restore from backup.","Type npm install and then npm run start to test that everything behaves correctly.","Enjoy! Restore your data from a backup if needed."]},{"i":"fatal-invalid-reference-release","l":"fatal: invalid reference: release","p":["This may happen if you cloned just a single branch from an old remote (before migration to the organization repo). To fix this, you need to add and fetch a branch from a new remote:","Then proceed from step 5."]},{"l":"ZIP installs","p":["Nothing changes for you. Just download the branch/release ZIP like usual."]}],[{"l":"Usage","p":["Add new features and capabilities to the AI or the interface","API Connections","Automate tasks, let your AI interact with the world, and write your own extensions","Characters and Personas","Chatting","Connect to AI models for generating text, images, and more","Control the requests that you send to the AI and how it responds","Create and use characters to shape the AI's role, and personas to define your identities","Data Bank","Development and Automation","Extensions","FAQ","Frequently asked questions about SillyTavern, AI models, making characters, getting better responses, and more","How to chat with the AI and use the chat interface","Interact with AI, your way. Build your world, your work, or your dreams.","Manage information and when to insert it into the prompt","Quick Start","Response Configuration and Prompts","Send your first message to the AI and get a response","Store and retrieve information for use in the AI's responses","World Info"]},{"l":"Control Panels","p":["Add new features and capabilities to the AI or the interface","Advanced Formatting","API Connections","Backgrounds","Change the background image","Change the theme, and the look and feel of messages and chats","Characters","Connect to AI models for generating text, images, and more","Control text generation and sampling. Customize prompt construction for Chat Completion APIs.","Create and manage characters for the AI to use","Create and manage personas to use with the AI","Customize prompt construction for Text Completion APIs","Extensions","Manage information and when to insert it into the prompt","Personas","Response Configuration and Prompt Manager","User Settings","What all the buttons do, from the left to the right:","World Info"]}],[{"l":"Quick Start","p":["I'm clueless. Just spoonfeed me the easiest and fastest way I can start using SillyTavern. -- Anonymous","You can get started with SillyTavern in just a few minutes. Here are two easy ways to get started:","You can use AI Horde for free. AI Horde is a community-driven AI service that provides access to a variety of AI models.","If you have an OpenAI account or want to register one, you can use OpenAI."]},{"l":"Quick start with AI Horde","p":["Follow the Installation Guide to install and start SillyTavern.","In SillyTavern's onboarding screen, enter a name for your persona. This name will be used in the chat.","This is an optional caption","Click the API Connections button in the top bar.","Enter an API key for AI Horde. You can use 0000000000 for now, or get a free key from AI Horde.","Select some AI models to use. Just choose a few from the top. You can always change them later.","Close the API Connections window. Enter a message in the chat box at the bottom and press Enter.","Your AI will respond in a few moments. You can continue chatting with it. Success!"]},{"l":"Quick start with OpenAI"},{"l":"Install SillyTavern","p":["Follow the Installation Guide to install and start SillyTavern."]},{"l":"Get access to OpenAI","p":["Sign up to OpenAI.","Go to https://platform.openai.com","Click your account icon in the top right, then View API Keys.","Click \"Create new secret key\". Copy it somewhere immediately. DO NOT SHARE THIS KEY. WHOEVER HAS IT CAN USE YOUR ACCOUNT TO USE GPT AT YOUR EXPENSE."]},{"l":"Configure SillyTavern to use your API","p":["In SillyTavern's top bar, click API Connections.","Under API, select Chat Completion (OpenAI).","Under Chat Completion Source, select OpenAI.","Paste the API key you saved in the previous step.","Click the Connect button. Confirm it says Valid.","By default, SillyTavern will use GPT-4 Turbo. You can choose a different model, but educate yourself on the pricing."]},{"l":"Test your setup","p":["In SillyTavern's top bar, click Character Management at the far right.","Select an existing character such as Seraphina.","In the text box at the bottom, write something to Seraphina, then press Enter or click the Send button.","If you did everything right, after a few seconds, Seraphina should respond."]}],[{"l":"FAQ"},{"l":"Explain what SillyTavern is about","p":["Modern AI language models such as ChatGPT have gotten so powerful that some of them are now convincingly able to simulate a character you create, and who you can chat with, write fiction with, etc. For example, you can tell the AI to pretend to be a Go instructor named Jubei from medieval Japan, and it will act and respond accordingly. You can have a long chat with Jubei, go to the pub together, decide to get in a fight with samurais, whatever you can imagine, and the AI will play along and write/react around this content, acting as your foil and dungeon master. Your imagination is the limit. You can tell the AI to pretend it's Wonder Woman. You can also specify a scenario (\"Wonder Woman and I are robbing a bank\"), a writing style (\"Wonder Woman speaks in ebonics\"), or anything else you can think of.","SillyTavern is an app to facilitate these uses:","It's a user interface that handles communication with AI language models.","It lets you create new character cards (prompts), and switch between them easily.","It lets you import characters created by other people.","It will keep your chat history with a character, allowing you to resume at any time, start a new chat, review old chats, etc.","In the background, it does the necessary things to prepare the AI prompt for you. Specifically, it will send a system prompt (instructions for the AI) that primes the AI to follow certain rules to improve response accuracy."]},{"l":"Give me an overview of my AI model options","p":["SillyTavern can interact with two types of AI:","Web services(Cloud-based, usually paid, proprietary, closed)","Self-hosted(local, free, open-source)"]},{"l":"Paid web service AIs","p":["Paid web models are black boxes. You pay a company to use their AI service. You put your account info in SillyTavern and it will connect to your provider to use the AI on your behalf.","Pros:","Really easy to get started.","Highest quality AI writing.","Cons:","They cost money to use.","Everything is logged on their server. Privacy concerns.","They are often censored and will refuse to chat with you about certain subjects."]},{"l":"Self-hosted AIs","p":["Self-hosted models are free models you can run on your PC but require a powerful PC and more work to set up.","Pros:","Once you set them up, they can be used for free even without Internet access.","Total privacy. Everything you write stays on your own PC.","There's a wide variety of models. As a community-driven technology, you can find models that fit certain tasks or behaviors that you want.","Cons:","They are not as capable as SOTA models (i.e., they write worse dialog, are less creative, etc).","Running local models requires a GPU with at least 6GB VRAM.","If you are interested in using these, refer to the dedicated guide here: How To Use A Self-Hosted Model."]},{"i":"can-i-use-sillytavern-on-my-phone-or-tablet","l":"Can I use SillyTavern on my phone or tablet?","p":["iPhones and iPads are not capable of running the whole SillyTavern app, but since it's just a web interface, you can run it on another computer on your home Wi-Fi, and then access it in your mobile browser. Refer to Remote Connections for more information.","For Android users, in addition to the above, you can run the whole SillyTavern directly on your phone, without needing a PC, using the Termux app. Refer to Installation (Android). (NOTE: Termux installations are not officially supported, and we can't guarantee it will work.)"]},{"i":"i-tried-to-import-a-png-character-card-but-got-an-error-that-its-invalid-why","l":"I tried to import a PNG character card but got an error that it's invalid. Why?","p":["Two possibilities:","The card did not have the definitions embedded inside it and was just a normal image file. Some programs or file managers will strip the embedded definitions from the card when you save them. Make sure you're using the raw PNG file as it was posted by the person who shared it.","The PNG file was actually a WEBP file with a .png filename. You can try renaming the card to .webp before importing, or look for a proper PNG version of the image."]},{"i":"how-can-i-make-my-own-ai-character","l":"How can I make my own AI character?","p":["Click the Character Management button","Click Create New Character","Under Character Name, give a name, like Amanda","Optionally, click the Select Avatar button to pick an image portrait for this character","Under Description, describe the character, and include any information you want that you feel is relevant to the chat. For example: Amanda is a student traveling during her gap year. She's 6 feet tall, and a volleyball player. She has an athletic figure. She has long brown hair. She loves the Victorian England period, and watching TV and reading novels relating to that period. For example, if you want Amanda to be friendly, then you would add: Amanda is extremely cheerful and outgoing.","Under First Message, write the greeting the character when you begin a new chat. For example: *Amanda waves at you* Hey! Are you a backpacker too?","Click the Create Character button","You now have a basic character you can chat with. Select Amanda from the character list, and a new chat will begin.","Note that you can use the Description and/or First Message to create a more specific scenario, and/or include yourself in the description. For example:","Any relevant information you include can be used. How well it's used depends on the power level of the AI model.","NOTE: you can go back and edit any of this information once the character is created, except the name."]},{"i":"where-are-my-api-keys-stored-why-cant-i-see-them","l":"Where are my API keys stored? Why can't I see them?","p":["SillyTavern saves your API keys to a secrets.json file in the server directory.","By default, they will not be exposed to a frontend after you enter them and reload the page.","To enable viewing your keys by clicking a button in the API block:","Set the value of allowKeysExposure to true in the config.yaml file.","Restart the SillyTavern server."]},{"i":"why-is-the-ui-so-slowjittery","l":"Why is the UI so slow/jittery?","p":["Try enabling the No Blur Effect (Fast UI) mode on the User settings panel.","Enable Reduced motion in the UI theme settings to remove cosmetic animations.","Make sure your browser is using Hardware Acceleration."]},{"i":"how-to-make-the-ai-write-more","l":"How to make the AI write more?","p":["Sometimes the AI will only respond with a single sentence when you'd like it to be more verbose. This is usually a problem with locally run models.","If you simply want the bot to continue writing from where it left off at the end of its most recent reply, you can send an empty user message by typing nothing into the Input Bar and clicking Send. This will force the bot to continue the story.","Strategies for fixing this:","Decrease the value of the Response Length setting","Design a good First Message for the Character, which shows them speaking in a long-winded manner. AI models can improve a lot when given guidance about the writing style you expect.","Add a phrase in the character's Description Box such as \"likes to talk a lot\" or \"very verbose speaker\"","Do the same thing for your Author's Note, or Post-History Instruction Prompt","As a last resort, you can try turning on Auto-Continue(in the User Settings panel), but will make responses come out slower because it's making the AI produce small replies back to back, and then combining them all together into one big reply. It may also be incompatible with some API options."]},{"i":"how-to-make-the-ai-write-less","l":"How to make the AI write less?","p":["This is mostly only a problem for models like ChatGPT or Claude. The same strategies can be applied but in reverse.","Decrease the value of the Response Length setting","Give the character a phrase like 'short spoken', or 'doesn't talk much' line in their Description.","Give the character a brief First Message to set the tone and expectation for the chat.","Make sure Auto-Continue is turned off."]},{"i":"how-to-make-the-ai-stop-writing-the-actions-of-my-character-and-driving-the-plot-all-on-its-own","l":"How to make the AI stop writing the actions of my character, and driving the plot all on its own?","p":["This should be handled in the Author's Note with a combination of phrases like:","{{char}}'s responses shall only be passive and reactive to {{user}}'s actions.","Your next response shall be solely from the POV of {{char}}.","You are never allowed to dictate actions or speech for {{user}}"]}],[{"l":"Chatting","p":["When you are connected to an API, send messages to the AI by typing in the chat bar at the bottom of the screen. Then click Send or press Enter. Chat bar","The AI will respond with a message that continues the conversation.","Chat message","You can now:","Send another message","Swipe the response: Click the Swipe button on the message to generate a different response.","Edit the message: Click the Edit button on any message to edit the message content.","Message actions: Click the Message actions button on a message for more message options like translation, image generation, and story branching.","Chat options: Click the Options button next to the chat bar for more chat options like author's notes and chat file management.","If you wish you'd said something different, you can edit your message and then swipe the AI's response to get a new one.","You can also use the Right arrow key to swipe, and the Up arrow key to edit the last message in the chat. For more hotkeys, use the /help hotkeys slash command in the chat or check the HotKeys page."]},{"l":"Message actions panel","p":["Manage individual chat messages via the ellipsis (•••) button on the message.","To display these options for all messages in your chats, enable the Expand Message Actions setting in your user settings."]},{"l":"Core Functions","p":["Translate: Convert message to different language","Generate Image: Create an image from message content","Narrate: Text-to-speech conversion","Prompt: View the generation prompt and token usage"]},{"l":"Message Visibility","p":["Included: AI sees this message; click to exclude it","Excluded: AI does not see this message; click to include it"]},{"l":"Content Management","p":["Embed: Attach files or images","Checkpoint: Create story checkpoint","Checkpoint Navigation: Click to open checkpoint chat, Shift+Click to update existing checkpoint","Branch: Start alternate story path","Copy: Copy message text","Edit: Edit message content"]},{"l":"Edit message content","p":["A compact panel of message manipulation tools that appears when you Edit a chat message."]},{"l":"Core Actions","p":["Confirm: Save message changes","Cancel: Discard message changes"]},{"l":"Message Operations","p":["Copy: Duplicate message content","Delete: Remove message"]},{"l":"Message Position","p":["Move Up: Shift message higher in chat","Move Down: Shift message lower in chat","Note: Movement controls may be disabled based on message position in chat history."]},{"l":"Chat options panel","p":["Manage chat settings and operations via the Options button at the bottom left of the chat interface."]},{"l":"Display Controls","p":["Close chat: Exit current chat session","Toggle Panels: Show/hide interface panels"]},{"l":"Generation Settings","p":["Author's Note: Custom context instructions","CFG Scale: Adjust response creativity","Token Probabilities: View token generation stats"]},{"l":"Chat Navigation","p":["Back to parent chat: Return to main conversation","Save checkpoint: Create story checkpoint","Convert to group: Transform into group chat"]},{"l":"Chat Management","p":["Start new chat: Begin fresh conversation","Manage chat files: Chat file operations such as import, export, and renaming"]},{"l":"Message Controls","p":["Delete messages: Select and remove multiple messages","Regenerate: Create new response","Impersonate: AI writes message as user","Continue: Extend last message","Note: Some options may be hidden depending on context and chat state."]},{"l":"Token Probabilities Panel","p":["The Token Probabilities panel lets you look into the AI's sampling process for text generation. It shows you not just what the AI wrote, but what other options it considered at each point in the text.","To open it, click the Token Probabilities button in the Chat Options panel.","Example message","Token probabilities display for example message","When you click any token (word, punctuation, or formatting character) in the generated text, the panel displays alternative tokens the AI considered at that position, along with their probability scores. This gives you insight into the AI's \"thought process\" and shows other directions the response could have taken. Looking at these alternatives can help you understand whether there were several likely options or a single clear choice.","Alternative tokens and probabilities","If you see a token that you think the AI should have chosen differently, choose an alternative and the message will regenerate from that point forward, potentially giving you a different response."]},{"l":"Rerolling","p":["If you change a specific token and regenerate the response, the part of the new response before the changed token will be the same as the original response. This part is shown in gray. Since it was not generated, there is no probability information for this part.","You may like to see other responses that could have been generated based on your alternative token.","You can click the gray portion to \"reroll\" the generation, giving you a new variation of the text. Clicking any part of the gray portion will keep the entire gray portion and regenerate the entire white/tinted portion.","Holding Ctrl while clicking a token in the gray portion will retain the gray portion up to the clicked token and regenerate the rest of the text. Your choice of alternative token can not be kept in this case."]},{"l":"Controls","p":["Token Display:","Generated text is split into individual tokens","Each token is interactive, click a token to see alternatives considered by the AI","Tokens are tinted as a visual aid but this does not indicate probability","Special characters (spaces, newlines) are visibly marked","Token Selection:","Click a token to view alternatives","Click an alternative to replace the token and regenerate the response","Hover over a token to see its raw log-probability score","Window Controls:","Drag handle for panel repositioning (MovingUI only)","Maximize/restore panel size","Expand/collapse panel content","Close panel"]},{"l":"Availability","p":["You must select Request token probabilities in User Settings to enable this feature.","Token probabilities are only available for the most recent message, and are not saved to the chat. If token probability information is no longer available for a message, the panel will display a message indicating this.","Token probabilities are not available when using Smooth Streaming.","Token probabilities are not available from all APIs. If you are using an API that does not support token probabilities, the panel will open but will not display any information."]},{"l":"Text Completion","p":["LlamaCPP: Available","Text Generation WebUI(oobabooga): Available","TabbyAPI: Available","NovelAI: Available","KoboldCPP: Available","Ollama: Appears to be unavailable","OpenRouter Text: Appears to be unavailable"]},{"l":"Chat Completion","p":["OpenAI or Custom: Available, but rerolling is not supported","Anthropic: Appears to be unavailable","Google AI Studio: Appears to be unavailable","OpenRouter Chat: Appears to be unavailable"]}],[{"l":"Slash commands","p":["This is not an exhaustive list as it is updated rarely.","For the most up-to-date list of commands that will work in your instance, use the /help slash chat command in any SillyTavern chat.","/help– displays the help message","/api- switches to a different API","/sys- sends a neutral message as a system narrator","/send- sends a message as the user without triggering the generation","/sendas– sends a message as a specific character","/comment- adds a comment to the chat invisible to the AI","/impersonate- ask AI to write as you with an optional prompt","/persona- set your user persona","/imagine- generate an image from a text prompt","/bg- set a background image by file name"]}],[{"l":"HotKeys","p":["For the most up-to-date list of HotKeys that will work in your SillyTavern instance, use the /help hotkeys slash command in any chat.","Hotkeys are disabled for mobile devices."]},{"l":"Chat Hotkeys","p":["Up = Edit last message in chat","Ctrl+Up = Edit last USER message in chat","Left = swipe left","Right = swipe right (NOTE: swipe hotkeys are disabled when chatbar has something typed into it)","Enter (with chat bar selected) = send your message to AI","Ctrl+Enter = Regenerate the last AI response","Alt+Enter = Continue the last AI response","Escape","(while editing message AND Message Edit AutoSave is enabled)= close edit box.","(while an AI message is generating or streaming)= stop the generation immediately."]},{"l":"Markdown Hotkeys","p":["Needs to be enabled under the \"User Settings\" tab. Works in the chatbar and textareas marked with the \"M↓\" icon:","Ctrl+B = **bold**","Ctrl+I = *italic*","Ctrl+U = __underline__","Ctrl+K = `inline code`","Ctrl+Shift+~= ~~strikethrough~~"]}],[{"l":"Common Settings","p":["These settings control the sampling process when generating text using a language model. The meaning of these settings is universal for all the supported backends."]},{"l":"Context Settings"},{"i":"response-tokens","l":"Response (tokens)","p":["The maximum number of tokens that the API will generate to respond.","The higher the response length, the longer it will take to generate the response.","If supported by the API, you can enable Streaming to display the response bit by bit as it is being generated.","When Streaming is off, responses will be displayed all at once when they are complete."]},{"i":"context-tokens","l":"Context (tokens)","p":["The maximum number of tokens that SillyTavern will send to the API as the prompt, minus the response length.","Context comprises character information, system prompts, chat history, etc.","A dotted line between messages denotes the context range for the chat. Messages above that line are not sent to the AI.","To see a composition of the context after generating the message, click on the Prompt Itemization message option (expand the ... menu and click on the lined square icon)."]},{"l":"Sampler Parameters"},{"l":"Temperature","p":["Controls the randomness of the generated text.","Lower value: responses are more logical but less creative.","Higher value: responses are more creative but less logical."]},{"l":"Repetition Penalty","p":["Attempts to curb repetition by penalizing tokens based on how often they occur in the context.","Sometimes, if the character is fixated on something or repeats the same phrase, increasing this parameter can help.","This parameter will break responses if set too high. It's best not to go above 1.15 unless you know what you're doing.","Set the value to 1 to disable its effect."]},{"l":"Repetition Penalty Range","p":["How many tokens from the last generated token will be considered for the repetition penalty. This can break responses if set too high, as common words like \"the, a, and,\" etc. will be penalized the most.","Set the value to 0 to disable its effect."]},{"l":"Repetition Penalty Slope","p":["If both this and Repetition Penalty Range are above 0, the repetition penalty will have a greater effect at the end of the prompt. The higher the value, the stronger the effect.","Set the value to 0 to disable its effect."]},{"l":"Top K","p":["Limits the token pool to the K most likely tokens. A lower number is more consistent but less creative.","Set the value to 0 to disable its effect."]},{"l":"Top P","p":["Limits the token pool to however many tokens it takes for their probabilities to add up to P. A lower number is more consistent but less creative.","Set the value to 1 to disable its effect."]},{"l":"Typical P","p":["Selects tokens randomly from the list of possible tokens, with each token having an equal chance of being selected. Produces responses that are more diverse but may also be less coherent.","Set the value to 1 to disable its effect."]},{"l":"Min P","p":["Limits the token pool by cutting off low-probability tokens relative to the top token. Produces more coherent responses but can also worsen repetition if set too high.","Works best at low values such as 0.1-0.01, but can be set higher with a high Temperature. For example: Temperature: 5, Min P: 0.5","Set the value to 0 to disable its effect."]},{"l":"Top A","p":["The number of tokens chosen from the most likely options is automatically determined based on the likelihood distribution of the options, but instead of choosing the Top P or Top K tokens, it chooses all tokens with probabilities above a certain threshold.","Set the value to 0 to disable its effect."]},{"l":"Tail Free Sampling","p":["This setting removes the least probable tokens from consideration during text generation, which can improve the quality and coherence of the generated text.","Set the value to 1 to disable its effect."]},{"l":"Smoothing Factor","p":["Increases the likelihood of high-probability tokens while decreasing the likelihood of low-probability tokens using a quadratic transformation. Aims to produce more creative responses regardless of Temperature.","Works best without truncation samplers such as Top K, Top P, Min P, etc.","Set the value to 0 to disable its effect."]},{"l":"Dynamic Temperature","p":["Scales temperature dynamically based on the likelihood of the top token. Aims to produce more creative outputs without sacrificing coherency.","Accepts a temperature range from minimum to maximum. For example: Minimum Temp: 0.75 and Minimum Temp: 1.25","Exponent applies an exponential curve based on the top token.","Untick to disable its effect."]}],[{"l":"API Connections","p":["SillyTavern can connect to a wide range of LLM APIs. Below is a description of their respective strengths, weaknesses, and use cases."]},{"i":"eli5-chat-completions-vs-text-completions","l":"ELI5: Chat Completions vs Text Completions","p":["When you first navigate to the \"API Connections\" page in ST, you will notice a drop-down option to select between options using nomenclature such as \"Chat Completion\" and \"Text Completion\". It's helpful to understand what this is.","What it's not: It's easy to think of \"Text Completion\" as local models and \"Chat Completion\" as cloud-based LLMs but that's not the case. Neither is e.g. \"Novel AI\" or \"Kobold\" actually a separate type of model altogether, even though they are separate options in the API dropdown in ST. You can force models into different API structures with the appropriate backend, but that's not the point of this section.","When you send a message using ST, your chat, character description, and other prompts such as lorebooks or author notes are constructed into a single \"prompt\" to be sent to the model. The API \"type\" for the model you are using decides how exactly this prompt will be constructed (something that ST takes care of you automatically in the background - you can open your ST terminal and see exactly what the prompt being sent to the AI looks like)."]},{"l":"Chat Completions","p":["A Chat Completion model, as its name suggests will structure your prompt into a series of messages between the User (you) and the Assistant (the AI) or System (neutral). Models that are trained for Chat Completion help create the feeling of a \"Chat\", with the AI \"responding\" to the last message. When you're using the ChatGPT website, you're dealing with a Chat Completions API in the background."]},{"i":"text-completions-aka-just-completions","l":"Text Completions (a.k.a just \"Completions\")","p":["A Text Completion on the other hand, and again as its name suggests, will convert your prompt into one long string and the model will simply try to continue this (like, literally imagine all your text, your hundreds of messages, all your formatting, newlines, etc. squashed into one very long sentence).","If your messages in ST happen to be formatted as a series of messages between YourPersona: and Character:, the Text Completion model will try to continue this pattern and ST will render it as a new chat message for you, but really the model is just trying to continue the Text. If you offered an input of \"The Sun rises in the\", a text completion model is likely to finish that message for you with \"East\".","Most Text Completion models have a recommended \"Instruct Template\" (usually mentioned in the model's documentation or download page) that help them \"respond\" to messages and instructions, just like a Chat Completion model. ST usually has most (if not all) Instruct Templates available for you to choose from in the \"Advanced Formatting\" page."]},{"l":"Local APIs","p":["These LLM APIs can be run on your PC.","They are free to use and have no content filter.","Installation process can be complex ( SillyTavern dev team does not provide support for this).","Requires separate download of LLM models from HuggingFace which can be 5-50GB each.","Most models are not as powerful as cloud LLM APIs."]},{"l":"KoboldAI","p":["Runs on your PC, 100% private, wide range of models available","Gives the most direct control of the AI's generation settings","Requires large amounts of VRAM in your GPU (6-24GB, depending on the LLM model)","Models limited to 2k context","No streaming","Popular KoboldAI versions:","Henky's United","0cc4m's 4bit-supporting United"]},{"l":"KoboldCpp","p":["Easy-to-use API with CPU offloading (helpful for low VRAM users) and streaming","Runs from a single .exe file on Windows (must be compiled from source on MacOS and Linux)","Supports GGUF/GGML models","Slower than GPU-only loaders such as AutoGPTQ and Exllama/v2","GitHub"]},{"l":"Oobabooga TextGeneration WebUI","p":["All-in-one Gradio UI with streaming","Broadest support for quantized (AWQ, Exl2, GGML, GGUF, GPTQ) and FP16 models","One-click installers available","Regular updates, which can sometimes break compatibility with SillyTavern","GitHub","Correct Way to Connect SillyTavern to Ooba's new OpenAI API","Make sure you're on the latest update of Oobabooga's TextGen (as of Nov 14th, 2023).","Edit the CMD_FLAGS.txt file, and add the --api flag there. Then restart Ooba's server.","Connect ST to http://localhost:5000/(by default) without checking the 'Legacy API' box. You may remove the /v1 postfix from the URL Ooba's console provides you.","You can change the API hosting port with the --api-port 5001 flag, where 5001 is your custom port."]},{"l":"TabbyAPI","p":["Lightweight Exllamav2-based API with streaming","Supports Exl2, GPTQ, and FP16 models","Official extension allows loading/unloading models directly from SillyTavern","Not recommended for users with low VRAM (no CPU offloading)","GitHub"]},{"l":"Cloud LLM APIs","p":["These LLM APIs are run as cloud services and require no resources on your PC","They are stronger/smarter than most local LLMs","However they all have content filtering of varying degrees, and most require payment"]},{"i":"openai-chatgpt","l":"OpenAI (ChatGPT)","p":["Easy to set up and acquire an API key","Requires prepayment for credits and charges per prompt","Very logical. Creative style can be repetitive and predictable","Most of the newer models (gpt-4-turbo, gpt-4o) support multimodality","Website, Setup Instructions"]},{"i":"claude-by-anthropic","l":"Claude (by Anthropic)","p":["Recommended for users who want their AI chats to have a creative, unique writing style","Requires prepayment for credits and charges per prompt","The newest models (Claude 3) support multimodality","Requires a specific prompting style and utilization of prefills for reply steering","Website"]},{"i":"mistral-by-mistral-ai","l":"Mistral (by Mistral AI)","p":["Efficient models from various sizes and use cases. You can create an account and API key on their platform.","From 32k to 128k context sizes for general use, and 32k to 256k context sizes for coding.","Free Tier with rate limits.","Reasonable moderation, with Mistrals main principles being to be neutral and empower users, more information here."]},{"l":"OpenRouter","p":["WindowAI browser extension allows you to connect to the abovementioned cloud LLMs with your own API key","Use OpenRouter to pay to use their API keys instead","Useful if you don't want to create individual accounts on each service","WindowAI website and OpenRouter website"]},{"l":"DreamGen","p":["Uncensored models tuned for steerable creative writing","Free monthly credits, as well as paid subscription","Models ranging from 7B to 70B","Setup Instructions"]},{"l":"AI Horde","p":["SillyTavern can access this API out of the box with no additional settings required","Uses the GPU of individual volunteers (Horde Workers) to process responses for your chat inputs","At the mercy of the Worker in terms of generation wait times, AI settings, and available models","Website"]},{"l":"Mancer AI","p":["Service that hosts unconstrained models of various families","Uses 'credits' to pay for tokens on various models","Does not log prompts by default, but you can enable it to get credit discounts on tokens.","Uses an API similar to Oobabooga TextGeneration WebUI, see Mancer docs for details.","Website, Setup Instructions"]},{"l":"NovelAI","p":["No content filter","Paid subscription required","Website, Setup Instructions"]}],[{"l":"Connection Profiles","p":["Save Connection Profiles to quickly switch between different APIs, models and formatting templates. This is useful when you actively use multiple API connections or need to switch between different configurations without surfing through the menus."]},{"l":"Accessing Connection Profiles","p":["This feature is enabled by default starting from SillyTavern 1.12.6 or later as a built-in extension, and available in the API Connections menu. If you wish to disable it, open the Extensions panel, click on \"Manager extensions\", locate Connection Profiles in the list, uncheck the \"Enabled\" checkbox, and then click \"Close\"."]},{"l":"What is Saved","p":["Connection Profiles store the following selections."]},{"l":"Common","p":["API type, model and the server URL","Settings preset"]},{"l":"Text Completion APIs","p":["System Prompt and its state","Instruct Mode state and template","Context Template","Tokenizer"]},{"l":"Chat Completion APIs","p":["Proxy preset"]},{"l":"Managing Connection Profiles","p":["Profiles only save the selection in dropdown fields, without knowing anything about the underlying settings. This means that you will lose unsaved changes by switching to a different profile. To prevent this, make sure to update all presets and templates if you don't want to lose ephemeral changes.","To save a profile, set all the required settings and click the \"Create\" button. Then review the settings and provide a name for the profile. A name should be unique.","To view the detailed information about a chosen profile, click on the \"Information\" button. Click again to hide the details.","Connection Profile settings are saved into settings.json without altering the associated profile save file until you press the \"Update\" button. This means that if you setup a profile, but then switch to a different one without updating, you will lose all of your previous changes.","To restore the changed selections from a saved profile, click the \"Reload\" button.","To delete a profile, click the \"Delete\" button and confirm the deletion. This action is irreversible."]},{"l":"Slash Commands","p":["Connection profiles can be managed using the following slash commands.","/profile [name]- switch to a profile if the argument is provided, or get the name of the current profile if not.","/profile-create [name]- saves the current settings as a new profile with the provided name.","/profile-list- returns a JSON-serialized array of available profile names.","/profile-get [name]- gets the details of the profile with the provided name as a JSON-serialized object.","/profile-update- updates the selected profile with the current settings."]}],[{"l":"Self-hosted AI models","p":["This guide is based on the author's personal experience and knowledge and is not an absolute truth. All statements should be taken with a grain of salt. If you have any corrections or suggestions, please contact us on Discord or send a PR to the SillyTavern documentation repository."]},{"l":"Intro","p":["This guide aims to help you get set up using SillyTavern with a local AI running on your PC (we'll start using the proper terminology from now on and call it an LLM). Read it before bothering people with tech support questions."]},{"i":"what-are-the-best-large-language-models","l":"What are the best Large Language Models?","p":["It is impossible to answer this question as there's no standardized scale of \"Best\". The community has enough resources and discussions going on Reddit and Discord to form at least some opinion on what is the preferred / go-to model. Your mileage may vary."]},{"i":"what-is-the-best-configuration","l":"What is the best configuration?","p":["If there was a best or no-brainer setup, would there even have to be a need for configuration? The best configuration is the one that works for you. It's a trial-and-error process."]},{"l":"Hardware requirements and orientation","p":["This is a complex subject, so I'll stick to the essentials and generalize.","There are thousands of free LLMs you can download from the Internet, similar to how Stable Diffusion has tons of models you can get to generate images.","Running an unmodified LLM requires a monster GPU with a ton of VRAM (GPU memory). More than you will ever have.","It is possible to reduce VRAM requirements by compressing the model using quantization techniques, such as GPTQ or AWQ. This makes the model somewhat less capable, but greatly reduces the VRAM requirements to run it. Suddenly, this allowed people with gaming GPUs like a 3080 to run a 13B model. Even though it's not as good as the unquantized model, it's still good.","It gets better: there also exists a model format and quantization called GGUF (previously GGML) which has become the format of choice for normal people without monster GPUs. This allows you to use an LLM without a GPU at all. It will only use CPU and RAM. This is much slower (probably 15 times) than running the LLM on a GPU using GPTQ/AWQ, especially during the prompt processing, but the model's ability is just as good. The GGUF creator then optimized GGUF further by adding a configuration option that allows people with a gaming-grade GPU to offload parts of the model to the GPU, allowing them to run part of the model at GPU speed (note that this doesn't reduce RAM requirements, it only improves your generation speed).","There are different sizes of models, named based on the number of parameters they were trained with. You will see names like 7B, 13B, 30B, 70B, etc. You can think of these as the brain size of the model. A 13B model will be more capable than the 7B from the same family of models: they were trained on the same data, but the bigger brain can retain the knowledge better and think more coherently. Bigger models also require more VRAM/RAM.","There are several degrees of quantization (8-bit, 5-bit, 4-bit, etc). The lower you go, the more the model degrades, but the lower the hardware requirements. So even on bad hardware, you might be able to run a 4-bit version of your desired model. There's even 3-bit and 2-bit quantization but at this point, you're beating a dead horse. There's also a further quantization subtypes named k_s, k_m, k_l, etc. k_m is better than k_s but requires more resources.","The context size (how long your conversation can become without the model dropping parts of it) also affects VRAM/RAM requirements. Thankfully, this is a configurable setting, allowing you to use a smaller context to reduce VRAM/RAM requirements. (Note: the context size of Llama2-based models is 4k. Mistral is advertised as 8k, but it's 4k in practice.)","Sometime in 2023, NVIDIA changed their GPU driver so that if you need more VRAM than your GPU has, instead of the task crashing, it will begin using regular RAM as a fallback. This will ruin the writing speed of the LLM, but the model will still work and give the same quality of output. Thankfully, this behavior can be disabled.","Given all of the above, the hardware requirements and performance vary completely depending on the family of model, the type of model, the size of the model, the quantization method, etc."]},{"l":"Model size calculator","p":["You can use Nyx's Model Size Calculator to determine how much RAM/VRAM you need.","Remember, you want to run the largest, least quantized model that can fit in your memory, i.e. without causing disk swapping."]},{"l":"Downloading an LLM","p":["To get started, you will need to download an LLM. The most common place to find and download LLMs is on HuggingFace. There are thousands of models available. A good way to find GGUF models is to check bartowski's account page: https://huggingface.co/bartowski. If you don't want GGUF, he links the original model page where you might find other formats for that same model.","On a given model's page, you will find a whole bunch of files.","You might not need all of them! For GGUF, you just need the .gguf model file (usually 4-11GB). If you find multiple large files, it's usually all different quantizations of the same model, you only need to pick one.","For .safetensors files (which can be GPTQ or AWQ or HF quantized or unquantized), if you see a number sequence in the filename like model-00001-of-00003.safetensors, then you need all 3 of those .safetensors files + all the other files in the repository (tokenizer, configs, etc.) to get the full model.","As of January 2024, Mixtral MOE 8x7B is widely considered the state of the art for local LLMs. If you have the 32GB of RAM to run it, definitely try it. If you have less than 32GB of RAM, then use Kunoichi-DPO-v2-7B, which despite its size is stellar out of the gate."]},{"l":"Walkthrough for downloading Kunoichi-DPO-v2-7B","p":["We will use the Kunoichi-DPO-v2-7B model for the rest of this guide. It's an excellent model based on Mistral 7B, that only requires 7GB RAM, and punches far above its weight. Note: Kunoichi uses Alpaca prompting.","Go to https://huggingface.co/brittlewis12/Kunoichi-DPO-v2-7B-GGUF","Click 'Files and versions'. You will see a listing of several files. These are all the same model but offered in different quantization options. Click the file 'kunoichi-dpo-v2-7b.Q6_K.gguf', which gives us a 6-bit quantization.","Click the 'download' button. Your download should start."]},{"l":"How to identify the type of model","p":["Good model uploaders like TheBloke give descriptive names. But if they don't:","Filename ends in .gguf: GGUF CPU model (duh)","Filename ends in .safetensors: can be unquantized, or HF quantized, or GPTQ, or AWQ","Filename is pytorch-***.bin: same as above, but this is an older model file format that allows the model to execute arbitrary Python script when the model is loaded, and is considered unsafe. You can still use it if you trust the model creator, or are desperate, but pick .safetensors if you have the option.","config.json exists? Look if it has a quant_method.","q4 means 4-bit quantization, q5 is 5-bit quantization, etc","You see a number like -16k? That's an increased context size (i.e. how long your conversation can get before the model forgets the beginning of your chat)! Note that higher context sizes require more VRAM."]},{"i":"installing-an-llm-server-oobabooga-or-koboldai","l":"Installing an LLM server: Oobabooga or KoboldAI","p":["With the LLM now on your PC, we need to download a tool that will act as a middle-man between SillyTavern and the model: it will load the model, and expose its functionality as a local HTTP web API that SillyTavern can talk to, the same way that SillyTavern talks with paid webservices like OpenAI GPT or Claude. The tool you use should be either KoboldAI or Oobabooga (or other compatible tools).","This guide covers both options, you only need one.","If you are hosting SillyTavern on Docker, use http://host.docker.internal: instead of http://127.0.0.1:. This is because SillyTavern connects to the API endpoint from the server running in the Docker container. Docker's network stack is separate from the host's, and so the loopback interfaces are not shared."]},{"i":"downloading-and-using-koboldcpp-no-installation-required-gguf-models","l":"Downloading and using KoboldCpp (No installation required, GGUF models)","p":["Visit https://koboldai.org/cpp where you will see the latest version with various files you can download. At the time of writing the newest CUDA version they list is cu12 which will work best on modern Nvidia GPU's, if you have an older GPU or a different brand you can use the regular koboldcpp.exe. If you have an old CPU its possible that KoboldCpp will crash when you try to load models, in that case try the _ oldcpu version to see if it resolves your issue.","KoboldCpp does not need to be installed, once you start KoboldCpp you will immediately be able to select your GGUF model such as the one linked above using the Browse button next to the Model field.","By default KoboldCpp runs at a maximum of 4K context even if you set this higher in SillyTavern, if you wish to run a model at higher context make sure to adjust the context slider on this screen before launching the model. Keep in mind that more context size means higher (video) memory requirements, if you set this to high or load a model that is to big for your system KoboldCpp will automatically begin using your CPU for the layers it can not fit on your GPU, this will be much slower.","Click Launch, if everything goes well a new webpage will open with KoboldAI Lite where you can test if everything works correctly.","Open SillyTavern and click API Connections (2nd button in the top bar)","Set API to Text Completion and the API Type to KoboldCpp.","Set server URL to http://127.0.0.1:5001/ or the link that KoboldCpp gave you in case it is not running on the same system (You can activate KoboldCpp's Remote Tunnel mode to obtain a link that can be accessed from anywhere).","Click Connect. It should connect successfully and detect kunoichi-dpo-v2-7b.Q6_K.gguf as the model.","Chat with a character to test that it works."]},{"i":"tips-for-optimizing-koboldcpps-speed","l":"Tips for Optimizing KoboldCpp's speed","p":["Flash Attention will help reduce the memory requirements, it can be faster or slowing depending on your system and will allow you to fit more layers on your GPU than the default.","KoboldCpp will leave some space for other software when it guesses layers to prevent issues, if you have few programs open and are unable to fit the model entirely in the GPU you may be able to add a few extra layers.","If the model uses up to much memory for the context size you can decrease this by Quantizing the KV. This will reduce the quality of the output but can help you put more layers on the GPU. To do this you go to the Tokens tab in KoboldCpp and then disable Context Shifting and enable Flash Attention. This will unlock the Quantized KV Cache slider, a lower number means less memory / intelligence of the model.","Running KoboldCpp on a slower system where it takes long to process the prompt? Context Shifting works best when you avoid using Lorebooks, randomization or other features that dynamically change the input. Leaving context shifting enabled KoboldCpp will help you avoid long reprocessing times."]},{"l":"Installing Oobabooga","p":["Here's a more correct/dummy proof installation procedure:","git clone https://github.com/oobabooga/text-generation-webui(or download their repo as a .zip in your browser, then extract it)","Run start_windows.bat or whatever your OS is","When asked, select your GPU type. Even if you intend to use GGUF/CPU, if your GPU is in the list, select it now, because it will give you the option to use a speed optimization later called GPU sharding (without having to reinstall from scratch). If you have no gaming-grade dGPU (NVIDIA, AMD), select None.","Wait for the installation to finish","Place kunoichi-dpo-v2-7b.Q6_K.gguf in text-generation-webui/models","Open text-generation-webui/CMD_FLAGS.txt, delete everything inside and write: --api","Restart Oobabooga","Visit http://127.0.0.1:5000/docs. Does it load a FastAPI page? If not, you messed up somewhere."]},{"l":"Loading our model in Oobabooga","p":["Open http://127.0.0.1:7860/ in your browser","Click the Model tab","In the dropdown, select our Kunoichi DPO v2 model. It should have automatically selected the llama.cpp loader.","(Optional) We mentioned 'GPU offload' several times earlier: that's the n-gpu-layers setting on this page. If you want to use it, set a value before loading the model. As a basic reference, setting it to 30 uses just under 6GB VRAM for 13B and lower models. (it varies with model architecture and size)","Click Load"]},{"l":"Configuring SillyTavern to talk to Oobabooga","p":["Click API Connections (2nd button in the top bar)","Set API to Text Completion","Set API Type to Default (Oobabooga)","Set server URL to http://127.0.0.1:5000/","Click Connect. It should connect successfully and detect kunoichi-dpo-v2-7b.Q6_K.gguf as the model.","Chat with a character to test that it works"]},{"l":"Conclusion","p":["Congrats, you should now have a working local LLM."]}],[{"l":"Chat Completions"},{"l":"OpenAI"},{"l":"API key","p":["How to get:","Go to OpenAI and sign in.","Use \" View API keys\" option to create a new API key.","Important!","Lost API keys can't be restored! Make sure to keep it safe!"]},{"l":"Claude","p":["If you have access to Anthropic's Claude API:","Select 'Claude' for 'Chat Completion Source'.","Input your API key.","Click connect."]},{"l":"Mistral AI","p":["Mistral AI is a team developing both open and proprietary models with high scientific standards and a focus on openness. You can run their models locally or through their API service, La Plateforme."]},{"l":"API","p":["The first step is to create an account on La Plateforme.","Once that's done, you can choose a plan and set up your payment information or opt for the Free Tier.","Next, you can create your API key. You may need to wait a couple of minutes before the key becomes valid!","Important! Lost API keys can't be restored! You would have to create a new one. Make sure to keep it safe!"]},{"l":"Proxy","p":["Back in the 'AI Connections' tab, you can find two optional checkboxes labeled:","Bypass API status check.","Checking 'Bypass API status check' tells SillyTavern to stop alerting you about a non-functioning API endpoint. Check this if your API endpoint works, but SillyTavern keeps warning you anyway.","Checking 'Show \"External\" models (provided by API)' will show the external available models as reported by your custom API endpoint in the dropdown (scroll down past OpenAI's models). This allows you to select different API models right from SillyTavern without having to go into your custom app and change the model.","Examples of backends which implement this API are:","Hint: If it doesn't work, try adding /v1 at the end of the endpoint URL!","If you intend to use this proxy feature to use a local endpoint, like TabbyAPI, Oobabooga, Aphrodite, or any like those, you might want to check out the built-in compatibility for those instead. This proxy feature is mainly intended for use with other services and programs that expose an OpenAI-compatible API Chat Completion endpoint.","It is important to note that we do not provide support for possible issues that you may have! We do not guarantee compatibility with every possible API endpoint!","It is possible to configure a proxy/alternative endpoint for OpenAI's backend. This custom endpoint can connect to alternative Chat Completion APIs that support the generic OpenAI API schema.","Leaving the details like the API key empty.","LiteLLM","LM Studio","LocalAI","Most Text Completion APIs support far greater customization options than OpenAI's standards allow for. These greater customization options, such as the Min-P sampler, may be worthwhile for SillyTavern users to check out, which can greatly improve the quality of generations.","Opening the 'AI Response Configuration' tab and scrolling down to the 'OpenAI / Claude Reverse Proxy' section.","Selecting 'OpenAI' for 'Chat Completion Source'.","Show \"External\" models (provided by API).","Switching to the 'Chat Completion' API type.","There you may enter the proxy/custom endpoint and optionally an API key under 'Proxy Password' if needed. For example, TabbyAPI provides you with an API key you have to use.","This feature is accessed by:","This feature is not required for custom API endpoints to work and might not be available on every backend."]}],[{"l":"OpenRouter","p":["Don't have access to OpenAI / Claude APIs due to geolocking or waitlists? Use OpenRouter.","OpenRouter works by letting you use keys they own to access models like GPT-4 and Claude 2, all in one service with a shared credit pool.","It has a free trial (about $1) and paid access afterward. No subscription or monthly bill - you pay for what you actually use. Some models have free access with a limited context size.","OpenRouter Pricing Details","Create an OpenRouter account: openrouter.ai","OpenRouter-ConnectionPanel","From top to down (see image above):","Select 'Chat Completion' API","Select OpenRouter source","Click \"Authorize\" to get a key using OAuth flow. Alternatively, generate an API key here and paste it into the box.","Click \"Connect\" and select a model","(Optional) Use the \"Test Message\" button to verify your connection"]},{"l":"WindowAI","p":["WindowAI is a browser extension by the makers of OpenRouter that allows control of your OpenRouter connection for any enabled site or web app.","You can also use your own Claude and OpenAI API keys there."]}],[{"l":"AI Horde"},{"l":"Disclaimer","p":["AI Horde is a crowdsourced, distributed GPU cluster run entirely by volunteers.","By default, your inputs are anonymously sent and responses can not be seen by the person running the Horde Worker.","However, since it is an open-sourced program, Malicious Workers could modify the code to:","log your activity (input prompts, AI responses).","produce bad or offensive responses.","When using Horde never send any personal information such as names, email addresses, etc.","Switching on the \"Trusted Workers Only\" checkbox will limit the selection of available workers to only those who have been hosting on Horde for a while and are generally considered trusted. But they could still be seeing prompts, for example by hosting using unaccounted software.","To help reduce this problem, SillyTavern has built in the following feature:","When a chat response is generated by a Horde Worker, SillyTavern records the Worker's ID and what model they were using.","This information can be seen by hovering your mouse cursor over the chat item (see image below).","If you believe you received a malicious response, you can pass this information to the Horde admin on the AI Horde Discord for review and possible disciplinary action against that Worker.","Horde Worker Info Popup"]},{"l":"Setup","p":["SillyTavern is able to connect with Horde out of the box with no additional setup required.","Select 'AI Horde' from the API Dropdown Selector in the ST API Panel.","Select one or more Models ('AI brains' for the characters) from the Model Selector at the bottom of the panel.","Select a character and begin chatting.","ST Kobold Horde API Connection Panel","By default, your SillyTavern instance connects to the Horde's low priority 'guest account'. This means you may have to wait a long time for a reply. To reduce wait times, follow the tips down below."]},{"l":"Tips","p":["Register an account on the Horde website then add your Horde key into the SillyTavern Horde API Key box.","Set up a Horde Worker to provide your GPU for others.","Letting others use your GPU earns you 'Kudos', a kind of Horde-only currency.","The more kudos your account has, the faster you will get chat responses from other Horde Workers.","Kudos can also be used to create AI images on Stable Horde.","SillyTavern supports Stable Horde image generation out of the box.","If your GPU isn't powerful enough to run an AI, or you don't have a computer, you can still participate in the Horde community to earn Kudos in various ways."]}],[{"l":"DreamGen","p":["DreamGen is an app and an API for AI-powered creative writing. They have a free tier, as well as a paid subscription that allows unlimited monthly access to their high-quality in-house text generation models made specifically for the purpose of steerable AI-assisted writing. Create an account to get started: https://dreamgen.com/.","The (free) credits reset at the start of each calendar month. See pricing to see the credit cost for each model and usage to see your remaining credits."]},{"l":"Connecting to DreamGen"},{"l":"Get API Key","p":["Go to the DreamGen API keys page and click the \"New API Key\" button. Make sure the API Key is copied into your clipboard.","Create New DreamGen API key Copy DreamGen API key"]},{"l":"Connect","p":["Go to the SillyTavern connection settings.","Select API: Text Completion","Select API Type: DreamGen","Enter the API key","(optional) Pick a model","Connecting to DreamGen"]},{"l":"Models","p":["DreamGen offers opus-v1-sm, opus-v1-lg, and opus-v1-xl. The larger the model, the better it will be at following instructions and writing good stories."]},{"l":"Formatting Settings","p":["The DreamGen models expect a specific input format, which is documented here.","SillyTavern comes with built-in presets made for DreamGen. Make sure to use these settings as your baseline. These settings try to stick to the DreamGen format as closely as possible but due to the irregular formatting of character cards, it is not always perfect.","Go to the \"Advanced Formatting\" page.","Under \"Context Template\" pick DreamGen Role-Play V1 Llama3 / ChatML depending on the model (*).","Enable \"Instruct Mode\".","Under \"Instruct Mode Presets\" pick DreamGen Role-Play V1 Llama3 / ChatML.","DreamGen context settings DreamGen instruct settings","(*) When to use Llama 3 and when to use ChatML? As of 2024/06/17, opus-v1-sm is ChatML and all other models are Llama3 based. When running local models, the template will be indicated in the model's HuggingFace card."]},{"l":"Completion Settings","p":["DreamGen supports:","\"Temperature\", \"Top P\", \"Top K\" and \"Min P\"","\"Presence Penalty\", \"Frequency Penalty\" and \"Repetition Penalty\" (without range)","\"Min Length\" -- lets you force the model to generate at least min(min_length, max_tokens) tokens","Good starting values might be:","Min P: 0.05","Temperature: 0.8","Repetition Penalty: 1.1"]},{"l":"Tips for Formatting","p":["The DreamGen models differ from the regular instruction-following models like OpenAI's ChatGPT.","The models were fine-tuned for the task of writing a story based on the provided description which typically consists of plot description, style description, characters, locations, lore, etc. The models can also be steered in the middle of the story, making you the director, telling the characters what they should do or how the plot should unfold.","A well-formatted system prompt message would look like this:","Note that the prompt should be a description of the story, rather than instructions or directives on how the story should be written. Avoid using phrases like:","\"Write the story as if...\"","\"Make sure to...\"","etc.","See more examples of what the plot, style and character descriptions should look like.","The default \"DreamGen Role-Play V1\" template substitutes the different sections as follows:","## Plot description: will consist of {{scenario}} and {{wiBefore}}.","## Style description: is not provided, you should either add it to the system prompt under Advanced Settings, or to the character cards, at the end of {{scenario}}. This section is useful to influence the narrative style (first, second, third person), the tense (past, present), the level of detail and verbosity, etc.","## Characters: will have a {{char}} character with description consisting of {{description}} and {{personality}} and a {{user}} character with description consisting of {{persona}}."]},{"l":"Message Examples and Initial Message","p":["The DreamGen models are very responsive to the context -- they will largely stick to the writing style (and facts) presented in the previous conversation turns. This makes the message examples and the initial message very important."]},{"l":"Formatting Message Examples","p":["The {{mesExamples}} are appended at the end of the system prompt. To take full advantage of the instruct formatting, make sure that your examples are separated with the START separator. For example:"]},{"l":"Examples","p":["Here are a couple of example cards, adapted for DreamGen, that take into account the unique prompting. These cards also leverage the {{mesExamples}} as described above."]},{"l":"Seraphina","p":["This is an edit of the popular Seraphina card that's built into SillyTavern by default."]},{"l":"Lara Lightland","p":["This is an edit of the Lara Lightland card by Deffcolony."]},{"l":"FAQ"},{"i":"what-sampler-settings-should-i-use","l":"What sampler settings should I use?","p":["You can start with these:","Temperature: 1.0","MinP: 0.05","Presence Penalty: 0.1","Frequency Penalty: 0.1"]},{"i":"how-can-i-make-the-responses-longer-or-shorter","l":"How can I make the responses longer or shorter?","p":["You have several options:","Change or add the ## Style description: in the system prompt or model card. You can try adding something like \"Sentences are generally long, and the narrative describes the setting in painstaking detail.\"","Change the Min Length in the Completion Settings.","Add Last Output Sequence similar to the following in the Advanced Formatting settings under Instruct Mode:","Here's an example of the Last Output Sequence that might help make the model respond in a more verbose way, using the Llama 3 template:","The same expressed using the ChatML template:","You can change the text within to something more suitable for your scenario or context."]},{"i":"how-can-i-stop-the-model-from-repeating-itself","l":"How can I stop the model from repeating itself?","p":["If the model repeats what's in the context, you can try increasing \"Repetition Penalty\" in the Completion Settings or you can try rephrasing the part of the context that's getting repeated. If the model repeats itself within one message, you can try increasing \"Presence Penalty\" or \"Frequency Penalty\"."]},{"i":"how-can-i-steer-the-story","l":"How can I steer the story?","p":["If you want to direct the characters to do something, or to steer the plot in certain direction, you can use the user role (that is the |im_start|user preamble).","At this point, this functionality is not neatly integrated into SillyTavern natively, but you can use the Last Output Sequence as described above to insert the user(instruction) turn. See examples of what the instructions should look here."]}],[{"l":"KoboldCpp","p":["KoboldCpp is a self-contained API for GGML and GGUF models.","This VRAM Calculator by Nyx will tell you approximately how much RAM/VRAM your model requires."]},{"l":"Nvidia GPU Quickstart","p":["As of version 1.58, KoboldCpp should look like this:","Click Launch and wait for the model to load.","Click Save so you don't have to configure KoboldCpp on every launch.","Congratulations! You're done!","Do not tick Low VRAM, even if you have low VRAM.","Download the latest release: https://github.com/LostRuins/koboldcpp/releases","GPU Layers should have been populated when you loaded your model. Leave it there for now.","Kind of.","KoboldCpp 1.58","Launch KoboldCpp. You may see a pop-up from Microsoft Defender, click Run Anyway.","Select Use CuBLAS and make sure the yellow text next to GPU ID matches your GPU.","This guide assumes you're using Windows.","Under the Hardware tab, tick High Priority.","Under the Quick Launch tab, select the model and your preferred Context Size.","Unless you have an Nvidia 10-series or older GPU, untick Use QuantMatMul (mmq).","You can now connect to KoboldCpp within SillyTavern with http://localhost:5001 as the API URL and start chatting.","You should see something like this:"]},{"l":"GPU Layers","p":["KoboldCpp is working, but you can improve performance by ensuring that as many layers as possible are offloaded to the GPU. You should see something like this in the terminal:","Don't be afraid of numbers; this part is easier than it looks. CPU buffer size refers to how much system RAM is being used. Ignore that. CUDA0 buffer size refers to how much GPU VRAM is being used. CUDA_Host KV buffer size and CUDA0 KV buffer size refer to how much GPU VRAM is being dedicated to your model's context. In this case, KoboldCpp is using about 9 GB of VRAM.","I have 12 GB of VRAM, and only 2 GB of VRAM is being used for context, so I have about 10 GB of VRAM left over to load the model. Because 9 layers used about 7 GB of VRAM and 7000 / 9 = 777.77 we can assume each layer uses approximately 777.77 MIB of VRAM. 10,000 MIB / 777.77 = 12.8, so I'll round down and load 12 layers with this model from now on.","Now do your own math using the model, context size, and VRAM for your system, and restart KoboldCpp:","If you're smart, you clicked Save before, and now you can load your previous configuration with Load. Otherwise, select the same settings you chose before.","Change the GPU Layers to your new, VRAM-optimized number (12 layers in my case).","Click Save to save your updated configuration.","You should now see something like this:","KoboldCpp is using about 11.5 GB of my 12 GB VRAM. This should perform a lot better than the settings generated automatically by KoboldCpp.","Congratulations! You're (actually) done!","For a more in-depth look at KoboldCpp settings, check out Kalmomaze's Simple Llama + SillyTavern Setup Guide."]}],[{"l":"Mancer","p":["Mancer is a large language model inferencing service that lets you run whatever prompts you want and doesn't censor responses. Most of the models require a preloaded balance to start chatting, but there is a free model as of writing (2024-11-28).","Models","Pricing"]},{"l":"How to Get Started","p":["Sign up for an account at mancer.tech.","Click on Dashboard and copy your API Key.","Mancer dashboard as of 2/27/2024","In SillyTavern, select the Text Completion API, and then select Mancer under API Type.","Enter your Mancer API Key and click Connect.","API Key","You should now be able to chat with any Mancer model of your choice."]},{"l":"Anonymous Logging","p":["If you don't mind your chats potentially being used to train models, improve Mancer's service, publish datasets, or whatever else they may decide to do with it, you can opt-in to anonymous logging for a 25% token discount on select models. Simply go to your Mancer dashboard and tick Enable Anon. Logging."]},{"l":"Support","p":["Still need help? Head over to the #mancer support channel on the SillyTavern Discord."]}],[{"l":"NovelAI","p":["NovelAI is a paid subscription service that allows unlimited monthly access to their high-quality in-house text generation, image generation, and text-to-speech models. Register an account here to get started: https://novelai.net/","You will get only 50 generations for free to evaluate the model. When the \"Not eligible for this model\" error appears, this means that you've exhausted your trial period and need to subscribe to a paid plan."]},{"l":"API Key","p":["To get your NovelAI API key, follow these steps:","Select the gear icon at the top of the left sidebar. Left Sidebar","Select \"Account\" under \"User Settings\". User Settings","Select \"Get Persistent API Token\". Account","Select the copy icon to copy your NovelAI API token to the clipboard. Persistent API Token"]},{"l":"Models","p":["If you have Opus, then Erato is the model to use. If you don't have Opus, then Kayra is the best available model.","Clio has a larger context size on Tablet/scroll tiers, but the strength of Kayra usually makes up for that difference."]},{"l":"Settings","p":["The files with the settings are here ( SillyTavern/data/user-handle/NovelAI Settings). You can also manually add your own settings files."]},{"l":"Response Length","p":["How much text you want to generate per message. Note that NovelAI has a limit of 150 tokens per response."]},{"l":"Context Size","p":["How many tokens of the chat are kept in the context at any given time. How large the maximum context size you can use depends on the model and your subscription tier:","Kayra (Tablet) - 3072 tokens","Kayra (Scroll) - 6144 tokens","Erato (Opus exclusive), Kayra (Opus) and Clio (all tiers) - 8192 tokens"]},{"l":"Preamble","p":["Text that is inserted right above the chat to modify the writing style. The recommended format is a list of short tags, like \"[Style: chat, detailed, sensory ]\"."]},{"l":"Preset Descriptions","p":["This is, according to Novel AI, what the default presets are good for."]},{"l":"Erato","p":["Golden Arrow - A good all-rounder.","Wilder - Higher variety of word choice, more differences between rerolls, more prone to mistakes.","Zany Scribe - Avoids mistakes and repetition. Prioritizes more complex words.","Dragonfruit - Varied and complex language with little repetition. More frequent mistakes and contradictions.","Shosetsu - Designed for writing in Japanese. Works fine for English too."]},{"l":"Kayra","p":["Asper - For creative writing. Expect unexpected twists.","Carefree - A good All-rounder","Fresh-Coffee - Keeps things on track. Handles instruct well.","Pro_Writer - Mimic the pacing and feel of best-selling fiction","Stelenes - More likely to choose reasonable alternatives. Variety on retries.","Tea_Time - It gets good when it gets going.","Writers-Daemon - Extremely imaginative, sometimes too much."]},{"l":"Clio","p":["Edgewise - Handles a variety of generation styles well","Fresh Coffee - Keeps things on track.","Long-Press - Intended for creative prose.","Talker Chat - Designed for chat style generation.","Vingt-Un - A good all-around default with a bent towards prose."]},{"l":"Tips and FAQs for using NovelAI with SillyTavern","p":["There are a lot of common problems and questions that come up when switching to NovelAI from another ST backend API. The difference comes down to what the models are trained for. Most likely, you've used an OpenAI or Anthropic model (or a local model made to resemble those), which is built around following the user's instructions. NovelAI's models are built purely around text completion: instead of taking your input as a message and formulating a response, NAI's models attempt to continue the incoming prompt. Due to this difference, a lot of tips and common knowledge that work for other APIs won't work for NAI."]},{"l":"Tweaking settings for NovelAI","p":["Under Advanced Formatting (the A icon):","Set \"Context Template\" to \"NovelAI\"","Set \"Tokenizer\" to \"Best match\"","Check \"Always add character's name to prompt\"","Check \"Collapse Consecutive Newlines\"","Uncheck the \"Enabled\" box under \"Instruct Mode\"","Under User Settings (the person with a gear)","Turn on \"Swipes\" (Not NAI specific, but it's so useful you should just do it)"]},{"i":"buildingadapting-character-cards-for-novelai","l":"Building/Adapting character cards for NovelAI","p":["To optimize your character cards for NovelAI, there are a couple of recommended methods for writing your character's description: prose, and attributes.","Prose is so simple it doesn't feel like it should work: \"Sylpheed is a young-looking but actually 900 year old nymph. She's short and petite, with long white hair that fades into a green gradient in her braided side ponytail, and emerald green eyes shaped like crosses.[...]\" No, really, that's it. Just write out, in normal sentences, what the character looks like, acts like, etc., and the AI will pick up on it.","If you don't trust your writing abilities or want a more structured way to go about it, you can use the attributes method, which is present in the NovelAI training data. This works as a simple list of character traits of different types. Here's a list of possible attributes that have been tested to be effective with NovelAI's models:","\"Type: character\" is there to tell the AI that this is describing a character (as opposed to a location, object, or other type of thing). The rest of the attributes are optional, and some are redundant (for example, Personality, Mind, and Mental all mean basically the same thing), but these have been tested and work well with NovelAI's models. Fill in whichever ones are relevant to your character. The attributes should be written in lower case and separated by commas, no need for quotes around the words. For example:","These methods are recommended because they're present in NovelAI's training data, so they specifically work well with the model."]},{"l":"Example cards","p":["Here are a couple of example cards, made for NovelAI, that show off different ways of creating cards specifically for NovelAI. The first card, Valka, uses the attributes method for the character description, while Eris, the second card, uses prose descriptions, along with a large amount of example dialogue.","Valka","Eris"]},{"l":"What not to do","p":["Most of the existing character card formats are a poor fit for NovelAI. They'll give you some results, even some good ones, but they have a lot of problems. W++ is one of the biggest offenders, where it doesn't resemble anything that NovelAI's models were trained on, and its constant use of brackets/braces/quotes eats up a ton of tokens, bloating the size of the cards with no real benefit.","Of the existing formats that aren't baked into NovelAI, AliChat is the one most likely to work, as it relies on using example messages to get across both information about the character and their voice at the same time, in the format of the type of message that you want the AI to output.","For most other formats, since they are usually ways of listing out different characteristics of a particular character, they can be converted to the attributes method rather straightforwardly."]},{"i":"which-module-should-i-use","l":"Which module should I use?","p":["Probably No Module. Prose Augmenter is useful if you want a character to speak in a more flowery manner, but be careful not to overdo it. Text Adventure might be useful for a text adventure-style card/story."]},{"i":"not-the-instruct-module","l":"Not the instruct module?","p":["You can invoke the Instruct module when you need it. Create a newline in your message, and put your instructions in curly brackets like this: { CharName is offended by that seemingly innocuous statement }(the spaces are required between the text and the brackets). Doing that will automatically switch the AI into the Instruct module for a short time. You don't want to use the Instruct module all the time because it tends to produce less creative output than the other modules, just when you need to guide the AI strongly in a particular direction."]},{"i":"why-do-my-responses-keep-getting-cut-off","l":"Why do my responses keep getting cut off?","p":["NovelAI limits response length to ~ 150 tokens total, even if you set the slider higher than that. When it reaches the number of tokens in the slider or 150, whichever is lower, it will generate up to 20 more tokens, looking for a stop sequence or the end of a sentence, so there's an effective limit of 170 tokens for a response, at which point it will just stop, causing it to cut off.","If it cuts off, you can select the continue option (in the three-line menu to the left of the text box) to get the character to continue their response.","If you regularly want responses longer than 170 tokens, you can work around the limit like this:","Keep the response length at 150 tokens.","Under Advanced Formatting, enable Auto-continue.","Set the \"Target length\" to the desired length.","This will chain together multiple generations to give you longer messages but doesn't guarantee that the reply will be 100% of the desired length if the model decides to stop."]},{"i":"how-do-i-get-the-bot-to-write-longer-responses","l":"How do I get the bot to write longer responses?","p":["Read the above about responses getting cut off. That will help to make sure that responses aren't cut off prematurely by running into the limit of generation length.","If your responses aren't getting cut off but are still too short, it's likely you're dealing with \"garbage in, garbage out\" - if you give the model bad examples, it will produce bad output. If the character card has no example dialogue or short example dialogue and the messages you send to the bot are short, the model will pick up on that, take it as the accepted way to do things and the responses will be short. So, write longer example dialogue and longer messages to the bot. (You can always use NovelAI to write some example dialogue for you rather than doing it yourself.)"]},{"i":"how-do-i-get-the-bot-to-stop-talking-for-me","l":"How do I get the bot to stop talking for me?","p":["Check that the character card's first message and example dialogue don't include the character taking actions for you - if they do, then rewrite them to get rid of it acting for you","Make sure that \"Always add character's name to prompt\" is checked","Make sure that you're currently using the same user persona as the rest of the chat. If you changed user personas and didn't change back (or don't have a persona locked to that chat), the usual rules to stop generating for you will fail","Add [\"\\n{{user}}:\"] to Custom Stopping Strings (shouldn't be necessary, but sometimes helps)"]},{"i":"why-isnt-my-character-responding","l":"Why isn't my character responding?","p":["A lot of things can cause this, so we need to look in a few places:","Make sure that \"Always add character's name to prompt\" is checked in Advanced Formatting","Check to make sure there aren't any errors coming from the API. While you can use SillyTavern with the NAI free trial, once it runs out, you'll just get errors","Check what you have in \"Custom Stopping Strings\" - if those are being generated at the start of the response, it might be cut off prematurely"]},{"i":"how-should-i-use-the-authors-note","l":"How should I use the Author's Note?","p":["In general, you probably shouldn't. It's inserted very close to the end of the context, and with NAI's models, it frequently overpowers everything else in the context. It's mostly an artifact from older, weaker models where it was more necessary."]},{"i":"how-do-i-do-a-scene-breaktime-jump","l":"How do I do a scene break/time jump?","p":["Put the following as a system message or on newlines at the start of your next message:","Then put the rest of your message on the next line. The bracketed text can be a time jump, a new location, or anything else. The \"***\" (hilariously named a \"dinkus\") tells the AI that the scene has changed, and the bracketed text gives that more context."]},{"i":"the-ai-keeps-repeating-specific-wordsphrases-what-do-i-do","l":"The AI keeps repeating specific words/phrases, what do I do?","p":["As mentioned above, you can push the repetition penalty slider up a bit more, though pushing it too far can make the output incoherent. To more thoroughly fix the problem, go back through the context, especially recent messages, and delete the repeated word/phrase. Removing it from the context gives the AI less reason to start saying it in the first place."]}],[{"l":"Scale","p":["Scale is an easy way to access GPT-4 and other LLMs through deployed \"apps\" that act like API endpoints.","Currently, Scale doesn't support token streaming and configuring parameters like temperature through SillyTavern's UI.","Scale API is not free, but offers a $5 trial if you link a credit card."]},{"l":"Quick Start","p":["{{ input }}","Click \"Save New Variant\"","Complete the next response in this fictional chat.","Configure the model parameters.","Create a \"Variant\", which sets the parameters (system prompt, model, temperature, response token limit, etc)","Create a Scale Spellbook account at https://spellbook.scale.com(if your country is not supported, use a VPN)","Create an \"App\" with any name and description","Go to your new Variant and click Deploy","Maximum Tokens: 400 - 600 (depending on message length preference)","Model: GPT-4","Navigate to SillyTavern, select \"Chat Completion\" API, and Scale source","Paste the API key and URL into the appropriate fields and click \"Connect\"","Replace the contents of the \"User\" section of the prompt with the following:","Select a proper language model to be deployed (GPT-4 is recommended)","Temperature:~ 0.6 - 0.9","This will create an API key and URL for your bot"]},{"l":"Credits","p":["Implementation and documentation are inspired by the work of khanon on TavernAIScale."]}],[{"l":"TabbyAPI","p":["A FastAPI based application that allows for generating text using an LLM using the Exllamav2 backend, with support for Exl2, GPTQ, and FP16 models.","GitHub"]},{"l":"Quickstart","p":["Follow the installation instructions on the official TabbyAPI GitHub.","Create your config.yml to set your model path, default model, sequence length, etc. You can ignore most (if not all) of these settings if you want.","Launch TabbyAPI. If it worked, you should see something like this:","TabbyAPI terminal","Under the Text Completion API in SillyTavern, select TabbyAPI.","Copy your API key from the TabbyAPI terminal into Tabby API key and make sure your API URL is correct (it should be http://127.0.0.1:5000 by default).","If you did everything correctly, you should see something like this in SillyTavern:","TabbyAPI SillyTavern","You can now chat using TabbyAPI!"]},{"l":"TabbyAPI Loader","p":["The developers of TabbyAPI created an official extension to load/unload models directly from SillyTavern. Installation is simple:","In SillyTavern, click on the Extensions tab and navigate to Download Extensions & Assets.","Copy https://raw.githubusercontent.com/theroyallab/ST-repo/main/index.json into Assets URL and click the plug button to the right.","You should see something like this. Click the download button next to Tabby Loader.","Tabby Loader","If the installation was successful, you should see a green pop-up message at the top of your screen. Under the extensions tab, navigate to TabbyAPI Loader and copy your admin key from the TabbyAPI terminal into Admin Key.","Click the refresh button next to Model Select. When you click on the textbox just below it, you should see all of the models in your model directory.","Tabby Loader Extension","You can now load and unload your models directly from SillyTavern!"]},{"l":"Support","p":["Still need help? Visit the TabbyAPI GitHub for a link to the developer's official Discord server and read the wiki."]}],[{"l":"Prompts","p":["When you send a message to your AI, the text you write is combined with other text to form a single request that's sent to the AI. This combined text is called a \"prompt\" or sometimes the \"request\" or \"context.\"","The prompt can include a variety of different types of text, including:","Main instructions to the AI about how to generate a response","Definitions of the roles that the AI should take on","Definitions of the role that you are taking on","Information about the \"world\" that the AI is interacting with","Relevant documents or information from Data Bank","Summaries of the past conversation","Results of web searches or other external data sources","Previous messages in the conversation","Your message to the AI","Final instructions for the AI about how to generate a response","This can be a lot to manage! To help you understand how to structure and modify the request that's sent to the AI, SillyTavern identifies different elements that you might want to include in your prompt. You can then structure your prompt to include the things that make sense for the way you want to interact with the AI.","Many of these elements are explained in the sections where you will change them. For example, to describe the role that you would like the AI to take on, you could use the Description field in Character Design."]},{"l":"Viewing the Prompt","p":["Reading the final prompt that's sent to the AI is very helpful for understanding what the AI was told, and why it generated the response that it did. You can view the prompt in several ways:","Using the Prompt Itemization icon on the reply message from the AI","Using the Prompt Inspector extension","Checking the logs in the terminal window that you're running SillyTavern in","Checking the console in your browser's developer tools"]},{"l":"Changing how the Prompt is Built","p":["Presenting all the parts of your prompt to the AI in the right way is crucial for getting the best responses. You can control how the prompt is built.","Use the Advanced Formatting panel to customize prompt construction for Text Completion APIs.","Use the Prompt Manager to customize prompt construction for Chat Completion APIs."]},{"i":"main-prompt-system-prompt","l":"Main Prompt (System Prompt)","p":["The Main Prompt (or System Prompt) defines the general instructions for the model to follow. It sets the tone and context for the conversation. For example, it tells the model to act as an AI assistant, a writing partner, or a fictional character.","The System Prompt is a part of the Story String and usually the first part of the prompt that the model receives.","The Main Prompt is one of the default prompts in Prompt Manager. It is usually the first message in the context that the model receives, attributed to (\"sent by\") the system role.","The default Main Prompt is:","Write {{char}}'s next reply in a fictional chat between {{char}} and {{user}}.","The {{char}} and {{user}} placeholders are replaced with the names of the character and persona that you've defined in the conversation.","You can use any of the supported {{macro}} tags in the Main Prompt to include information that might vary between conversations or changes as the conversation progresses."]},{"l":"Adjusting the Main Prompt","p":["The default main prompt helps the model understand what it's expected to do with the character and persona information that follows, how to interpret the past conversation, and what kind of response to generate. It's a flexible general-purpose prompt that works well for many situations, because it establishes that the AI is writing as a character in a conversation with your persona.","However, you can adjust the main prompt to better suit your needs. Here are some common reasons to adjust the main prompt:","Provide additional instructions: for example, you want the AI to explain its reasoning, follow specific rules, or avoid certain topics","Clarify the role of the AI: for example, you want the AI to act as a narrator, a storyteller, or a guide","Change the context of the conversation: for example, you want the AI to respond as if it were an AI assistant, text adventure game, or a writing partner","All the examples in this guide have worked well for other users, but the prompt that works for your needs and the model you're using might be different. Experiment with different instructions and prompting styles to see what works best for you. If you're not sure what to try, you can always ask for help in the SillyTavern Discord.","Giving the AI additional instructions in the Main Prompt can help it understand what you want from the conversation.","Write one reply only. Write at least one paragraph, up to four.","Markdown is enabled. Use it to format your response. Enclose code snippets in triple backticks.","Write character dialogue in quotation marks. Write {{char}}'s thoughts in parentheses.","You are an anime roleplay generation model for users aged 13 to 17. You always generate fun, age-appropriate responses.","Answer truthfully and write out your thinking step by step to be sure you get the right answer.","The AI will more easily follow instructions about what it should do than what it should not do. For example, if you want the AI to avoid writing in a certain way, it's better to tell it how you want it to write instead. And while \"Do not decide what {{user}} says or does\" is commonly included in prompts to prevent the AI from controlling your persona, some users find \"Write {{char}}'s responses in a way that respects {{user}}'s autonomy\" is more effective.","There is often a better place than the Main Prompt to include information about the user or characters, modify a character's writing and speaking style, or give other specific instructions. The Main Prompt is best used for general instructions about the conversation as a whole, or about a type of conversation that you want to have."]},{"l":"Effect of Message History","p":["When adjusting the main prompt to improve the AI's responses, consder that the AI picks up a lot from the message history. The history is its memory of past events, character interactions and relationships, and its style guide for word choice and writing style.","Use this to your advantage by also providing example messages showing how you want the AI to respond. Showing what you want is often easier than trying to explain it!","When your conversation already has history, changing the main prompt has a limited effect on the AI's responses. In terms of events and relationships, the AI assumes that the main prompt occurred in the distant past, and the message history updates it. In terms of writing style and word choice, the AI assumes that all the messages in history were generated according to the rules in the current main prompt, and that it should continue to generate messages in the same way. Some suggestions for dealing with this are:","insert current instructions close to or after the end of message history, for example by using an Author's Note","test your changes to the main prompt by starting a new conversation","edit the message history to remove or correct examples of unwanted behaviour","use the Post-History Instructions to provide final instructions to the AI","Never let the AI \"get away\" with something you don't want it to do. If you don't like the AI's response, don't continue the conversation as if it was correct. Instead, modify the prompts, regenerate the message, and continue from there. This will help the AI learn what you want."]},{"i":"removing-the-fictional-chat-context","l":"Removing the \"Fictional Chat\" Context","p":["There are situations where \"fictional chat\" might not be the right context for your conversation.","You can remove the \"fictional\" context from the Main Prompt:","Write {{char}}'s next reply in a conversation with {{user}}.","You may not want the AI to think of itself as role-playing at all. Instead of removing the idea of a character, you can remove the idea of an AI:","You are {{char}}, a helpful assistant. You provide useful information and help {{user}} with their questions."]},{"l":"AI as Narrator or Storyteller","p":["What if you want the AI to act as a narrator, describing events from an omniscient perspective, inventing its own characters and settings?","One approach is to create a named character for the AI to use as a narrator. This character could be called \"Narrator\" or \"AI\", suggesting that the AI is a general-purpose storyteller, or it could be named after a specific scenario or setting, giving the AI the task of narrating a story in that setting. The details of the setting can then be defined in the Character or in World Info.","You will need to adjust the default main prompt to reflect the AI's role. For a general-purpose narrator, you might use:","You are {{char}}, a skilled and versatile storyteller. Narrate the story.","or for a specific setting:","You are the narrator of a fantasy scenario. Play as the characters that visit {{char}}.","It helps to clarify the role of the user in the conversation. Are your messages part of the story, or are they instructions to the narrator about what your character does or says? An example that includes the user in the story:","The story should progress by responding to the actions and dialogue of {{user}}. Narrate the story in third person.","An example that keeps the user out of the story:","Enter Adventure Mode. Narrate the story based on {{user}}'s dialogue and actions after \">\". Describe the surroundings in vivid detail. Be detailed, creative, verbose, and proactive. Move the story forward by introducing fantasy elements and interesting characters.","Defining the role of the user not only helps the AI understand how to respond to your messages, but also to what extent it is allowed to control your persona. This avoids situations where the AI makes decisions for your persona that you would rather make yourself."]},{"l":"Post-History Instructions","p":["Post-History Instructions are additional instructions sent to the AI after the main prompt and the user message. They can be used to provide additional context or instructions to the AI based on the message history.","Since the Post-History Instructions are sent after the user message, they are the final instructions that the AI receives before generating a response. The AI usually gives them a higher priority than the main prompt, and they can override the main prompt's instructions.","Post-History Instructions cannot be defined globally. You could achieve the same effect with an Author's Note.","To use per-character Post-History Instructions, add them to the character's Post-History Instructions and enable both Prefer Char. Instructions and Allow Post-History Instructions.","The Post-History Instructions is added as an invisible user role injection that precedes the last line of the prompt (usually containing a response message \"header\").","Post-History Instructions is one of the default prompts in Prompt Manager. It is usually the last message in the context that the model receives, attributed to (\"sent by\") the system role. If your Chat Completion API does not support the system role, it will usually be attributed to the user role instead."]},{"i":"adding-to-the-prompt-world-info","l":"Adding to the Prompt (World Info)","p":["You can insert additional information anywhere in the prompt using the World Info feature. By setting the conditions for when the information should be inserted, you can guide the AI to include specific details, change how it responds, or add new elements to the conversation.","Some common uses of World Info include:","a \"lorebook\" or \"encyclopedia\" with information about the world or setting","a way to manage different system prompts for various characters and situations","a place to store memories that the AI should \"recall\" in the conversation","a more modular system for creating, editing, and sharing character details","a source of random events and surprises for the AI to react to, or to make you react to!"]}],[{"l":"Advanced Formatting","p":["The settings provided in this section allow for more control over the prompt-building strategy, primarily for Text Completion APIs.","Most of the settings in this panel do not apply to Chat Completions APIs as they are governed by the prompt manager system instead.","System Prompt","Context Template","Tokenizer","Custom Stopping Strings","System Prompt: not applicable, use Prompt Manager","Context Template: not applicable, use Prompt Manager"]},{"l":"Backend-defined templates","p":["Not applicable to Chat Completion APIs as they use a different prompt builder.","Some Text Completion sources provide an ability to automatically choose templates recommended by the model author. This works by comparing a hash of the chat template defined in the model's tokenizer_config.json file with one of the default SillyTavern templates.","Derive templates option must be enabled in the Advanced Formatting menu. This can be applied to Context, Instruct, or both.","A supported backend must be chosen as a Text Completion source. Currently only llama.cpp and KoboldCpp support deriving templates.","The model must correctly report its metadata when the connection to the API is established. If this didn't work, try updating the backend to the latest version.","The reported chat template hash must match the one of the known SillyTavern templates. This only covers default templates, such as Llama 3, Gemma 2, Mistral V7, etc.","If the hash matches, the template will be automatically selected if it exists in the templates list (i.e., not renamed or deleted)."]},{"l":"System Prompt","p":["For equivalent settings in Chat Completion APIs, use Prompt Manager. The Main Prompt is the equivalent of the System Prompt in Chat Completion APIs.","The System Prompt defines the general instructions for the model to follow. It sets the tone and context for the conversation. For example, it tells the model to act as an AI assistant, a writing partner, or a fictional character.","The System Prompt is a part of the Story String and usually the first part of the prompt that the model receives.","See the prompting guide to learn more about the System Prompt."]},{"l":"Context Template","p":["For equivalent settings in Chat Completion APIs, use Prompt Manager.","Usually, AI models require you to provide the character data to them in some specific way. SillyTavern includes a list of pre-made conversion rules for different models, but you may customize them however you like.","The options for this section are explained in Context Template."]},{"l":"Tokenizer","p":["A tokenizer is a tool that breaks down a piece of text into smaller units called tokens. These tokens can be individual words or even parts of words, such as prefixes, suffixes, or punctuation. A rule of thumb is that one token generally corresponds to 3~ 4 characters of text.","The options for this section are explained in Tokenizer."]},{"l":"Custom Stopping Strings","p":["Accepts a JSON-serialized array of stopping strings. Example: [\\n, \\nUser:, \\nChar:]. If you're unsure about the formatting, use an online JSON validator. If the model output ends with any of the stop strings, they will be removed from the output.","Supported APIs:","KoboldAI Classic (versions 1.2.2 and higher) or KoboldCpp","AI Horde","Text Completion APIs: Text Generation WebUI (ooba), Tabby, Aphrodite, Mancer, TogetherAI, Ollama, etc.","NovelAI","OpenAI (max 4 strings) and compatible APIs","OpenRouter (both Text and Chat Completion)","Claude","Google AI Studio"]}],[{"l":"Context Template","p":["For equivalent settings in Chat Completion APIs, use Prompt Manager.","Usually, AI models require you to provide the character data to them in some specific way. SillyTavern includes a list of pre-made conversion rules for different models, but you may customize them however you like.","Edit these settings in the \" Advanced Formatting\" panel."]},{"l":"Story string","p":["This field is a template for pre-chat character data (known internally as a story string). This is the main way to format your character card for text completion and instruct models.","The template supports Handlebars syntax and any custom text injections or formatting. See the language reference here: https://handlebarsjs.com/guide/","We provide the following parameters to the Handlebars evaluator (wrap them into double-curly braces):","description- character's Description","scenario- character's Scenario","personality- character's Personality","system- system prompt OR character's main prompt override (if exists and \"Prefer Char. Prompt\" is enabled in User Settings)","persona- selected persona description","char- character's name","user- selected persona name","wiBefore or loreBefore- combined activated World Info entries with Position set to \"Before Char Defs\"","wiAfter or loreAfter- combined activated World Info entries with Position set to \"After Char Defs\"","mesExamples- (optional) character's Example Dialogues, instruct-formatted with separator. Set \"Example Messages Behavior\" to \"Never include examples\" to avoid duplication.","A special {{trim}} macro is supported to remove any newlines that surround it. Use it in case you want some part of text NOT be separated with a newline from the previous line ( spaces are not trimmed).","WARNING: If some of the above parameters are missing from the story string template, they are not going to be sent in the prompt at all."]},{"l":"Example Separator","p":["Used as a block header and a separator between the example dialogue blocks. Any instance of START tags in the example dialogues will be replaced with the contents of this field."]},{"l":"Chat Start","p":["Inserted as a separator after the rendered story string and after the example dialogues blocks, but before the first message in context."]},{"l":"Separators as Stop Strings","p":["Adds \"Example Separator\" and \"Chat Start\" to the list of stop strings.","Helpful if the model tends to hallucinate or leak whole blocks of example dialogue preceded by the separator."]},{"l":"Names as Stop Strings","p":["Adds Character and User Persona names to the list of stop strings.","Recommended to keep it on to prevent model impersonation."]},{"l":"Allow Post-History Instructions","p":["Includes the Post-History Instructions at the end of the prompt, formatted as the last user message.","The Post-History Instructions prompt should be defined in the character card and \"Prefer Char. Instructions\" setting should be enabled.","Should be used with care, as placing instructions low in the context can lead to degraded quality of the outputs of smaller models."]},{"i":"always-add-characters-name-to-prompt","l":"Always add character's name to prompt","p":["Appends the character's name to the prompt to force the model to complete the message as the character:"]}],[{"l":"Instruct Mode","p":["Instruct Mode allows you to adjust the prompting for instruction-following models trained on various prompt formats, such as Alpaca, ChatML, Llama2, etc.","For equivalent settings in Chat Completion APIs, use Prompt Manager."]},{"l":"API support"},{"l":"Text Completion API","p":["Fully supported. This includes:","All of the sources under Text Completion","KoboldAI Classic","AI Horde"]},{"l":"Choosing a formatting","p":["A chosen instruct template must match the expectations of an actual model that is running on a backend.","This is usually reflected in a model card on HuggingFace, and some even provide SillyTavern-compatible JSON files.","Example: NeverSleep/Noromaid-13b-v0.1.1"]},{"i":"chat-completion-api-openai-claude-etc","l":"Chat Completion API (OpenAI, Claude, etc)","p":["This is not supported (and not needed) for Chat Completion APIs. They use an entirely different prompt builder."]},{"l":"NovelAI","p":["While technically supported for NovelAI, none of their models were trained to understand instruct formatting. NovelAI models can use a special instruct module that is activated automatically when an instruction wrapped in curly braces is encountered in chat messages, so using Instruct Mode for the entire prompt will lead to degraded quality of the outputs.","Here's an example that auto-activates the instruct module for NovelAI:"]},{"l":"Instruct Mode Settings"},{"l":"System Prompt","p":["The System Prompt is now a separate entity. See the Advanced Formatting page for more details."]},{"l":"Templates","p":["Provides ready-made templates with sequences for some well-known instruct models.","Changing a template resets the unsaved settings to the last saved state! Don't forget to save your template if you made any changes you don't want to lose."]},{"l":"Activation Regex","p":["If defined as a valid regular expression, when connected to a model and its name matches this regex, will automatically select this template.","Instruct mode needs to be enabled prior. Only the first regex match across templates will be selected (evaluated in alphabetical order)."]},{"l":"Wrap Sequences with Newline","p":["Each sequence text will be wrapped with newline characters when inserted into the prompt. Required for Alpaca and its derivatives.","Disable if you want to have full control over line terminators."]},{"l":"Replace Macro in Sequences","p":["If enabled, known {{macro}} substitutions will be replaced if defined in message wrapping sequences.","Also, a special {{name}} macro can be used in message prefixes to reference the actual name attached to a message (rather than a currently active {{char}} or {{user}}), which can be helpful when using group chats or /sendas command. If the name can't be determined, \"System\" is used as a fallback placeholder."]},{"l":"Include Names","p":["If enabled, prepend characters and user names to chat history logs after the prefix sequence.","The following options are available:","Never: Do not add name prefixes before the message contents.","Groups and Past Personas: Only add name prefixes to messages from group characters and past personas.","Always: Always add name prefixes before the message contents."]},{"i":"sequences-system-prompt-wrapping","l":"Sequences: System Prompt Wrapping","p":["Define how the System Prompt will be wrapped."]},{"l":"System Prompt Prefix","p":["Inserted before a System prompt."]},{"l":"System Prompt Suffix","p":["Inserted after a System prompt.","Important: this applies only to the System Prompt itself, not the entire Story String! If you want to wrap the Story String, add these sequences to the Story String template in the Context Template section."]},{"i":"sequences-chat-messages-wrapping","l":"Sequences: Chat Messages Wrapping","p":["These settings define how messages belonging to different roles will be wrapped upon building a prompt.","All prefix sequences will also be automatically used as stopping strings."]},{"l":"User Message Prefix","p":["Inserted before a User message and as a last prompt line when impersonating."]},{"l":"User Message Suffix","p":["Inserted after a User message."]},{"l":"Assistant Message Prefix","p":["Inserted before an Assistant message and as a last prompt line when generating an AI reply."]},{"l":"Assistant Message Suffix","p":["Inserted after an Assistant message"]},{"l":"System Message Prefix","p":["Inserted before a System (added by slash commands or extensions) message."]},{"l":"System Message Suffix","p":["Inserted after a System message."]},{"l":"System same as User","p":["If checked true, System messages will be using User role message sequences.","Otherwise, System messages use their own sequences (if not empty) or will not do any wrapping at all (if empty)."]},{"l":"Misc. Sequences","p":["Various advanced configurations for finer tuning of the prompt building"]},{"l":"First Assistant Prefix","p":["Inserted before the first Assistant's message.","Only the first message of the chat history counts, not the message that actually goes into the prompt first!"]},{"l":"Last Assistant Prefix","p":["Inserted before the last Assistant's message or as a last prompt line when generating an AI reply.","Not used when generating text in a background (e.g. Stable Diffusion prompts or Summaries). System Instruction Prefix or Regular Assistant Prefix will be used instead."]},{"l":"System Instruction Prefix","p":["Inserted as a last prompt line when generating neutral/system text in a background (e.g. Stable Diffusion prompts or Summaries)."]},{"l":"User Filler Message","p":["Will be inserted at the start of the chat history if it doesn't start with a User message.","Use case: when an instruct format strictly requires prompts to be user-first and have messages with alternating roles only, examples: Llama 2 Chat, Mistral Instruct."]},{"l":"Stop Sequence","p":["Text that denotes the end of the reply. Also sent as a stopping string to the backend API.","If a stop sequence is generated, everything past it will be removed from the output (including the sequence itself)."]}],[{"l":"Tokenizer","p":["A tokenizer is a tool that breaks down a piece of text into smaller units called tokens. These tokens can be individual words or even parts of words, such as prefixes, suffixes, or punctuation. A rule of thumb is that one token generally corresponds to 3~ 4 characters of text.","AI21 API: Jamba tokenizer (requires a one-time download).","API tokenizer. Queries the generation API to get the token count directly from the model. Known backends to support: Text Generation WebUI (ooba), koboldcpp, TabbyAPI, Aphrodite API. Pick if you use a supported backend.","Chat Completion APIs (non-overridable):","Claude: model-dependant tokenizer via WebTokenizers.","Cohere API: Command-R tokenizer (requires a one-time download).","Fallback tokenizer: GPT-3.5 turbo tokenizer.","Gemma tokenizer. Used by Gemini/Gemma models. Pick if you use a Gemma model.","Google AI Studio: Gemma tokenizer.","If you get inaccurate results or wish to experiment, you can set an override tokenizer for SillyTavern to use while forming a request to the AI backend:","KoboldAI Classic / AI Horde: Llama tokenizer.","Koboldcpp: model API tokenizer.","Llama 3 tokenizer. Used by Llama 3/3.1 models. Pick if you use a Llama 3/3.1 model.","Llama tokenizer. Used by Llama 1/2 models family: Vicuna, Hermes, Airoboros, etc. Pick if you use a Llama 1/2 model.","Mistral V1 tokenizer. Used by older Mistral models family and their finetunes. Pick if you use a Mistral model.","MistralAI API: Mistral V1 or V3 tokenizer (requires a one-time download).","NerdStash tokenizer. Used by NovelAI's Clio model. Pick if you use the Clio model.","NerdStash v2 tokenizer. Used by NovelAI's Kayra model. Pick if you use the Kayra model.","None. Each token is estimated to be ~ 3.3 characters, rounded up to the nearest integer. Try this if your prompts get cut off on high context lengths. This approach is used by KoboldAI Lite.","NovelAI Clio: NerdStash tokenizer.","NovelAI Kayra: NerdStash v2 tokenizer.","OpenAI: model-dependant tokenizer via tiktoken.","OpenRouter: Llama, Mistral, Gemma, Yi tokenizers for their respective models.","Scale API: GPT-4 tokenizer.","SillyTavern provides a \"Best match\" option that tries to match the tokenizer using the following rules depending on the API provider used.","Text Completion APIs (overridable):","Text Completion: API tokenizer (if supported) or Llama tokenizer.","Yi tokenizer. Used by Yi models. Pick if you use a Yi model."]},{"l":"Additional Tokenizers","p":["These tokenizers are not included in the default installation due to their size A one-time download is required when they're used for the first time.","Qwen2 tokenizer.","Command-R tokenizer. Used by Cohere source in Chat Completion.","Mistral V3 (Nemo) tokenizer. Used by MistralAI source in Chat Completion (Nemo and Pixtral models).","If you don't want to use internet downloads, the opt-out option exists in config.yaml: enableDownloadableTokenizers. Set to false to disable downloads.","You can also download tokenizers manually from the SillyTavern-Tokenizers repository. Download the JSON files and put them in the _cache subdirectory of your data root, the path is ./data/_cache by default. Create the _cache directory if it doesn't exist. After that, restart the SillyTavern server to re-initialize tokenizers.","If the required tokenizer model is not cached and downloads are disabled, a fallback tokenizer (Llama 3) will be used for counting."]},{"l":"Token Padding","p":["SillyTavern will always use the matching tokenizer for Chat Completion models, so there is no need for token padding.","Unless SillyTavern uses a tokenizer provided by the remote backend API that runs the model, all token counts assumed during prompt generation are estimated based on the selected tokenizer type.","Since the results of tokenization can be inaccurate on context sizes close to the model-defined maximum, some parts of the prompt may be trimmed or dropped, which may negatively affect the coherence of character definitions.","To prevent this, SillyTavern allocates a portion of the context size as padding to avoid adding more chat items than the model can accommodate. If you find that some part of the prompt is trimmed even with the most-matching tokenizer selected, adjust the padding so the description is not truncated.","You can input negative values for reverse padding, which allows allocating more than the set maximum amount of tokens."]}],[{"l":"CFG","p":["Page written by: kingbri","Contributors: kingbri, Guillaume \"Vermeille\" Sanchez, AliCat"]},{"i":"what-is-it","l":"What is it?","p":["CFG, or classifier-free guidance is a method that's used to help make parts of a prompt less or more prominent."]},{"l":"Supported Backend APIs","p":["Currently, the supported backends are oobabooga's textgen WebUI, NovelAI, and TabbyAPI. NovelAI had its own documentation for CFG.","WARNING: CFG increases vram usage due to ingesting more than 1 prompt! If your GPU memory runs out while generating a prompt with CFG on, consider reducing your context size, using a lesser parameter model, or turning off CFG entirely."]},{"l":"Configuration","p":["Accessing CFG settings are the same as accessing Author's note:","CFGhamburgermenupng","And here's what the CFG panel looks like:","CFGchatpanelpng","There are four dropdowns in the CFG panel:","Chat CFG","Scopes the CFG scale and prompts to only this chat","Character CFG","Scopes the CFG scale and prompts to the specified character","Global CFG","Globally overrides the CFG scale and prompts (also overrides the model preset!)","CFG Advanced Settings (formerly called CFG Prompt Cascading)","A place to combine prompts from the previous 3 dropdowns and set insertion depth.","NOTE: If the guidance scale is set to 1, nothing will be sent since that's when CFG is in an \"off\" state."]},{"l":"Group Chats","p":["In group chats, the CFG scale panel looks like this:","CFGpanelgcpng","The main change is that character CFG is removed and a checkbox called Use Character CFG Scales is present in the chat CFG dropdown. This allows for the current character's guidance scale to be used instead of whatever the chat CFG scale is set to.","The main utility of this feature is to alter the scale based on each character's individual needs.","In addition, checking the Character Negatives box in prompt cascading will append the independent character negative prompts along with the chat ones (if enabled)."]},{"l":"Concepts"},{"i":"isnt-this-in-stable-diffusion","l":"Isn't this in Stable Diffusion?","p":["Yes and no. CFG with LLMs works in a different way than what one might be used to in Stable Diffusion. LLM-based CFG works on the principle of \"prompt mixing\". The CFG formula takes a positive and negative prompt, then mixes the differences between them. From there, a combined prompt is sent and a response is generated!","Here's an illustration to help visualize this concept. The red represents the negative prompt, the blue represents the neutral prompt, and the purple represents the mixed result that's interpreted. All the white space is the same across all 3 prompts, so those are not used for CFG mixing.","stcfgdiagrampng","If you want to know more about CFG and LLMs, Vermifuge's original paper is located here. I'd suggest giving it a read/listen:","Paper - [2306.17806] Stay on topic with Classifier-Free Guidance (arxiv.org)","Audio version - https://www.youtube.com/watch?v=MGY00YFcyco"]},{"i":"do-i-need-cfg-prompts","l":"Do I need CFG prompts?","p":["No! CFG prompts are completely optional. Just adjusting the guidance scale above 1 will also help produce an effect on responses, which can accentuate chats and character interaction."]},{"i":"what-makes-a-good-cfg-prompt","l":"What makes a good CFG prompt?","p":["So, we established that CFG prompting is not the same as Stable Diffusion's negative tags and embeddings. How do we make a prompt?","Warning: This assumes that you have created a character using PLists and Ali:Chat. If you have not, feel free to experiment with various prompting techniques.","Let's say I have a character named \"John\". John is supposed to feel happy and excited all the time from his example dialogues. However, when chatting with John, he's sometimes sad and depressed.","To remove this, CFG comes to the rescue! Just make the negative prompt [John's feelings: sad, depressed] to help remove the sadness portions. You can optionally make the positive prompt [John's feelings: happy, joyful] to further bring out John's happy parts."]},{"l":"Positive Prompts","p":["I went over this in the previous section, but I'd like to touch on this a bit more. Positive prompts are used to further accentuate parts of a character. Let's use John again as our example. By making him happier with a positive prompt of [John's feelings: happy, joyful], John should start outputting dialogue with a more happy feeling than if the positive prompt was not included."]},{"i":"but","l":"But...","p":["These are just loose guidelines from experience with one specific character format. There are many other ways to create prompts that you should experiment with. Feel free to share your thoughts with other users!"]},{"l":"Guidance Scale","p":["Here's a rule of thumb. A guidance scale of 1 means that CFG is disabled. In fact, SillyTavern won't send anything to your backend if the guidance scale is 1. A guidance scale 1 will give the results shown in the other sections at varying degrees.","However, a guidance scale of 1 will give the opposite effect since the negative prompt is used as the primary prompt here.","Let's use the example with John again. The negative prompt is [John's feelings: sad, depressed] and the positive prompt is [John's feelings: happy, joyful] with a guidance scale of 0.8.","This will in turn accentuate the negative prompt more and you'll see John start to act sadder than normal rather than happier.","tldr; Use a guidance scale of 1.5 and work up and down from there based on your outputs."]},{"l":"Prompt Cascading","p":["Negatives and positives can be cascaded between CFG types (the types being per-chat, per-character, and global overrides). See the Configuration header for more information."]},{"l":"Insertion Depth","p":["Follow the basic rule: The lower something is located in the prompt, the more influential it is to the response. For chatting, I recommend using the default depth of 1 since it's very flexible with other components of SillyTavern.","However, if you want to experiment, an insertion depth of 0 is open. However, these can dramatically alter how your response will look and it's NOT recommended to use prompt cascading here!"]}],[{"l":"Prompt Manager","p":["The Prompt Manager is a system that allows for more control over the prompt-building strategy for Chat Completion APIs.","For equivalent settings in Text Completion APIs, use Advanced Formatting.","Access Prompt Manager by clicking on the \"AI Response Configuration\" button in the navigation bar. Prompt manager is below the common settings panel."]}],[{"l":"World Info","p":["World Info (also known as Lorebooks or Memory Books) is a powerful tool available in ST to insert prompts dynamically into your chat to help guide the AI replies.","Commonly, World Info (WI for short) is used to enhance the AI's understanding of the details in your fictional world, however you could use a World Info entry to insert ANYTHING that you would like to insert into the prompt.","It functions like a dynamic dictionary that only inserts relevant information from World Info entries when keywords associated with the entries are present in the message text.","The SillyTavern engine activates and seamlessly integrates the appropriate lore into the prompt, providing background information to the AI.","It is important to note that while World Info helps guide the AI toward the desired content, it does not guarantee its appearance in the generated output messages. That depends on how good your model is at making use of additional information!"]},{"l":"Pro Tips","p":["The World Info engine is a very powerful prompt management tool. Don't fixate on adding character lore alone, feel free to experiment.","Activation keywords, titles, and other information that is not in the Content field is not inserted into context, so each World Info entry should have a comprehensive, standalone description.","To create rich and detailed world lore, entries can be interlinked and reference one another by using recursive activation. See more on Recursion below.","SillyTavern offers flexible context budgeting for inserted background information. To conserve prompt tokens, it is advisable to keep entry contents concise."]},{"l":"Further reading","p":["World Info Encyclopedia: Exhaustive in-depth guide to World Info and Lorebooks. By kingbri, Alicat, Trappu."]},{"l":"Character Lore","p":["Optionally, one World Info file could be assigned to a character to serve as a dedicated lore source across all chats with that character (including groups).","To do that, navigate to a Character Management panel and click a globe button, then pick World Info from a dropdown list and click \"Ok\"."]},{"l":"Character Lore Insertion Strategy","p":["When generating an AI reply, entries from the character World Info will be combined with the entries from a global World Info selector using one of the following strategies:"]},{"i":"sorted-evenly-default","l":"Sorted Evenly (default)","p":["All entries will be sorted according to their Insertion Order as if they a part of one big file, ignoring the source."]},{"l":"Character Lore First","p":["Entries from the Character World Info would be included first by their Insertion Order, then entries from the Global World Info."]},{"l":"Global Lore First","p":["Entries from the Global World Info Info would be included first by their Insertion Order, then entries from the Character World Info."]},{"l":"World Info Entry"},{"l":"Key","p":["A list of keywords that trigger the activation of a World Info entry. Keys are not case-sensitive by default (this is configurable)."]},{"i":"regular-expression-regex-as-keys","l":"Regular Expression (Regex) as Keys","p":["Keys allow a more flexible approach to matching by supporting regex. This makes it possible to match more dynamic content with optional words or characters, spacing, and all the other utilities that regex provides. If a defined key is a valid regex (Javascript regex style, with / as delimiters. All flags are allowed), it will be treated as such when checking whether an entry should be triggered. Multiple regexes can be entered as separate keys and will work alongside each other. Inside a regex, commas are possible. Plaintext keys do not support commas, as they are treated as key separators.","An example of a use-case for advanced regex matching: An entry/instruction that should be inserted, when char is doing a weather-related action","For more information on Regex syntax and possibilities: Regular expressions - JavaScript | MDN"]},{"l":"Advanced Regex Per-Message Matching","p":["ST prefixes every chat message in the WI scan buffer with character name: and after v1.12.6, concatenates prepends them using the character value 1 (\\x01). This means you can match specific input or output from a certain character using a regex tied to that separation character.","For example, to match only the user saying \"hello\", you could use the following regex:"]},{"l":"Key Input","p":["There are two modes to enter keywords, each with a slightly different UI. In ⌨️ plaintext mode(default), keys can be entered as a comma-separated list in a single text field. Regexes can be included too, but they don't have any special highlighting. In ✨ fancy mode, the keys appear as separate elements and regexes will be highlighted as such. The control supports editing and deleting keys. The mode can be switched via the inline button inside the input control."]},{"l":"Optional Filter","p":["A list of supplementary keywords that are used in conjunction with the main keywords. See Optional Filter. These keys also support regex."]},{"l":"Entry Content","p":["The text that is inserted into the prompt upon entry activation."]},{"l":"Insertion Order","p":["Numeric value. Defines a priority of the entry if multiple were activated at once. Entries with higher order numbers will be inserted closer to the end of the context as they will have more impact on the output."]},{"l":"Insertion Position","p":["Before Char Defs: World Info entry is inserted before the character's description and scenario. Has a moderate impact on the conversation.","After Char Defs: World Info entry is inserted after the character's description and scenario. Has a greater impact on the conversation.","Before Example Messages: The World Info entry is parsed as an example dialogue block and inserted before the examples provided by the character card.","After Example Messages: The World Info entry is parsed as an example dialogue block and inserted after the examples provided by the character card.","Top of AN: World Info entry is inserted at the top of Author's Note content. Has a variable impact depending on the Author's Note position.","Bottom of AN: World Info entry is inserted at the bottom of Author's Note content. Has a variable impact depending on the Author's Note position.","@ D: World Info entry is inserted at a specific depth in the chat (Depth 0 being the bottom of the prompt).","⚙️ - as a system role message","\uD83D\uDC64 - as a user role message","\uD83E\uDD16 - as an assistant role message","Example Message entries will be formatted according to the prompt-building settings: Instruct Mode or Chat Completion prompt manager. They also follow the Example Messages Behavior rules: being gradually pushed out on full context, always kept, or disabled altogether.","If your Author's Note is disabled (Insertion Frequency = 0), World Info entries in A/N positions will be ignored!"]},{"i":"entry-title--memo","l":"Entry Title / Memo","p":["A text field for your convenience to label your entries, which is not utilized by the AI or any of the trigger logics.","If empty, can be backfilled using the entries' first key by clicking on the \"Fill empty memos\" button."]},{"l":"Strategy","p":["\uD83D\uDD35 (Blue Circle) = The entry would always be present in the prompt.","\uD83D\uDFE2 (Green Circle) = The entry will be triggered only in the presence of the keyword.","\uD83D\uDD17 (Chain Link) = The entry is allowed to be inserted by embedding similarity.","Each Entry also has a toggle that allows you to enable or disable the entry."]},{"i":"optional-filter-1","l":"Optional Filter","p":["Comma-separated list of additional keywords in conjunction with the primary key. If no arguments are provided, this flag is ignored. Supports logic for AND ANY, NOT ANY, or NOT ALL","AND ANY = Activates the entry only if the primary key and Any one of the optional filter keys are in scanned context.","AND ALL = Activates the entry only if the primary key and ALL of the optional filter keys are present.","NOT ANY = Activates the entry only if the primary key and None of the optional filter keys are in scanned context.","NOT ALL = Prevents activation of the entry despite primary key trigger, if all of the optional filters are in scanned context."]},{"i":"probability-trigger-","l":"Probability (Trigger %)","p":["This value acts like an additional filter that adds a chance for the entry NOT to be inserted when it is activated by any means (constant, primary key, recursion).","Probability = 100 means that the entry will be inserted on every activation.","Probability = 50 means that the entry will be inserted with a 1:1 chance.","Probability = 0 means that the entry will NOT be inserted (essentially disabling it).","Use this to create random events in your chats. For example, every message could have a 1% chance of waking up an Elder God if its name is mentioned in the message."]},{"l":"Inclusion Group","p":["Inclusion groups control how entries are selected when multiple entries with the same group label are triggered simultaneously. If multiple entries having the same group label were activated, only one will be inserted into the prompt.","By default, the chosen entry is selected randomly based on their Group Weight (default is 100 points) — the higher the number, the higher the probability of selection. This allows for a random selection among the triggered entries, adding an element of surprise and variety to interactions.","A single entry can be part of multiple inclusion groups if they are defined as a comma-separated list. The same logic as explained above will apply. If that entry is triggered, it will disable all other entries that are part of any of its groups. Therefore, if any of the groups are activated, this entry will not be activated."]},{"l":"Prioritize Inclusion","p":["To provide more control over which entries are activated via Inclusion Group, you can use the 'Prioritize Inclusion' setting. This option allows you to specify deterministically which entry to choose instead of randomly rolling Group Weight chances.","If multiple entries having the same group label and this setting turned on were activated, the one with the highest 'Order' value will be selected. This is useful for creating fallback sequences via inclusion groups. For example to prioritize low-depth entries with more emphasis, or to choose a specific instruction on setting the scene over another if both are valid."]},{"l":"Use Group Scoring","p":["When this setting is enabled globally or per entry, the number of activated entry keys determines the group winner selection. Only the subset of a group with the highest number of key matches will be left to be activated by Group Weight or Inclusion Priority - the rest will be deactivated and removed from the group.","Use this to give more specificity for individual entries in large groups. For example, they can have a common key and a specific key. A random entry will be inserted when a specific key is not provided, and vice versa.","The score calculation logic for primary keys is 1 match = 1 point.","For secondary keys, the interaction depends on the chosen Selective Logic:","AND ANY: 1 secondary match = 1 point.","AND ALL: 1 point for every secondary key if they all match.","NOT ANY and NOT ALL: no change.","Example:","Entry 1. Keys: song, sing, Black Cat. Group: songs","Entry 2. Keys: song, sing, Ghosts. Group: songs","The input sing me a song can activate either entry (both activated 2 keys), but sing me a song about Ghosts will activate only Entry 2 (activated 3 keys)."]},{"l":"Automation ID","p":["Allows to integrate World Info entries with STscripts from Quick Replies extension. If both the quick reply command and the WI entry have the same Automation ID, the command will be executed automatically when the entry with a matching ID is activated.","Automations are executed in the order they are triggered, adhering to your designated sorting strategy, combining the Character Lore Insertion Strategy with the 'Priority' sorting. Which leads to Blue Circle entries processed first, followed by others in their specified 'Order'. Recursively triggered entries will be processed after in the same order.","The script command will run only once if multiple entries with the same Automation ID are activated."]},{"l":"Vector Storage Matching","p":["The Vector Storage extension provides an alternative to keyword matching by using the similarity between the recent chat messages and World Info entry contents.","To enable and use this, the following prerequisites need to be met:","Vector Storage extension is enabled and is configured to use one of the available embedding sources.","The \"Enable for World Info\" checkbox is ticked in the Vector Storage extension settings.","Either the World Info entries that are allowed for keyless matching have the \"Vectorized\" (\uD83D\uDD17) status or the \"Enabled for all entries\" option is checked in the Vector Storage settings.","The choice of the vectorization model in the extension and the theoretical meaning behind the term \"embeddings\" won't be covered here. Check out the Data Bank guide if you require more info on this topic.","Vector Storage matching adheres to this set of rules:","The maximum number of entries that are allowed to be matched with the Vector Storage can be adjusted with the \"Max Entries\" setting. This number only sets the limit and does not influence the token budget set in the activation settings for World Info. All of the budgeting rules still apply.","This feature only replaces the check for keywords. All additional checks must be met for the entry to be inserted: trigger%, character filters, inclusion groups, etc.","The \"Scan Depth\" setting from Activation Settings or entry overrides is not used. The Vector Storage \"Query messages\" value is utilized instead to get the text to match against. This allows for a configuration like \"Scan Depth\" set to 0, so no regular keyword matches will be made, but entries still can be activated by vectors.","A \"Vectorized\" status is only an additional marker. The entry would still behave like a normal, enabled, non-constant record that will be activated by keywords if they are set. Remove the keywords if you want them to be activated only by vectors.","Since the retrieval quality depends entirely on the outputs of the embedding model, it's impossible to predict exactly what entries will be inserted. If you want deterministic and predictable results, stick to keyword matching."]},{"l":"Timed Effects","p":["Usually, World Info evaluation is stateless, meaning that the result of the evaluation is the same, only depending on the current chat context. However, with the introduction of Timed Effects, you can create entries that have an activation delay, stay active after being triggered, or can't be triggered after the activation."]},{"l":"Timed Effects Rules","p":["The time frames for the effects are measured in messages (not pairs of messages/exchanges), with 0 meaning there is no effect.","Effects only apply in the chat where the entry was activated. Branches inherit the state of the parent chat.","Active timed effects are removed if the chat doesn't advance, e.g. if the last message was swiped or deleted.","Making any changes to the entry that is currently on timed effect will cause the effect to be forcibly removed.","Consequent triggering of keywords does not refresh the effect duration if it's already active."]},{"l":"Types of Timed Effects","p":["Sticky - the entry stays active for N messages after being activated. Stickied entries ignore probability checks on consequent scans until they expire.","Cooldown - the entry can't be activated for N messages after being activated. Can be used together with sticky: the entry goes on cooldown when the sticky duration ends.","Delay - the entry can't be activated unless there are at least N messages in the chat at the moment of evaluation.","Delay = 0 -> The entry can be activated at any time.","Delay = 1 -> The entry can't be activated if the chat is empty (no greeting).","Delay = 2 -> The entry can't be activated if there is zero or only one message in the chat, etc."]},{"l":"Timed Effects Example","p":["Entry configuration: sticky = 3, cooldown = 2, delay = 2."]},{"l":"Activation Settings","p":["Collapsible menu at the top of the World Info screen."]},{"l":"Scan Depth","p":["Can be overridden on an entry level.","Defines how many messages in the chat history should be scanned for World Info keys.","If set to 0, then only recursed entries and Author's Note are evaluated.","If set to 1, then SillyTavern only scans the last message.","2 = two last messages, etc."]},{"l":"Include Names","p":["Defines if the names of the chat participants should be included in the scanned text buffer as message prefixes. This allows activating entries that use names as keywords without directly mentioning the names in messages.","See an example of the text to be scanned below, assuming the chat participants are named Alice and Bob.","Enabled (default):","Disabled:"]},{"i":"context---budget","l":"Context % / Budget","p":["Defines how many tokens could be used by World Info entries at once. You can define a threshold relative to your API's max-context settings (Context %) or an objective token threshold (Budget)","If the budget is exhausted, then no more entries are activated even if the keys are present in the prompt.","Constant entries will be inserted first. Then entries with higher order numbers.","Entries inserted by directly mentioning their keys have higher priority than those that were mentioned in other entries' contents."]},{"l":"Min Activations","p":["This setting is mutually exclusive with Max Recursion Steps.","Minimum Activations: If set to a non-zero value, this will disregard the limitation of \"scan-depth\", seeking all of the chat log backward from the latest message for keywords until as many entries as specified in min activations have been triggered. This will still be limited by the Max Depth setting or your overall Budget cap.","Additional scan sweeps triggered by Min Activations will not check entries added by recursion on previous steps. Only chat messages and extension prompts can trigger these additional activations. However, the entries activated by Min Activations can trigger other entries as usual."]},{"l":"Max Depth","p":["Maximum Depth to scan for when using the Min Activations setting."]},{"l":"Recursive scanning","p":["Recursive scanning allows for entries to activate other entries or be activated by others, enabling complex interactions and dependencies between different World Info entries. This feature can significantly enhance the dynamic nature of your creative scenarios. Whether recursive scanning is enabled can be controlled with the global setting Recursive Scan. There are three options available to control recursion for each entry:","Non-recursable: When this checkbox is selected, the entry will not be activated by other entries. This is useful for static information that should not change or be influenced by other world info entries.","Prevent further recursion: Selecting this option ensures that once this entry is activated, it will not trigger any other entries. This is helpful to avoid unintended chains of activations.","Delay until recursion: This entry will only be activated during recursive checks, meaning it won't be triggered in the initial pass but can be activated by other entries that have recursion enabled. Now, with the added Recursion Level for those delays, entries are grouped by levels. Initially, only the first level (smallest number) will match. Once no matches are found, the next level becomes eligible for matching, repeating the process until all levels are checked. This allows for more control over how and when deeper layers of information are revealed during recursion, especially in combination with criteria as NOT ANY or NOT ALL combination of key matches.","Entries can activate other entries by mentioning their keywords in the content text.","For example, if your World Info contains two entries:","Both of them will be pulled into the context if the message text mentions just Bessie."]},{"l":"Max Recursion Steps","p":["This setting is mutually exclusive with Min Activations.","When set to zero, recursion nesting is only limited by your prompt budget. When set to a non-zero value, limits the total number of scan sweeps to desired maximum \"nesting level\".","Example values:","1 effectively disables recursion as the check stops after the first step.","2 can only activate recursive entries once.","3 can trigger recursion twice..."]},{"l":"Case-sensitive keys","p":["Can be overridden on an entry level.","To get pulled into the context, entry keys need to match the case as they are defined in the World Info entry.","This is useful when your keys are common words or parts of common words.","For example, when this setting is active, keys 'rose' and 'Rose' will be treated differently, depending on the inputs."]},{"l":"Match whole words","p":["Can be overridden on an entry level.","Entries with keys containing only one word will be matched only if the entire word is present in the search text. Enabled by default.","For example, if the setting is enabled and the entry key is \"king\", then text such as \"long live the king\" would be matched, but \"it's not to my liking\" wouldn't.","Important: this setting can have a detrimental effect when used with languages that don't use whitespace to separate words (e.g. Japanese or Chinese). If you write entries in these languages, it is advised to keep it off."]},{"l":"Alert on overflow","p":["Shows an alert if the activated World Info exceeds the allocated token budget."]}],[{"l":"User Settings","p":["UI Customization","Change the theme, look and feel of the chat interface to suit your preferences.","Visual Novel mode","Chat to characters with sprites, like in visual novels such as Doki Doki Literature Club and other famous VN games."]},{"l":"General Settings","p":["These are the core settings that affect your overall SillyTavern experience."]},{"l":"UI Language","p":["SillyTavern's user interface is available in multiple languages. The language selector provides these options:","Default: Uses your system language if available","English: Forces English UI regardless of system settings","Other languages available through the dropdown","Note: This setting only affects the user interface text. For AI conversation translation, please use the Chat Translation extension."]},{"l":"Software Version","p":["Your current version of SillyTavern is displayed in the top-right corner. This information is essential for:","Troubleshooting problems","Ensuring compatibility with extensions","Determining if updates are available","To update SillyTavern to the latest version, please refer to the Updating documentation."]},{"l":"Account Management","p":["Control your SillyTavern user account, back up your settings and user data, and manage user roles and permissions in multi-user mode."]},{"l":"Account","p":["Account Actions","Account creation date","Account handle","Change Password: Update your account security credentials","Critical account operations that should be used with caution:","Danger Zone","Display name (editable via pencil icon)","Download Backup: Export a complete backup of all your user data","In the Account dialog, you can view and edit your profile information, change your password, and manage account settings.","Password status (locked/unlocked icon indicates protection)","Profile Information","Reset Everything: Complete account wipe and factory reset","Reset Settings: Restore all settings to factory defaults","Settings Snapshots: Create, manage, and restore backups of your user settings","User avatar (can also be changed using Personas)","User role"]},{"l":"Admin Panel","p":["Multi-account features require enableUserAccounts to be set to true in config.yaml.","Select Manage Users to view and manage existing user accounts."]},{"l":"User Profile","p":["Custom avatar management (upload/remove)","Display name and handle","Role and status information","Account creation date","Password protection status"]},{"l":"Account Controls","p":["Edit display name","Enable account","Disable account","Promote to admin","Demote to regular user"]},{"l":"Management Actions","p":["Download user data backup","Change user password","Delete account"]},{"l":"New User","p":["Select New User to create a new user account.","Display Name*(e.g., \"John Snow\")","User Handle*(lowercase letters, numbers, and dashes only)","Password (optional)","Password Confirmation","Creating a new user automatically generates a subfolder in the /data/ directory using the user's handle as the folder name."]},{"l":"Logout","p":["Sign out of your current session."]},{"l":"Settings Search","p":["A convenient search bar that helps you quickly find specific settings:","Type any keyword to filter and highlight settings anywhere in User Settings","Searches through setting names and descriptions","Helps navigate complex settings more efficiently"]},{"l":"UI Theme","p":["Change the appearance of the chat interface to suit your preferences.","For more information on the settings in this section of User Settings, see UI Customization."]},{"l":"Character Handling","p":["Char List Subheader: Choose what additional information to display under character names in the Characters list:","Character Version","Created by","Import Card Tags: Controls how tags are handled when importing character cards:","Ask - Show dialog for each import","None - Don't import any tags","All - Import all tags","Existing - Only import tags that already exist","Advanced Character Search: When enabled, uses fuzzy matching and searches all character data fields, not just names.","Prefer Char. Prompt: If enabled, uses the character card's System Prompt override when available.","Prefer Char. Instructions: If enabled, uses the character card's Post-History Instructions override when available.","Never resize avatars: Prevents cropping/resizing of imported character images. When disabled, images are resized to 512x768.","Show avatar filenames: Displays actual filenames of character avatars in the character list.","Spoiler Free Mode: Hides character definitions behind a spoiler button in the editor panel."]},{"l":"Miscellaneous","p":["Reload Chat: Reloads and redraws the current chat.","Debug Menu: Access debugging options.","Smooth Streaming: Experimental feature for smoother text generation. Includes speed control slider.","Message Sound: Plays a sound when message generation completes.","Background Sound Only: Only plays sounds when browser tab is unfocused.","Relaxed API URLs: Reduces formatting requirements for API URLs.","Lorebook Import Dialog: Shows import dialog for World Info/Lorebook when importing characters with embedded lore.","Auto-select Input Text: Automatically selects text in certain input fields when clicked.","Markdown Hotkeys: Enables keyboard shortcuts for markdown formatting.","Restore User Input: Preserves unsaved user input when page is refreshed.","MovingUI: Allows repositioning UI elements by dragging (PC only).","Reset button to restore default positions","Preset system for saving/loading UI layouts"]},{"i":"chatmessage-handling","l":"Chat/Message Handling"},{"l":"Message Display Settings","p":["Controls how messages are loaded and displayed in the chat interface. These settings affect the overall chat experience and performance.","# Messages to Load: Number of chat history messages to load before pagination (0 = All)","Streaming FPS: Update speed of streamed text (5-100 FPS)","Example Messages Behavior:","Gradual push-out","Always include examples","Never include examples"]},{"i":"input--response-controls","l":"Input & Response Controls","p":["Settings that determine how messages are sent and how the AI continues its responses.","Enter to Send: Choose between Disabled, Automatic (PC), or Enabled","\"Send\" to Continue: Use Send button to continue AI responses","Quick \"Continue\" button: Show button to extend AI's last message","Quick \"Impersonate\" button: Show button for single-message character impersonation","Swipes: Show arrow buttons for alternative AI responses (PC and mobile)","Gestures: Enable swipe gestures for generation (Mobile only)"]},{"l":"Auto-Management","p":["Automated features that help manage chat flow and content.","Auto-load Last Chat: Automatically load the most recent chat on startup","Auto-scroll Chat: Automatically scroll to newest messages","Auto-save Message Edits: Save message edits without confirmation","Confirm message deletion: Prompt before deleting messages","Auto-fix Markdown: Automatically correct markdown formatting"]},{"l":"Auto-swipe","p":["Automatically reject and regenerate AI messages based on configurable criteria.","Enable Auto-swipe: Master toggle for the auto-swipe function","Minimum generated message length: Triggers an auto-swipe if the message is shorter than this value","Blacklisted words: List of words that can trigger auto-swipe, separated by commas","Blacklisted word count to swipe: Minimum number of blacklisted words that must be detected to trigger an auto-swipe"]},{"l":"Auto-Continue","p":["Automatically continues a response if the model stopped before reaching a certain length.","This lets your AI write a long response in multiple parts, so that you can have a short response length setting while still getting long replies.","It will not make the AI write more than it would have otherwise. Asking the AI to continue a message that it considers \"finished\" does not usually work. See How to make the AI write more? for other ideas.","Enable Auto-continue: Master toggle for automatic continuation","Allow for Chat Completion APIs: Enables auto-continue functionality for Chat Completion API endpoints","Target length (tokens): The desired message length in tokens - will trigger continue if message is shorter than this value (0-1024)"]},{"i":"message-formatting--display","l":"Message Formatting & Display","p":["Controls how messages are formatted and what content is displayed.","Forbid External Media: Block embedded media from external domains","Show {{char}}: in responses: Retain character name prefix in responses if generated","Show {{user}}: in responses: Retain user name prefix in responses if generated","Show tags in responses: Allow (some) HTML tags in responses to be displayed as HTML","Relax message trim in Groups: Allow AI to speak for other characters in group chats, rather than stopping the response generation","Show group chat queue: Display response order in the character list for group chats"]},{"l":"Prompt Inspection and Debugging","p":["Log prompts to console: Output prompts to browser console","Request token probabilities: Request token probabilities for AI responses from the API. Where available, these can be viewed in Token Probabilities."]},{"l":"AutoComplete","p":["Auto-hide details","Matching style (Starts with/Includes/Fuzzy)","Visual style (Theme/Dark/Light)","Keyboard selection options","Font scaling","Width controls"]},{"l":"STscript Settings","p":["Configuration options for the STscript parser."]},{"l":"STRICT_ESCAPING","p":["Pipes don't need to be escaped in quoted values.","A backslash in front of a symbol can be escaped to provide the literal backslash followed by the functional symbol.","See Strict Escaping for more information."]},{"l":"REPLACE_GETVAR","p":["Helps to avoid double-substitutions when the variable values contain text that could be interpreted as macros.","See Replace Variable Macros for more information."]},{"l":"Debug menu","p":["Do not use them unless you fully understand their consequences.","The Debug Menu provides functionality for troubleshooting, maintenance, and development purposes. These functions should be used with caution as they can significantly impact your SillyTavern installation.","Because extensions can add debug functions, the available options will vary depending on the extensions you have installed."]},{"i":"translation--locale-functions","l":"Translation & Locale Functions","p":["Get missing translations: Analyzes the current locale (or all locales if English is selected) for missing translations and outputs results to browser console","Apply locale: Forces a refresh of the current language settings by reapplying the selected locale"]},{"i":"cache--storage-management","l":"Cache & Storage Management","p":["Clear WebSearch cache: Removes all stored search results from local cache","Purge all vector indices: Completely removes all stored vectors across all sources","Reset token cache: Clears stored token counts, forcing complete re-tokenization of all chats","Delete itemized prompts: Removes all itemized prompts from local storage"]},{"i":"data--statistics","l":"Data & Statistics","p":["Refresh Stat File: Rebuilds the statistics file using existing chat data","Backfill token counters: Recalculates token counts for all messages in current chat","Useful when switching between models with different tokenizers","Triggers chat reload after completion","Visual changes only, does not modify chat content"]},{"i":"api--extension-testing","l":"API & Extension Testing","p":["Change Mancer base URL: Modify the base URL for Mancer API server","Test WebSearch extension: Performs a test search using current settings","Send a generation request: Tests text generation using the currently selected API"]},{"i":"system--debug-tools","l":"System & Debug Tools","p":["Force onboarding: Restarts the onboarding process","Toggle event tracing: Enables/disables event tracking for debugging","Copy ST setup: [Work in Progress] Copies system configuration data to clipboard for bug reports","Each function can be executed using the \"Execute\" button beneath its description. Consider backing up your data before using these tools, as some operations cannot be undone."]}],[{"l":"UI Customization"},{"l":"UI Theme"},{"l":"Theme Management","p":["Theme files allow you to save, share, and reuse your UI customizations. You can maintain multiple themes for different moods or purposes, and switch between them instantly.","Import/Export theme files","Delete existing themes","Save changes to current theme","Save as new theme","All the settings in this section are saved to the current theme. If you switch themes, the settings will be replaced by the settings of the new theme."]},{"l":"Display Settings","p":["These display options affect how characters and messages are presented in the chat interface."]},{"l":"Avatar Style","p":["Choose between Circle, Square, or Rectangle."]},{"l":"Chat Style","p":["Style","Description","Slash command","Flat","Clean and continuous \"chat log\" style, a flat canvas for your AI interactions to come to life.","/flat/default","Bubbles","\"Instant messenger\" style with distinct bubbles for each message, delightful rounded corners, and a subtle 3D effect.","/bubble/bubbles","Document","Compact, document-like appearance with click-to-edit mode and a text-focused layout. Hides avatars, timestamps, and message control buttons for past messages.","/single/story"]},{"l":"Theme Colors","p":["Customize the color scheme of every UI element to create your perfect theme. Colors can be selected using a color picker, and include transparency options where applicable.","Main Text","Italics Text","Underlined Text","Quote Text","Text Shadow","Chat Background","UI Background","UI Border","User Message","AI Message"]},{"i":"layout--visual-settings","l":"Layout & Visual Settings","p":["Fine-tune the visual presentation of the interface with these sliders.","Chat Width: Adjust chat window width (25-100% of screen)","Font Scale: Customize text size (0.5-1.5x)","Blur Strength: Control UI panel blur (0-30)","Shadow Width: Adjust text shadow intensity (0-5)"]},{"l":"Theme Toggles","p":["Avatar Hover Magnification: Zoom effect on avatar hover","Characters Hotswap: Quick-select buttons for favorite characters","Chat Timestamps: Display message timestamps","Compact Input Area: Single-row input (Mobile only)","Expand Message Actions: Always show full message context menu","Hide Chat Avatars: Remove avatars from chat","Mad Lab Mode: Unrestricted parameter ranges","Message IDs: Display sequential message numbers","Message Timer: Show AI response generation time","Message Token Count: Show token counts per message","Model Icons: Show AI model icons for messages","No Blur Effect: Remove background blur for better performance","No Text Shadows: Disable text shadow effects","Reduced Motion: Disable animations and transitions","Swipe # for All Messages: Show swipe numbers on all messages (Mobile)","Tags as Folders: Organize characters using tags as folders","These switches control various UI features and behaviors. Some options can improve performance on lower-end devices, while others add useful information or functionality to the chat interface.","Visual Novel mode: Compact chat with background sprite","Zen Sliders: Simplified parameter controls"]},{"l":"Custom CSS","p":["Allows you to apply custom CSS styles to further customize the appearance of the chat interface.","Use Expand to expand the editor window for better visibility and editing.","If you switch themes, your custom CSS will be replaced by the custom CSS of the new theme. Ensure you save your custom CSS to a theme if you want to keep it when switching themes.","If you use a lot of custom CSS, or want to use the same custom CSS with several themes, the unofficial CSS Snippets extension can help you manage and organize your custom CSS."]},{"l":"Message Sound","p":["To play your own custom sound on receiving a new message from bot, replace the following MP3 file in your SillyTavern folder:","public/sounds/message.mp3","Plays at 80% volume.","If the \" Background Sound Only\" option is enabled, the sound plays only if SillyTavern window is unfocused."]},{"l":"Formulas Rendering","p":["To enable math formulas rendering, use the LaTeX extension. To get the extension, you need to install it via the \"Download Extensions & Assets\" menu in SillyTavern.","Type your formulas in code blocks with latex or asciimath language identifiers for LaTeX and AsciiMath respectively. The extension uses KaTeX for rendering.","The legacy $ and $$ wrapper syntax is no longer supported. Please use the following regex scripts to polyfill the old syntax:","$$ - LaTeX","$ - AsciiMath"]}],[{"i":"visual-novel-vn-mode","l":"Visual Novel (VN) Mode","p":["Visual Novel Mode is a special screen layout in SillyTavern that allows you to chat to characters with sprites (or their character card image) that resembles that of a visual novel like Doki Doki Literature Club, The Fruits of Grisaia, Fate: Stay/night and other famous VN games."]},{"l":"Toggling Visual Novel Mode"},{"l":"Enabling Visual Novel Mode","p":["Visual Novel Mode comes built in with SillyTavern and can be toggle by going to User Settings(User Settings Icon) and checking Visual Novel Mode below No Text Shadows.","User Settings"]},{"l":"Disabling Visual Novel Mode","p":["Disabling Visual Novel Mode is the same steps as enabling it. Untoggle Visual Novel Mode and you should be back to the normal chat screen itself.","Some extensions (like the Prome VN Extension) will toggle 'Visual Novel Mode' on if you use their own respective VN modes. Enabling/Disabling VN Mode from the User Settings menu will also affect these extensions as well."]},{"l":"The Visual Novel UI","p":["VN Display","In Visual Novel Mode, the UI is altered slightly in order to accommodate character sprites (or the character card image) which is shown in the center. In a group chat with multiple characters however, the character sprites will spread themselves out, accommodating for each other as shown below.","Group VN Display"]},{"l":"VN Mode with MovingUI","p":["To toggle MovingUI, go to User Settings and check on MovingUI. Do note that this feature only works on Desktops.","If MovingUI is enabled in User Settings, the sprites (or character card image) can be moved around if you wish to move them around or place them in a more specific area on the screen.","If the size of your character sprites are relatively big it will be a challenge to try and move certain sprites around with MovingUI as the button to drag sprites around might be covered underneath a existing sprite. You will probably have to move them around a bit more than normal, especially if there is more characters on the screen for better placement.","Group VN Display (MovingUI)"]},{"l":"Obtaining Character Sprites","p":["Obtaining character sprites can be done by browsing the internet for existing sprites, for say, a existing character from a Visual Novel or a game that uses a Visual Novel feature such as DDLC or CounterSide. If the character you desire sprites form does not come with sprites already, you have several options remaining.","Search the character post for any sprite ZIP package or link to a sprite pack.","Some bot creators may release their bots with a sprite pack (either within the same post or in a sprites channel). Search those posts if someone hasn't made sprites of the character you want already.","Create your own using LoRAs and Stable Diffusion.","Generating sprites from scratch is time-consuming (especially if no LoRAs exist for your character and/or for the Stable Diffusion model you want to use) and will require decent hardware in order to generate them, more so if you plan on making 28 sprite expression than 6 and if you are using SDXL and/or upscaling sprites to a more higher resolution.","Use the character card image. It might not be like a sprite, but at least you have something to look at on-screen. However, multiple character cards cannot be used in VN mode.","With the Prome Visual Novel Extension 1.0.6+, there is a feature called Emulate Character Card as Sprite that allows you to have a group chat with both sprite and non-sprite characters by using their character card as a sprite in chat.","Character Card Group Chat"]},{"l":"VN Extensions"},{"l":"Prome Visual Novel Extension","p":["The Prome Visual Novel Extension is an endorsed third-party extension from Bronya Rand and Prometheus that enhances the visual novel experience in SillyTavern even further with features such as Letterbox Mode which makes the visual novel UI more \"cinematic\", Focus Mode with Darken Character Sprites, Traditional VN Mode where only the last message in chat appears in chat and more planned to come!","Letterbox Mode","Traditional VN Mode","Horizontal Letterbox Mode","Hide Sheld (Message Box)","Focus Mode (w/ Darken Sprites)","Sheld Hide","Focus Mode w/ Darken Sprites","To install the Prome Visual Novel Extension, you can either install by going to Download Extensions Assets and finding Prome Visual Novel Extension, or follow the installation instructions on the Prome Visual Novel Extension Github page. Adjusting Prome's settings can be found either in Extensions-> Prome (Visual Novel Extension) or via the \uD83E\uDE84 (Wand) menu."]}],[{"l":"Personas"},{"i":"what-is-a-persona","l":"What is a persona?","p":["A persona in SillyTavern represents a combination of a user name and a picture that create a unique identity for the character you play in your chats or identify yourself as.","Creating user personas is optional, but it is a good way to automate routine actions."]},{"i":"how-to-create-a-persona","l":"How to create a persona?","p":["To create a persona:","Open the Persona Management panel (smiley face icon) in the top bar.","Select an existing avatar, or create a blank persona with a dummy image (\"Create\" button).","Find the persona in the list and pick the leftmost context action button (\"Bind a name to that avatar\").","Input a desired name into the popup window. Confirm by clicking an \"OK\" button.","The avatar now represents a Persona. Click on the avatar to select it, and this will also automatically update the user name."]},{"l":"Persona Description","p":["The contents of this field represent any specific information that you want to bind to the selected persona. It could be any kind of description of your user character: mental and physical traits, age, occupation, etc. Here you can also use replacement macros like {{user}}, {{char}}, and other supported parameters.","If defined, the Persona Description will be inserted into the AI prompt in one of the chosen places:","In Prompt Manager (Chat Completion API) or Story String (other APIs). This is the default position.","Top of an Author's Note (if Author's Note is not disabled).","Bottom of an Author's Note (if Author's Note is not disabled).","However, keep in mind that picking a persona when you have set user description on an unbound avatar will not keep your changes.","To permanently save the user description, bind the currently selected avatar to a user name."]},{"l":"Persona locking","p":["One chosen persona could be locked to the currently open individual or group chats. If the currently selected persona differs from the locked one, it will be automatically selected when you open that chat."]},{"l":"To lock a persona","p":["Open a chat (either group or individual).","Select a desired persona by clicking on its avatar.","Click the lock icon in the buttons row next to a name input.","To revert this action, click the unlock icon. Then persona won't be changed automatically when the chat is reopened.","Alternatively, you could use /lock and /unlock slash commands to achieve the same result."]},{"l":"Default persona","p":["You can select one persona as your preferred default identity, automatically selecting it for all new chats and chats where a persona is not locked. The default persona is represented by a yellow outline on the Persona Management panel.","To set persona as a default, click the \"crown\" button in the persona block, then confirm your action.","To undo this action and unset the default persona, click the \"crown\" button again."]},{"l":"Pro Tips","p":["Switching user personas in chat does not automatically change the attribution of previously sent user messages. That way it is possible to use multiple user characters at once.","You can attribute all user-sent messages in the currently open chat to a currently selected persona by clicking the \"sync\" button on the Persona Management panel or by using the /sync slash command.","To change the persona image without deleting it, hover over the avatar on the Persona Management panel and click the bottom-left button. Then choose a new image and it will be replaced, preserving your set description and chat lock states.","To quickly change a persona while in chat without opening the Persona Management panel, use the /persona slash command. For example, /persona Blaze.","You can do backups of your Personas and restore them using the previously saved file if needed. Look for the \"Backup\" and \"Restore\" buttons in the Persona Management panel."]}],[{"l":"Characters","p":["Characters are the AI identities that you can create and manage to shape the AI's role in the conversation. Each character has a name, personality, and conversation history. You can create as many characters as you like, and switch between them at any time.","Characters can be used in solo chats, or add multiple characters to a group chat to let them interact with each other."]},{"l":"Character Management Panel","p":["Open the Characters panel from the navbar to access the character list. Click on a character or group to chat with them or edit them, or choose Create New Character to add a new character."]},{"l":"Panel Controls","p":["Pin Panel: Keep panel open while interacting","Character List: Return to character list view","HotSwap Bar: Quick access to favorite characters"]},{"l":"Character List","p":["Create New Character: Add a new character","Import Character: Load character from file","External Import: Import from URL","Create Group: Start a new group chat"]},{"l":"Search and sort","p":["Search Bar: Filter characters by name or attributes","Sort Dropdown: Multiple sorting options:","Alphabetical (A-Z, Z-A)","Chronological (Newest, Oldest)","Usage-based (Recent, Most/Least chats)","Size-based (Most/Least tokens)","Special (Favorites, Random)"]},{"l":"Filter characters by type or tag","p":["Favorites Filter: Show favorite characters","Groups Filter: Show only group chats","Tags as Folders: Organize by tag hierarchy","Manage Tags: Tag configuration","Tag List: View all available tags","Clear Filters: Reset all filters"]},{"i":"character-creationedit-panel","l":"Character Creation/Edit Panel","p":["Avatar Image: Upload and preview character profile picture","Token Count: Token usage for the character","Stats: Chat history and usage statistics","Tag management"]},{"l":"Quick Actions","p":["Favorite toggle","Advanced definitions","Character lore","Chat lore: link the chat to a World Info","Export character","Duplicate","Delete"]},{"l":"Extended Options","p":["World Info linking","Card lore import","Scenario override","Persona conversion","Character rename","Source linking","Replace/Update","Tag import","Gallery view"]},{"l":"Content Fields","p":["Character Description: Brief character summary","First Message: Initial greeting or prompt when starting a new chat","Alternative greetings: Define multiple first messages that you can swipe between when starting a chat"]},{"l":"Advanced Definitions Panel","p":["Click on the Advanced Definitions button to access the extended character settings."]},{"i":"prompt-overrides-chat-completioninstruct-mode","l":"Prompt Overrides (Chat Completion/Instruct Mode)","p":["Main Prompt: Replaces default main/system prompt, can use{{original}} placeholder to include the original prompt","Post-History Instructions: Overrides default post-history instructions"]},{"i":"creators-metadata","l":"Creator's Metadata","p":["Non-prompt information about the character:","Creator name/contact","Character version","Creator's notes","Embedded tags list"]},{"l":"Character Personality","p":["Personality Summary: Brief overview of character's traits","Scenario: Context and circumstances of the dialog","Character's Note: Custom message with selectable depth and message role (also see Author's Note)","Talkativeness(Group Chats): Slider for Shy → Normal → Chatty","Example Messages: Examples of character's writing style"]},{"l":"Group Chat Management","p":["If this is a group chat, you can manage the group members and settings from this panel.","See Group Chats for more details."]}],[{"l":"Character Design"},{"l":"Character Description","p":["Used to add the character description and the rest that the AI should know. This will always be present in the prompt, so all the important facts should be included here.","For example, you can add information about the world in which the action takes place and describe the characteristics of the character you are playing for.","It could be of any length (be it 200 or 2000 tokens) and formatted in any style (free text, W++, conversation style, etc)."]},{"l":"Methods and format","p":["Methods of character formatting is a complicated topic beyond the scope of this documentation page.","Recommended guides that were tested with or rely on SillyTavern's features:","Trappu's PLists + Ali:Chat guide: https://wikia.schneedc.com/bot-creation/trappu/creation","AliCat's Ali:Chat guide: https://rentry.co/alichat","kingbri's minimalistic guide: https://rentry.co/kingbri-chara-guide"]},{"l":"Character tokens","p":["TL;DR: If you're working with an AI model with a 2048 context token limit, your 1000 token character definition is cutting the AI's 'memory' in half.","To put this in perspective, a decent response from a good AI can easily be around 200-300 tokens. In this case, the AI would only be able to 'remember' about 3 exchanges worth of chat history."]},{"i":"why-did-my-characters-token-counter-turn-red","l":"Why did my character's token counter turn red?","p":["When we see your character has over half of the model-defined context length of tokens in its definitions, we highlight it for you because this can lower the AI's capabilities to provide an enjoyable conversation."]},{"i":"what-happens-if-my-character-has-too-many-tokens","l":"What happens if my Character has too many tokens?","p":["Don't worry - it won't break anything. At worst, if the Character's permanent tokens are too large, it simply means there will be less room left in the context for other things (see below).","The only negative side effect this can have is the AI will have less 'memory', as it will have less chat history available to process.","This is because every AI model has a limit to the amount of context it can process at one time."]},{"i":"context","l":"'Context'?","p":["This is the information that gets sent to the AI each time you ask it to generate a response:","Character definitions","Chat history","Author's Notes","Special Format strings","[bracket commands]","SillyTavern automatically calculates the best way to allocate the available context tokens before sending the information to the AI model."]},{"i":"what-are-a-characters-permanent-tokens","l":"What are a Character's 'Permanent Tokens'?","p":["These will always be sent to the AI with every generation request:","Character Name (keep the name short! Sent at the start of EVERY Character message)","Character Description Box","Character Personality Box","Scenario Box"]},{"i":"what-parts-of-a-characters-definitions-are-not-permanent","l":"What parts of a Character's Definitions are NOT permanent?","p":["The first message box - only sent once at the start of the chat.","Example messages box - only kept until chat history fills up the context (optionally these can be forced to be kept in context)"]},{"l":"Popular AI Model Context Token Limits","p":["LLaMA 3 and its finetunes - 8192","OpenAI GPT-4 - up to 128k","Anthropic's Claude - 200k (Claude 3) or 100k (Claude 2)","NovelAI - 8192 (Erato and Kayra, Opus tier; Clio, all tiers), 6144 (Kayra, Scroll tier), or 3072 (Kayra, Tablet tier)"]},{"l":"Personality summary","p":["A brief description of the personality.","Examples:","Cheerful, cunning, provocative","Aqua likes to do nothing and also likes to get drunk"]},{"l":"First message","p":["The First Message is an important thing that sets exactly how and in what style the character will communicate.","The character's first message should be long so that later it would be less likely that the character would respond with very short messages.","You can also use asterisks ** to describe the character's actions.","For example:"]},{"l":"Examples of dialogue","p":["Describes how the character speaks. Before each example, you need to add the <START> tag. The blocks of examples dialogue are only inserted if there's a free space in the context for them and pushed out of context block by block. <START> will not be present in the prompt as it is just a marker - it will be instead replaced with \"Example Separator\" from Advanced Formatting for Text Completion APIs and contents of the \"New Example Chat\" utility prompt for Chat Completion APIs.","Use {{char}} instead of the character name.","Use {{user}} instead of the user name.","Example:"]},{"l":"Scenario","p":["Circumstances and context of the dialogue."]},{"l":"Favorite Character","p":["Mark the character as a favorite to quickly filter on the side menu bar by selecting the \"Favorites\" sort option. Favorite characters have a golden highlight in the list. This will also make the character portrait appear in the hotswaps area (if enabled in User Settings)."]}],[{"i":"macros-replacement-tags","l":"Macros (replacement tags)","p":["This list may be incomplete or outdated. Use the /help macros slash command in any SillyTavern chat to get the list of macros that work in your instance.","Macros can be used in character description, author's notes, world info and many other places and replaced with the corresponding values when generating a response. They can be used to insert dynamic content into the prompt, such as the user's name, character's description, or the current time. Macros are enclosed in double curly braces, e.g. {{user}} and are usually case-insensitive. Please keep in mind that macro nesting is currently not supported.","Note: some extensions may also add special context-specific macros that only work in certain areas (i.e. special placeholders for extension prompts). These will not be documented here unless the macro is not bound to a specific functionality."]},{"l":"General Macros","p":["{{// (note)}}","{{banned text here}}","{{bias text here}}","{{char_version}}","{{char}} or BOT","{{charJailbreak}}","{{charPrompt}}","{{currentSwipeId}}","{{date}}","{{datetimeformat ...}}","{{description}}","{{firstIncludedMessageId}}","{{group}} or {{charIfNotGroup}}","{{groupNotMuted}}","{{idle_duration}}","{{input}}","{{isodate}}","{{isotime}}","{{lastCharMessage}}","{{lastGenerationType}}","{{lastMessage}}","{{lastMessageId}}","{{lastSwipeId}}","{{lastUserMessage}}","{{mesExamples}}","{{model}}","{{newline}}","{{noop}}","{{original}}","{{persona}}","{{personality}}","{{pick::(args)}}","{{pipe}}","{{random::arg1::arg2}}","{{random:(args)}}","{{reverse:(content)}}","{{roll:(formula)}}","{{scenario}}","{{time_UTC±X}}","{{time}}","{{timeDiff::(time1)::(time2)}}","{{trim}}","{{user}} or USER","{{weekday}}","1-based ID of the currently displayed last message swipe.","Allows leaving a note that will be replaced with blank content. Not visible for the AI.","Alternate syntax for random that supports commas in its arguments.","Alternative to random, but the selected argument is stable on subsequent evaluations in the current chat if the source string remains unchanged.","Can be used in Prompt Overrides fields to include the default prompt from system settings. Applied to Chat Completion APIs and Instruct mode only.","Character's description.","Character's examples of dialogue (unaltered and unsplit).","Character's Main Prompt override.","Character's name.","Character's personality.","Character's Post-History Instructions Prompt override.","Character's scenario or chat scenario override (if set).","Comma-separated list of group member names or character name in solo chats.","Contents of the user input bar.","Current date/time in specified format (e.g. {{datetimeformat DD.MM.YYYY HH:mm}}).","Current system date.","Current system time.","Current time in the specified UTC offset (timezone), e.g. for UTC+02:00 use {{time_UTC+2}}.","Description","Dynamically adds quoted text to banned word sequences for Text Generation WebUI backend. Does nothing for other backends. Quotes required.","Generates a random value using D&D dice syntax: XdY+Z (e.g. {{roll:d6}} generates a value 1-6).","Inserts a humanized string of the time range since the last user message was sent (examples: 4 hours, 1 day).","Inserts a newline.","Last chat message ID.","Last chat message sent by character.","Last chat message sent by user.","Last chat message text.","Macro","No operation, just an empty string.","Number of swipes in the last chat message.","Only for slash command batching. Replaced with the returned result of the previous command.","Returns a random item from the list (e.g. {{random:1,2,3,4}} will return 1 of the 4 numbers at random).","Reverses the content of the macro.","Same as {{group}} but excludes muted members.","Sets a behavioral bias for the AI until the next user input. Quotes around text are required.","Text generation model name for the currently selected API. Can be inaccurate!","The character's version number.","The current ISO date (YYYY-MM-DD).","The current ISO time (24-hour clock).","The current weekday.","The ID of the first message included in the context. Requires generation to be run at least once in the current session.","The time difference between time1 and time2. Accepts time and date macros.","Trims newlines surrounding this macro.","Type of the last queued generation request. Values: \"normal\", \"impersonate\", \"regenerate\", \"quiet\", \"swipe\", \"continue\".","User's name.","User's persona description."]},{"l":"Instruct Mode and Context Template Macros","p":["(enabled in the Advanced Formatting settings)","{{chatStart}}","{{defaultSystemPrompt}}","{{exampleSeparator}}","{{instructAssistantPrefix}}","{{instructAssistantSuffix}}","{{instructFirstAssistantPrefix}}","{{instructFirstUserPrefix}}","{{instructLastAssistantPrefix}}","{{instructLastUserPrefix}}","{{instructStop}}","{{instructSystemInstructionPrefix}}","{{instructSystemPrefix}}","{{instructSystemPrompt}}","{{instructSystemPromptPrefix}}","{{instructSystemPromptSuffix}}","{{instructSystemSuffix}}","{{instructUserFiller}}","{{instructUserPrefix}}","{{instructUserSuffix}}","{{maxPrompt}}","{{systemPrompt}}","Assistant first output sequence.","Assistant last output sequence.","Assistant message prefix sequence.","Assistant message suffix sequence.","Context template chat start line.","Context template example dialogues separator.","Description","Instruct stop sequence.","Instruct system prompt.","Instruct user first input sequence.","Instruct user last input sequence.","Macro","Max size of the prompt in tokens (context length reduced by response length).","System instruction prefix sequence.","System message prefix sequence.","System message suffix sequence.","System prompt content (excluding character prompt override).","System prompt content, including character prompt override if allowed and available.","System prompt prefix sequence.","System prompt suffix sequence.","User filler message text.","User message prefix sequence.","User message suffix sequence."]},{"l":"Chat variables Macros","p":["{{addglobalvar::name::value}}","{{addvar::name::increment}}","{{decglobalvar::name}}","{{decvar::name}}","{{getglobalvar::name}}","{{getvar::name}}","{{incglobalvar::name}}","{{incvar::name}}","{{setglobalvar::name::value}}","{{setvar::name::value}}","{{var::name::index}}","{{var::name}}","Description","Global variables = works in any chat for any character","Local variables = unique to the current chat","Macro","Replaced with empty string, adds a numeric value of \"increment\" to the global variable \"name\".","Replaced with empty string, adds a numeric value of \"increment\" to the local variable \"name\".","Replaced with empty string, sets the global variable \"name\" to \"value\".","Replaced with empty string, sets the local variable \"name\" to \"value\".","Replaced with the result of decrementing the value of global variable \"name\" by 1.","Replaced with the result of decrementing the value of variable \"name\" by 1.","Replaced with the result of incrementing the value of global variable \"name\" by 1.","Replaced with the result of incrementing the value of variable \"name\" by 1.","Replaced with the value at index of the scoped variable \"name\" (for arrays/objects in STscript).","Replaced with the value of the global variable \"name\".","Replaced with the value of the local variable \"name\".","Replaced with the value of the scoped variable \"name\" (STscript only)."]},{"l":"Extension-specific Macros","p":["Added by extensions and only work under certain conditions.","Macro","Description","{{summary}}","Replaced with the summary of the current chat session (if available)."]}],[{"l":"Chat File Management","p":["This page describes the ways you can manage your AI chat files.","Some of these options are available in the \"Manage chat files\" dialog that opens from the bottom left options menu."]},{"l":"Solo Chats vs Group Chats","p":["The simplest way to use a character card is a Solo chat; just click on their card and start chatting.","Once you have a few character cards, you can also use the \"Create New Chat Group\" button to create a group chat including multiple characters which will then interact with each other and you."]},{"l":"Chat import","p":["Import chats from Character.AI into SillyTavern.","To import Character.AI chats and bots, use the CAI Tools browser extension: https://github.com/irsat000/CAI-Tools.","Other programs and tools that you can import chats from include:","TavernAI (original): https://github.com/TavernAI/TavernAI","Text Generation WebUI (oobabooga): https://github.com/oobabooga/text-generation-webui","Agnai: https://github.com/agnaistic/agnai","KoboldAI Lite: https://github.com/LostRuins/lite.koboldai.net","RisuAI: https://github.com/kwaroran/RisuAI"]},{"l":"Export as .jsonl","p":["When clicking on \"Manage chat files\", each entry on the the chat file list will have a button to export it in a format that can then be re-imported as is. Use this to share or migrate chats including all their metadata (but excluding images and file attachments).","If you're mindful of privacy, be sure to inspect the exported JSONL file and scrub anything you don't want to share."]},{"l":"Export as .txt","p":["You can also export a simplified text-only version with the \"Download chat as plain text document\" button. It can't be re-imported again as it loses important metadata!"]},{"l":"Checkpoints","p":["\"Checkpoints\" are clones of the current chat, in that they copy all messages from the given chat up to a certain point, and they store a link to the source (by chat file name).","From the three dots button at the right of each chat message, you have two ways to create checkpoints:","\"Create Branch\" will clone the current chat up to that message and switch to it","\"Create Checkpoint\" will clone current chat up to that message, ask for a name and create it but NOT switch to it","You can think of them as roughly as \"open link in new tab\" and \"open link in new tab in the background\" in a browser.","You can go back to the parent from a checkpoint by entering the burger menu button on the left of the message text box, then clicking \"Back to parent chat\"."]},{"l":"Rename Chat","p":["By default chat files are given a named with the date and time they were started.","You can change this by clicking the pencil icon and typing in a new name.","Note that this will break links to that chat from checkpoints (since they are linked by chat file name)."]}],[{"l":"Group Chats"},{"l":"Reply order strategies","p":["Decides how characters in group chats are drafted for their replies."]},{"l":"Manual","p":["You can select the character to reply manually from the menu or with the /trigger command. The selected group member will be the only one to reply. User messages won't trigger any replies automatically. Triggering a generation with an empty user input will trigger a random unmuted group member to reply."]},{"l":"Natural Order","p":["Tries to simulate the flow of a real human conversation. The algorithm is as follows:","Mentions of the group member names are extracted from the last message in chat.","Only whole words are recognized as mentions! If your character's name is \"Misaka Mikoto\", they will reply only activate on \"Misaka\" or \"Mikoto\", but never to \"Misa\", \"Railgun\", etc.","Unless the \"Allow Self Responses\" setting is enabled, characters won't reply to mentions of their name in their own message!","Characters are activated by the \"Talkativeness\" factor.","Talkativeness defines how often the character speaks if they were not mentioned. Adjust this value on the \"Advanced Definitions\" screen in the character editor. Slider values are on a linear scale from 0% / Shy(character never talks unless mentioned) to 100% / Chatty(character always replies). The default value for new characters is 50% chance.","A random character is selected.","If no characters were activated at previous steps, one speaker is selected randomly, ignoring all other conditions."]},{"l":"List Order","p":["Characters are drafted based on the order they are presented in the group members list. No other rules apply."]},{"l":"Group generation handling mode","p":["This setting decides how to handle the character information of the group chat members. No matter the choice, the group chat history is always shared between all the members."]},{"l":"Swap character cards","p":["Default mode. Every time the message is generated, only the character card information of the active speaker is included in the context."]},{"l":"Join character cards","p":["The information of all of the group members is combined into one joint prompt in their list order. This can help in cases when altering large chunks of the context is undesirable, e.g. with llama.cpp prompt caching.","This mode has two sub-modes (you must choose one):","Include muted - muted characters will always be included into the joint prompt.","Exclude muted - muted characters won't be included if they aren't the current speaker.","The following fields are being combined:","Description","Scenario, if not overridden for the chat","Personality","Message examples","Character notes / Depth prompts","Important! Please be aware that due to how the typical character card is structured, the use of this mode can lead to unexpected behavior, including but not limited to: characters being confused about themselves, having merged personalities, uncertain traits, etc."]},{"l":"Join Prefix and Suffix","p":["When 'Join character cards' is selected, all respective fields of the characters are being joined together. This means that in the resulting prompt all character descriptions will be joined to one big blob of text. If you want those fields to be separated, you can define a prefix and/or suffix.","These options support normal macros and will also replace {{char}} with the relevant characters's name and <FIELDNAME> with the name of the part (e.g.: description, personality, scenario, etc.)"]},{"l":"Other Group Chat menu options"},{"l":"Mute Character","p":["The struck-out speech bubble icon next to the character avatar in the group chat menu can disable or enable replies from a particular character in the chat."]},{"l":"Force Talk","p":["The speech bubble icon next to the character avatar in the group chat menu will trigger a reply only from a particular character, bypassing the reply order strategy. It will work even if the group member is muted."]},{"l":"Auto-mode","p":["While auto-mode is enabled, the group chat will follow the reply order and trigger the message generation without user interaction. The next auto-mode turn is triggered after a 5-second delay when the last drafted character sends its message. When the user starts typing into the send message text area, the auto-mode will be disabled, but already queued generations are not stopped automatically."]},{"l":"Allow Self Responses","p":["Will allow consecutive replies from the character who sent the latest message of each turn if they happen to be triggered due to being self-mentioned when the Natural Order is selected. Has no effect on List order."]},{"l":"Group Chat Scenario Override","p":["All group members will use the entered scenario text instead of what is specified in their character cards. Branched chats inherit the scenario override from their parent and can be changed individually after that."]},{"l":"Peek Character Definitions","p":["Clicking on the character card icon next to the avatar in the group chat menu will quickly navigate to the usual character definitions screen. Any changes made here will be saved to the card itself.","To return back to the group chat, click the Group Name title link."]},{"l":"Member Management","p":["Any of your existing characters can be added, removed, muted, or re-ordered within the group chat. By default, a new member is added to the top of the group members list and then can be re-ordered using the arrow icons."]},{"l":"Group Chat pop-out","p":["The group chat menu pop-out can be activated by clicking on the icon next to the \"Current Members\" field. This creates a pop-out of the group chat menu. By enabling MovingUI from user settings, this menu can resized and dragged to any position within the interface and functions just like the regular group chat menu."]}],[{"l":"Tags","p":["Character cards and groups can be assigned zero or more tags. They are useful to organize quickly growing collections by themes, quality, provenance or whatever you like."]},{"l":"Tagging","p":["There are several ways to add or remove tags to a character card:","Import embedded tags during the import.","Open a card from the Character Management panel. From there you will be able to assign tags to a character card.","Mass tagging.","To do mass tagging, click the \"Bulk edit characters\" button (pencil icon), select the cards you want to tag, right click on any of them, then click \"Tag\" in the contextual menu.","Please note that groups cannot be mass tagged.","From this screen you will be able to:","Add or remove tags using the combo box.","Remove all tags from the selected cards (\"All\").","Remove the intersection of tags among all selected cards from those cards (\"Mutual\").","Import (create locally) all tags stored in the character card, in case you imported it (\"Import All\").","Import (create locally) tags stored in the character card which also exist locally with matching names (\"Import Existing\")."]},{"l":"Managing","p":["To view and manage all existing tags, open the Character Management panel then click on the \"Manage tags\" button (gear icon).","You can backup and restore all the information here (tag list, tag assignments to cards, colors, folder settings, etc) using the buttons on the top right.","You can use grip buttons on the left to reorder tags as they will appear in the tag filter in Character Management.","The tags backup JSON file is not intended for sharing with others as it contains information specific to your instance only, such as internal entity names!"]},{"l":"Importing tags when importing character cards","p":["When importing external character cards from downloaded images (or from the \"Import content from external URL\" button), you'll be prompted to optionally import the tags that it contains. They are not required for the card to function; tags are simply organizational.","Embedded card tags are stored in the \"Creator's Metadata\" section of \"Advanced Definitions\" menu of the character editor. If you wish to propose some tags to other users who would import that character, populate the \"Tags to Embed\" field with a comma-separated list of tags.","This popup will appear only if a User Settings option \"Import Card Tags\" is set to \"Ask\".","In the \"Import tags for CHARACTER NAME\" popup that opens, you'll see a list of Existing tags (which you already had locally with a matching name), and New tags (which you did not have locally).","You can either:","Trim the lists as needed and then hit \"Import\" - remaining Existing tags will be added to the imported character card, and remaining New tags will be created locally and then added to the card.","Or simply hit \"Import none\" to ignore tags contained in the character card and import ONLY the card.","Or \"Import All\" as a shortcut to import all tags found in the character card (NOTE: including any that you trimmed from the lists above; use the \"Import\" button if you did).","Or \"Import Existing\" as a shortcut to only import tags that existed locally with a matching name."]},{"l":"Filtering character cards","p":["After you create tags, you will see them on a row in the Character Management panel. You can click these to switch tag filtering state; in order:","One click will show cards tagged with this tag.","Another click to only show cards NOT tagged with this tag.","Another click to reset filtering by this tag.","You can filter by any number of tags at the same time."]},{"l":"Tags as Folders","p":["To use this functionality, it has to be enabled first in the User Settings, under the UI Theme column. The state of this toggle also saves with the UI theme.","From the \"Manage tags\" button (gear icon), each tag entry has a multi-state toggle button to cycle between these tags-as-folder modes (called \"bogus folder\" in the code):","one click to turn this tag into an \"open folder\". It will appear as a virtual entry in the card list; clicking into it will only show cards with that tag","another click to turn this tag into a \"closed folder\". As above, but cards tagged with this tag will not appear by default - you'll need to click into the folder to see them.","another click to reset tag-as-folder state for this tag."]}],[{"i":"authors-note","l":"Author's Note"},{"i":"what-is-it","l":"What is it?","p":["Author's Note is a powerful tool for customizing AI responses which inserts a section of text into the prompt at any position and at any frequency you desire."]},{"l":"Usage","p":["The Author's Note can be found in the Options menu on the left side of the chat input bar.","Options Menu","Author's Note Panel"]},{"i":"configuring-authors-notes","l":"Configuring Author's Notes"},{"i":"chat-specific-authors-note","l":"Chat-specific Author's Note","p":["The box at the top of the Author's Note panel contains the Author's Note for your current chat.","The Content of this box is not automatically transferred to any new chat."]},{"l":"Placement options"},{"l":"After Scenario","p":["This places the Author's Note towards the top of the context after the 'Scenario' section of the Character Definition. If no scenario is specified, it will be placed after the last portion of the Character Definition, and before the Example messages."]},{"l":"In-chat","p":["This places the Author's Note into the chat history at the specified depth.","Depth 0 = placed at the very end of the chat history.","Depth 4 = placed before the most recent 3 chat history messages, making it become the 4th entity in the chat history.","The closer the Author's Note is to the bottom of the prompt, the more impact it has on the next AI response."]},{"l":"Insertion Frequency","p":["This is how often you want the Author's Note to be included in the chat.","Frequency 0 = Author's Note will never be inserted.","Frequency 1 = Author's Note will be inserted with every user input prompt.","Frequency 4 = Author's Note will be inserted into every 4th user input prompt."]},{"i":"default-authors-note","l":"Default Author's Note","p":["The box at the bottom of the panel contains the Default Author's Note which will be applied to each new chat."]},{"l":"Common Use Cases"},{"l":"Remind AI of response formatting","p":["The Author's Note can be used to specify how the AI should write it's responses.","[Your next response must be 300 tokens in length.]","[Write your next reply in the style of Edgar Allan Poe]","[Use markdown italics to signify unspoken actions, and quotation marks to specify spoken word.]"]},{"l":"Reinforcing Instructions","p":["[Remember the instructions you were given at the beginning of this chat.]"]},{"i":"as-temporary-world-info-character-bias-or-instruct-for-non-instruct-models","l":"As temporary World Info, Character Bias, or Instruct for non-Instruct models","p":["[{{char}} is in the library]","[{{user}} has a fresh wound to his leg, so won't be able to run away.]","[{{char}} cannot speak and must communicate using hand signals.]"]}],[{"i":"data-bank-rag","l":"Data Bank (RAG)","p":["Retrieval-augmented generation (RAG) is a technique for providing external sources of knowledge to the LLM. It helps improve the accuracy of AI answers by accessing information outside of the model's training data.","SillyTavern provides a set of tools for building a multi-purpose knowledge base from a diverse number of sources, as well as using the collected data in LLM prompts."]},{"l":"Accessing the Data Bank","p":["The built-in Chat Attachments extension (included by default in release versions >= 1.12.0) adds a new option in the \"Magic Wand\" menu - Data Bank. This is your hub for managing the documents available for RAG in SillyTavern."]},{"l":"About Documents","p":["Data Bank stores file attachments, also known as documents. The documents are divided into three scopes of availability.","Global attachments - available in every chat, either solo or group.","Character attachments - available only for the currently chosen character, including when they are replying in a group. Attachments are saved locally and are not exported with the character card!","Chat attachments - available only in the currently open chat. Every character in the chat can pull from it.","While not formally a part of the data bank, you can attach files even to individual messages. Use the Attach File option from the \"Wand\" menu, or a paperclip icon in the message actions row.","What can be a document? Practically anything that is representable in plain text form!","Examples include, but are not limited to:","Local files (books, scientific papers, etc.)","Web pages (Wikipedia, articles, news)","Video transcripts","Various extensions and plugins can also provide new ways to gather and process data, more on that below."]},{"l":"Data Sources","p":["To add a document to any of the scopes, click \"Add\" and pick one of the available sources."]},{"l":"Notepad","p":["Create a text file from scratch, or edit an existing attachment."]},{"l":"File","p":["Upload a file from the hard drive of your computer. SillyTavern provides built-in converters for popular file formats:","PDF (text only)","HTML","Markdown","ePUB","TXT","You can also attach any text files with non-standard extensions, such as JSON, YAML, source codes, etc. If there are no known conversions from the type of a selected file, and the file can't be parsed as a plain text document, the file upload will be rejected, meaning that raw binary files are not allowed.","Importing Microsoft Office (DOCX, PPTX, XLSX) and LibreOffice documents (ODT, ODP, ODS) requires a Server Plugin to be installed and loaded. See the plugin's README page for installation instructions."]},{"l":"Web","p":["Scrape text from a web page by its URL. The HTML document is then processed through the Readability library to extract only usable text.","Some web servers may reject fetch requests, be protected by Cloudflare, or rely heavily on JavaScript to function. If you're facing issues with any particular site, download the page manually through the web browser and attach it using the file uploader."]},{"l":"YouTube","p":["Download a transcript of the YouTube video by its ID or URL, either uploaded by the creator or automatically generated by Google. Some videos may have the transcripts disabled, also parsing of age-restricted videos is unavailable as it requires login.","The script is loaded in the video's default language. Optionally, you can specify the two-letter language code to try and fetch the transcript in a specific language. This feature is not always available and may fail, so use it with caution."]},{"l":"Web Search","p":["This source requires to have a Web Search extension installed and properly configured. See the linked page for more details.","Perform a web search and download the text from the search result pages. This is similar to the Web source but fully automated. A chosen search engine will be inherited from the extension settings, so set it up in advance.","To begin, specify the search query, max number of links to be visited, and the output type: one combined file (formatted according to the extension rules) or an individual file for every single page. You can choose to save the page snippets as well."]},{"l":"Fandom","p":["This source requires to have a Server Plugin installed and loaded. See the plugin's README page for installation instructions.","Scrape articles from a Fandom wiki by its ID or URL. As some wikis are very large, it may be beneficial to limit the scope using the filter regular expression, it will be tested against the article's title. If no filter is provided, then all of the pages are subject to be exported. You may save them either as individual files for every page, or joint into a single document."]},{"i":"bronie-parser-extension-third-party","l":"Bronie Parser Extension (Third-Party)","p":["This source comes from a third-party and is not affiliated with the SillyTavern team. This source requires you to have Bronya Rand's Bronie Parser Extension installed as well as Server Plugins that require the parser to work.","Bronya Rand's Bronie Parser Extension allows the use of third-party scrapers, such as miHoYo/HoYoverse's HoYoLab into SillyTavern, similar to the other data sources.","Currently, Bronya Rand's Bronie Parser Extension supports the following:","miHoYo/HoYoverse's HoYoLab (for Genshin Impact/Honkai: Star Rail) via HoYoWiki-Scraper-TS","To begin, install Bronya Rand's Bronie Parser Extension by following it's installation guide and install a supported Server Plugin into SillyTavern. Restart SillyTavern and go to the Data Bank menu. Click + Add and you should see that your recently installed scrapers are added into the possible list of sources to obtain information from."]},{"l":"Vector Storage","p":["So, you've built yourself a nice and comprehensive library of information on your specific subject matter. What's next?","To use the documents for RAG, you need to use a compatible extension that will insert related data into the LLM prompt.","Vector Storage, which comes bundled with SillyTavern, is a reference implementation of such an extension. It uses embeddings (also known as vectors) to search for documents that relate to your ongoing chats.","Embeddings are arrays of numbers that abstractly represent a piece of text, produced by specialized language models. More similar texts have a shorter distance between their respective vectors.","Vector Storage extension uses the Vectra library to keep track of file embeddings. They are stored in JSON files in the /vectors folder of your user data directory. Every document is internally represented by its own index/collection file.","As the Vectors functionality is disabled by default, you need to open the extensions panel (\"Stacked Cubes\" icon on the top bar), then navigate to the \"Vector Storage\" section, and tick the \"Enabled for files\" checkbox under the \"File vectorization settings\".","By itself, Vector Storage does not produce any vectors, you need to use a compatible embedding provider."]},{"l":"Vector Providers"},{"l":"Local","p":["These sources are free and unlimited and use your CPU/GPU to calculate embeddings.","Local (Transformers) - runs on a Node server. SillyTavern will automatically download a compatible model in ONNX format from HuggingFace. Default model: jina-embeddings-v2-base-en.","Extras - runs under the Extras API using the SentenceTransformers loader. Default model: all-mpnet-base-v2.","Ollama - get it from https://ollama.com/. Set the API URL in the API connection menu (under Text Completion, default: http://localhost:11434). Must download a compatible model first, then set its name in the extension settings. Example model: mxbai-embed-large. Optionally, check an option to keep the model loaded in memory.","llama.cpp server - get it from ggerganov/llama.cpp and run the server executable with --embedding flag. Load compatible GGUF embedding models from HuggingFace, for example, nomic-ai/nomic-embed-text-v1.5-GGUF.","vLLM - get it from vllm-project/vllm. Set the API URL and API key in the API connection menu first."]},{"l":"API sources","p":["All these sources require an API key of the respective service and usually have a usage cost, but generally calculating embeddings is pretty cheap.","OpenAI","Cohere","Google MakerSuite","TogetherAI","MistralAI","NomicAI","Embeddings are only usable when they are retrieved using the same model that generated them. When changing an embedding model or source, it is recommended to purge and recalculate file vectors."]},{"l":"Vectorization Settings","p":["After you've selected your embedding provider, don't forget to configure other settings that will define the rules for processing and retrieving documents.","Splitting, vectorization, and retrieval of information from the attachments take some time. While the initial ingestion of the file may take a while, the RAG search queries are usually fast enough not to create a significant lag."]},{"l":"Message attachments","p":["These settings control the files that are attached directly to the messages.","The following rules apply:","Only messages that fit in the LLM context window can have their attachments retrieved.","When the vector storage extension is disabled, file attachments and their accompanying message are fully inserted into the prompt.","When file vectorization is enabled, then the file will be split into chunks and only the most relevant pieces will be inserted, saving the context space and allowing the model to stay focused.","Size threshold (KB) - sets a chunking splitting threshold. Only the files larger than the specified size will be split.","Chunk size (chars) - sets the target size of an individual chunk (in textual characters, not model tokens!).","Chunk overlap (%) - sets the percentage of a chunk size that will be shared between adjacent chunks. This allows for a smoother transition between the chunks, but may also introduce some redundancy.","Retrieve chunks - sets the maximum amount of the most relevant file chunks to be retrieved. They will be inserted in their original order."]},{"l":"Data Bank files","p":["These settings control how the Data Bank documents are handled.","The following rules apply:","When file vectorization is disabled, the Data Bank is not used.","Otherwise, all available documents from the current scope (see above) are considered for the query. Only the most relevant chunks across all the files are retrieved. Multiple chunks of the same file are inserted in their original order.","The inserted chunks will reserve a part of the context before fitting the chat messages.","Size threshold (KB) - sets a chunking splitting threshold. Only the files larger than the specified size will be split.","Chunk size (chars) - sets the target size of an individual chunk (in textual characters, not model tokens!).","Chunk overlap (%) - sets the percentage of a chunk size that will be shared between adjacent chunks. This allows for a smoother transition between the chunks, but may also introduce some redundancy.","Retrieve chunks - sets the maximum amount of the file chunks to be retrieved. This allowance is shared between all files.","Injection Template - defines how the retrieved information will be inserted into the prompt. You can use a special {{text}} macro to specify the position of the retrieved text, as well as any other macros.","Injection Position - sets where to insert the prompt injection. The same rules as for Author's Note and World Info apply."]},{"l":"Shared settings","p":["Query messages - how many of the latest chat messages will be used for querying document chunks.","Score threshold - adjust to allow culling the retrieval of chunks based on their relevance score (0 - no match at all, 1 - perfect match). Higher values allow for more accurate retrieval and prevent completely random information from entering the context. Sane values are in a range between 0.2 (more loose) and 0.5 (more focused).","Include in World Info Scanning - check if you want the injected content to activate lore book entries.","Vectorize All - forcibly ingests the embeddings for all unprocessed files.","Purge Vectors - clears the file embeddings, allowing to recalculate their vectors.","For \"Chat vectorization\" settings see Chat Vectorization."]},{"l":"Conclusion","p":["Congratulations! Your chatting experience is now enhanced with the power of RAG. Its capabilities are only limited by your imagination. As always, don't be afraid to experiment!"]}],[{"l":"Extensions","p":["SillyTavern comes with many extensions that can be enabled or disabled in the Extensions panel. Extensions can add new features, change the behaviour of existing features, or provide additional content for your AI to use. More extensions can be installed from the \"Download Extensions & Assets\" menu in the Extensions panel."]},{"l":"Extensions panel","p":["To open or close the Extensions panel, choose Extensions in the top bar.","Manage extensions: Activate, deactivate, and update extensions","Download Extensions & Assets: Install more extensions, characters, sounds, and backgrounds from the SillyTavern repository","Notify on extension updates: Check to be notified when there are updates available for installed extensions","Install extension: Import an extension from a Git repository URL","Using third-party extensions can have unintended side effects and may pose security risks. Always make sure you trust the source before importing an extension via Install extension. We are not responsible for any damage caused by third-party extensions."]},{"l":"Built-in extensions","p":["Auto-summary of the chat history","Chat Translation","Chat Vectorization","Converts text into tokens and counts the number of tokens","Expression Images","Finds relevant messages from chat history and adds them into the context","Generates text from images so your AI can \"see\" and respond to visual content in your conversations","Image Captioning","Image Generation","Images (aka 'sprites') of your AI character, shown next to or behind the chat window","Quick Reply","Reply to chat messages with a single click, run commands and STscripts, and more","Summarize","Text To Speech","These extensions are built into SillyTavern and do not need to be installed. They can be enabled or disabled in the Extensions panel.","Token Counter","Translate chat messages to a different language","Use local or cloud-based Stable Diffusion, FLUX or DALL-E APIs to generate images","Voice narration for your chat messages via ElevenLabs, Silero, your system TTS, AllTalk, XTTS, and more"]},{"l":"Installable extensions","p":["A set of 7 classic D&D dice for all your dice rolling needs.","AccuWeather","Adds \"idle prompting\" after the user has been idle for some time to organically continue the conversation.","Adds a button to quickly insert a /sendas command template for the selected group member.","Adds a button to quickly insert emojis into a chat message.","Adds a dropdown menu for selecting user personas from the chat bar.","Adds a place to store your notes. Supports rich text formatting.","Adds a silence audio player to the extensions menu. Can help if the browser tab is being killed in a background.","Adds a timeline navigation to the chat history.","Adds a top bar to the chat window with shortcuts to quick actions.","Adds ability to randomize API settings sliders with every generation.","Adds an ability to cluster characters by similarity groups to easily find duplicates.","Adds an option to inspect and edit output prompts before sending them to the server.","Adds immersive background music and ambient sounds to your chats.","Adds Mermaid diagrams & flowcharts rendering to SillyTavern chats.","Adds Realtime Voice Cloning capabilities to the Text-to-Speech module.","Adds support for live2d models. Customizable expressions, animations and interactions.","Adds support for VRM models. Customizable expressions, animations and interactions.","Adds web search results to LLM prompts.","Allows running JavaScript and STscript code from code blocks in chat.","Allows setting alternate greetings that are specific to group chats.","Allows to receive push notifications for incoming chat messages.","Animate the text of character messages with variable speed and play sound along the animation.","Blip","Chat Top Bar","Chess","Code Runner","Convert your speech to text using browser or extras.","D&D Dice","Duplicate Finder","Dynamic Audio","Easy way to view and modify variables.","Emoji Picker","EmulatorJS","Enhances the current visual novel experience with more features (Focus Mode, Letterbox Mode, and more)!","Gets the latest news from RSS feeds as a slash command or a function tool.","Group Greetings","Group SendAs","HypeBot","Idle","Image Metadata Viewer","Install any of these extensions from the \"Download Extensions & Assets\" menu in Extensions.","LaTeX","Live2d","Mermaid","Notebook","Objective","Parameter Randomizer","Play retro console games directly in SillyTavern chats.","Play the game of chess with the LLM.","Prome Visual Novel Extension","Prompt Inspector","Provides an interface for extensions to use language models directly in the browser.","Provides the screen image for multimodal models when you send a message.","Provides weather information using the AccuWeather API as a slash command or a function tool.","Push Notifications","Quick Persona","Render LaTeX and AsciiMath formulas in chat messages.","RSS","RVC","Screen Share","Set an Objective for the AI to aim for during the chat.","Show personalized suggestions based on your recent chats using the NovelAI's HypeBot engine. Requires an active NovelAI subscription.","Silence Player","Speech Recognition","The Extras project was discontinued in April 2024. You do not need to install Extras to use extensions.","Timelines","Variable Viewer","View metadata of enlarged images attached to a chat.","VRM","Web Search","WebLLM"]}],[{"l":"Blip","p":["This guide will walk you through setting up and customizing blip extension for your SillyTavern experience. This extension animate the text of messages with variable speed and play sound along the animation. You can use audio file or generate the sound."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Blip\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"l":"Blip global settings","p":["Blip user message:","Enable checkbox to play animation on user message.","Set a profile for the user or a default profile if you want blip animation for user.","Blip only for certain text:","Enable checkbox to only blip for text inside quotes.","Enable checkbox to ignore everything inside asterisks.","Automatic scroll down:","Enable checkbox to make the chat go down to follow the text animation, disable it if you wanna scroll freely during animation.","Audio volume","Mute the audio if just the animation of the text is desired.","You can adjust the global volume of blip audio."]},{"i":"character-animationvoice-profile","l":"Character animation/voice profile","p":["Any profile can be deleted using the remove button.","Audio parameters:","Blip origin: file:","Blip origin: Generated sound:","Choose a file in the list.","Enable the checkbox to force to wait entire file is played before playing again if needed.","If it does not have a profile yet the current parameters will become his profile settings.","If min/max are different a random sound in this range is played each time.","If only the current chat characters are shown in the list, click the checkbox to show all your characters.","including the user and an optional default profile that will be used when character have no profile.","Or put file directly into: \\SillyTavern\\data\\user-handle\\assets\\blip.","Select a character, if he have a profile it will be loaded.","Select the character to assign/update profile:","Set a volume multiplier that will only affect this voice profile if needed.","Set audio speed: the delay between each blip sound, independant of text speed.","Set comma/phrase delay superior to 0 to add a pause when special character are printed, can add more liveliness to animation. Audio is paused too in this case.","Set Min/max speed multiplier different to 1.0 for randomness of speed animation.","Set the text speed: the delay in milliseconds between each letter printed.","Text animation settings:","Thank you for following this guide! Your SillyTavern experience is now enriched with text animation and blip voices.","Use refresh button if your character does not appear in the list.","Use the min/max frequency slider to customize the blip sound played.","You can get official ST blip assets from the assets extension menu.","You can save a profile for each character:"]}],[{"l":"Chat Translation"},{"l":"Overview","p":["The Chat Translation Extension enables real-time translation of chat messages between different languages using various translation providers. It supports both manual and automatic translation modes.","Character message translated from English to Chinese using 'Translate Message/翻譯訊息' message action button","\"Translate Chat\", \"Translate Input\"","\"翻译聊天\", \"翻译输入\"","\"翻譯聊天內容\", \"翻譯輸入內容\"","\"채팅 번역하기\", \"입력 번역하기\"","\"Перевести чат\", \"Перевести моё сообщение\""]},{"l":"Usage","p":["All the ways to translate chat messages:","Translate Chat button in the Extensions menu","Translates the entire chat history at once","Translate Input button in the Extensions menu","Translates just the current input text","Useful before sending a message","Translate Message icon in the Message Actions toolbar of any message","Click to translate just that message","Click again to revert to original text","Auto-mode configuration in the Chat Translation drawer of the Extensions panel","Automatically translates user inputs, AI responses, or both","/translate slash command","Use /translate [target=language_code] text to translate text"]},{"l":"Configuration","p":["Configuration options are available in the Chat Translation drawer of the Extensions panel."]},{"l":"Provider","p":["Choose your preferred translation service","Click the API Key icon, if it appears, to enter an API key","Click the Custom URL icon, if it appears, to enter a custom API URL"]},{"l":"Target Language","p":["Select the language you want to write your messages in, or read AI responses in."]},{"l":"Auto-mode","p":["Configure automatic translation behavior.","None: No automatic translation","Translate responses: Automatically translates AI responses into the target language","Translate inputs: Automatically translates user inputs into English","Translate both: Translates both user inputs and AI responses"]},{"l":"Clear Translations","p":["The Clear Translations button removes all translations from messages in the current chat. The original messages are preserved."]},{"i":"configuration-example-chinese-to-english-chatting","l":"Configuration Example: Chinese to English Chatting","p":["To set up a workflow where a Chinese-speaking user can chat in Chinese with an AI that operates in English:","Set Auto-mode to \"Translate both\"","Set Target Language to \"Chinese (Simplified)\" or \"Chinese (Traditional)\"","Choose a translation provider with good language auto-detection (e.g., Google or DeepL)","This setup will:","Translate user's Chinese input to English for the AI","Translate AI's English responses back to Chinese for the user","This setup relies on automatic language detection for input. For more precise control, future updates may include explicit source language selection."]},{"l":"Translation providers","p":["Alternative front-end for Google Translate, open source (AGPL-3.0), privacy-focused","Bing Translator","Cloud-based Local, custom URL Requires API key","DeepL","DeepLX","Features","Good for Russian and Eastern European languages","Google Translate","High-quality translations, especially for European languages","Libre Translate","Lingva Translate","Location","Microsoft's translation service, integrates with Azure services","OneRing Translator","Provider","Self-hosted (AGPL-3.0) alternative to proprietary translation services, with cloud-hosted Pro tier","Self-hosted DeepL proxy, open source (MIT), free but proxying DeepL Pro requires DeepL API key","Self-hosted front-end to Google Translate and other providers, privacy-focused, open source (AGPL-3.0)","Widely used, supports many languages, good accuracy","Yandex Translate"]},{"l":"DeepL-specific configuration","p":["Formality levels available for German, French, Italian, Spanish, Dutch, Japanese, and Russian","Configure via deepl.formality in config.yaml"]},{"l":"Slash Commands","p":["Use /translate command for quick translations. Syntax: /translate [target=language_code] text. If target language is not provided, the value from the extension settings will be used."]},{"l":"Basic usage","p":["Translate text to the current target language and show it in a popup:","Popup in Chinese (Simplified), '欢迎来到酒馆/Welcome to the Tavern'","Translate text to Spanish and add it to the chat:","User message in Spanish, 'Hola Mundo/Hello world'"]},{"i":"testing-pipeline-translation-localization","l":"Testing, pipeline translation, localization","p":["Prompt the user for a message and a language, translate the message into that language, then re-translate it into the configured target language and show both translations in a popup. This example uses the /input and /buttons commands to gather user input:","This is useful for checking the quality of a translation into a language that you don't speak, before writing it somewhere important.","Popup, 'Welcome to the Tavern/欢迎来到酒馆/welcome to the pub', en, zh-CN, en Popup, 'My hovercraft is full of eels/我的氣墊船裡裝滿了鰻魚/My hovercraft is filled with eels', en, zh-TW, en","The UI controls are shown in the current locale, independent of the configured target language.","/input","/buttons","Input dialog, '发送测试消息/Send Test Message'","Buttons dialog, '语言/Language'","Popup, '我的氣墊船裡裝滿了鰻魚/My hovercraft is full of eels', zh-TW -> en -> zh-TW","Input language detection is relatively effective in the following examples:","Popup, '(My hovercraft is full of eels)/A légpárnás hajóm tele van angolnával/我的氣墊船裡裝滿了鰻魚', zh-TW -> hu -> zh-TW Popup, '我的氣墊船裡裝滿了鰻魚/Mi aerodeslizador está lleno de anguilas/My hovercraft is full of eels', zh-TW -> es -> en Popup, 'Il mio hovercraft è pieno di anguille/我的气垫船里装满了鳗鱼/My hovercraft is filled with eels', it -> zh-CN -> en"]},{"l":"Technical Notes","p":["UTF-8 encoding, special characters, and emojis are supported","Handles large messages by splitting into chunks when needed","Preserves formatting and embedded images in messages","Caches translations to avoid redundant API calls"]},{"l":"AI input language","p":["internal_language controls the language into which user messages are auto-translated before being sent to the AI. It is hardcoded to 'en' in the default settings and cannot be changed through the UI. Thus, the translation target language for messages to the AI is always English. Previous testing showed that AI performance was better when receiving English messages, but this may change as more LLMs are being trained on more varied language data. I suppose one could change internal_language in settings.json and find out."]},{"l":"Chinese variant handling","p":["The extension supports both Simplified and Traditional Chinese, but not all translation providers do. The UI presents these as 'Chinese (Simplified)' and 'Chinese (Traditional)' respectively, with language codes 'zh-CN' and 'zh-TW'. They are mapped to the following language codes for translation providers:","Libre Translate: 'zh-CN' to 'zh' and 'zh-TW' to 'zt'.","DeepL and DeepLX: both variants to 'ZH'.","Bing: 'zh-CN' to 'zh-Hans', 'zh-TW' as-is.","Other providers use 'zh-CN' and 'zh-TW' as provided."]},{"l":"Text length limits","p":["Some providers have character limits per request:","Yandex: 5000 characters","DeepLX: 1500 characters","Bing: 1000 characters","Google: 5000 characters","Longer texts are automatically split into chunks for translation."]}],[{"l":"Chat Vectorization","p":["The use of this extension does not guarantee a better chatting experience or improved memory of any sort. Only use if you understand all the implications of vector database utilization.","Chat vectorization searches for messages in your current chat history that seem relevant to your most recent messages. It temporarily shuffles the most relevant messages to the beginning or end of the chat history. This happens when the model's reply to your last message is generated.","The messages at the start and end of the chat history tend to have the greatest impact on the model's reply. Therefore, shuffling relevant messages to these locations can help the model focus on relevant information in its reply.","In particular, chat vectorization can find relevant messages that are too far back in the message history to fit into the request context. Shuffling these messages into context provides the model with information that it would not have otherwise.","Chat vectorization is a kind of retrieval-augmented generation (RAG). Retrieval-augmented generation increases the quality of responses generated by a model, by providing additional relevant information in the prompt.","Retrieval: the most recent messages are used to retrieve relevant past messages","Augmented: the model's context is augmented by inserting past messages in a useful way","Generation: the model is instructed to use the past messages when generating the response","A vector is a set of numbers that could represent the themes, content, style, or other characteristics of a piece of text.","Vectorization is calculating the vector that represents a piece of text. This is done by a vectorizing model. Just as text generation models make text from text, vectorizing models make vectors from text.","Vector search finds relevant results by comparing vectors rather than, say, keywords. If we calculate the vector for a search query, we can compare it to the stored vectors for a collection of pieces of text. This finds the texts in our collection that are most similar to the text in the search query. In the case of chat vectorization, the\"search query\" is the most recent 2 messages, and the \"texts in our collection\" are all the other messages in the chat."]},{"l":"Setting up","p":["To enable Chat vectorization, select \"Extensions\" > \"Vector Storage\" > \"Enabled for chat messages\".","Configure a vectorization source and vectorization model. Chat vectorization uses the same vector source as Data Bank, so you may have set this up already. The settings for the Vectorization Source and Vectorization Model are documented in Data Bank.","Chat vectorization uses the same vector storage as Data Bank, but this does not need to be set up or configured. There is also information about Vector Storage in Data Bank.","Chat vectorization does not use Data Bank to store the chat messages. The messages are stored in the chat."]},{"i":"preparing-chat-messages-for-search-vector-storage","l":"Preparing chat messages for search (vector storage)","p":["So that chat messages can be searched, a vector is calculated for each message and stored.","Vectorizing occurs in the background, whenever you send or receive a message.","Each message is stored individually, so that it can be found and shuffled individually during generation.","Large messages are split into \"chunks\" so that the model can be given the most relevant part of a long message. The chunk size is 400 characters. You can change this with \"Chunk size (chars)\".","Messages are divided into chunks by finding a chunk boundary such as a paragraph break, line break, or space between words. This is so that the all the chunks make sense, as far as possible. If your chat messages have some other way to mark natural splitting points, such as ----, you can add this to \"Chunk boundary\". The setting for \"Chunk boundary\" is shared with Data Bank."]},{"l":"Vector storage controls","p":["To calculate vectors for all messages in the current chat, without waiting for them to be processed in the background, choose \"Vectorize All\" from the settings.","To see how many messages in the current chat have been vectorized, choose \"View Stats\". This displays the total number of vectors stored. It also indicates the specific chat messages that have been vectorized, by marking them with a green ball.","To remove all the vectors for messages in the current chat, choose \"Purge Vectors\".","The controls for \"Vectorize All\" and \"Purge Vectors\" within Chat vectorization only affect the stored vectors for the current chat. However, there are identical buttons in File vectorization that affect the vectors for files in Data Bank. Ensure that you are purging the vectors that you intend to purge."]},{"i":"finding-relevant-messages-to-shuffle-vector-retrieval","l":"Finding relevant messages to shuffle (vector retrieval)","p":["To find the most relevant messages in the chat history, the most recent messages are converted (vectorized) into a query vector. By default, the 2 most recent messages are used. To change this, change the value of \"Query messages\". This value is also used when finding relevant content from Data Bank.","Past messages must have a relevance score of at least 25% to be included. You can change this with \"Score threshold\". The setting for score threshold is shared with Data Bank.","The 3 most relevant messages from chat history are shuffled. You can change this with \"Insert#\".","To avoid disturbing the most recent events in the chat, the 5 most recent messages are not shuffled. To change this, change the value of \"Retain#\"."]},{"i":"shuffling-messages-augmented-generation","l":"Shuffling messages (augmented generation)","p":["The messages are shuffled to one of 3 places:","The top of the chat, after the Main Prompt / Story String (the default)","The top of the chat and before the Main Prompt / Story String","The end of the chat, before the last 2 messages (\"In-chat @ Depth 2\"). Since you just sent a message, this position is usually just before the previous reply from the model.","You can change this with \"Injection Position\" and \"Depth\".","The messages are included in order of relevance, with more relevant messages shown after less relevant messages.","The name of the person or character who sent each message is included.","The messages are shown to the model as \"past events\". This assists the model to understand that the messages contain information from a different point in the chat history than the point at which they are inserted. You can change this with \"Injection Template\".","You can see the final prompt to the model using the Prompt Itemization popup, the terminal logs, or the browser console logs. The browser console logs are useful for understanding what all the steps in Chat vectorization are doing."]},{"l":"Vector summarization","p":["The Vector summarization feature is experimental.","Vector summarization does not create summaries of your chat. It does not turn the retrieved messages into summaries. It does not make your chat history shorter. It is not \"like Summarize but better\".","Vector summarization is intended to make vector search of chat messages more effective. It does this by introducing a summarizing step prior to vectorizing. The summarizing step extracts the most important parts of the message, so that the resulting vector is a better indicator of what the message relates to.","Vector summarization may make vector search less effective.","To summarize the messages in the chat history, and generate a vector for each summarized message, choose \"Summarize chat messages for vector generation\".","The summarized message does not replace the original message in chat. If a vector search matches the vector of a summarized message, the original message is retrieved from chat history and shuffled into context. The summarized versions of the messages are retained in Vector Storage, which may be of interest for debugging.","To summarize the content of the messages used to search the chat history (the last 2 messages by default), choose \"Summarize chat messages when sending\".","Each time a message is summarized for vectorising, a separate request is made to the summarizing model. You can choose which summarizing source is used with \"Summarize with\". Choosing \"Main API\" will generate the summaries using the same model and connection settings that you use for generating chat or text completions.","The request consists of the raw message content and an instruction about how the model should produce the summary. You can change the instruction with \"Summary Prompt\"."]}],[{"l":"Dynamic Audio","p":["This guide will walk you through setting up and customizing dynamic audio assets for your SillyTavern experience."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Dynamic Audio\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"i":"dynamic-audio-setup-browser","l":"Dynamic Audio Setup (Browser)","p":["Connect to the Assets Repository:","Launch SillyTavern and navigate to Extensions> Assets.","Click on the \"Connect\" button to establish a connection to the official assets repository.","Download the desired audio assets, such as background music (BGM) or ambient sounds, that correspond to the backgrounds you intend to use.","Enable Dynamic Audio Extension:","In SillyTavern, go to Extensions> Dynamic Audio.","Enable the extension, unmute and adjust the volume of BGM and ambient sounds to your preference.","When bgm end another one will play randomly, click on loop button to keep current bgm playing","Click on roll button to pick another bgm randomly","Expression based BGM:","Enable expression BGM switch if you want bgm to follow character expression (require bgm in character folder see below).","Adjust the cooldown timer (in seconds) between BGM updates. Increase it if you find the BGM changes too frequently in group chats or when using character-specific BGM with emotion detection."]},{"l":"Importing Music for Characters","p":["To set up custom music for your characters' emotions, follow these steps:","Navigate to Character Folder:","Go to the characters folder, e.g., \\SillyTavern\\data\\user-handle\\characters\\Seraphina.","Create BGM Folder:","Inside the character folder, create a subfolder named bgm.","Import Emotion Music:","Within the bgm folder, import the music files for each emotion. Supported audio extensions include .mp3, .ogg, and .wav.","Naming convention: [emotion]_[number].mp3, e.g., anger_0.mp3, joy_0.mp3.","Multiple Tracks for Emotions:","You can import multiple tracks for the same emotion by incrementing the number, e.g., neutral_1.mp3, neutral_2.mp3.","Default Music Selection:","When no emotion is detected, a random neutral track will play as the default. Emotions are detected similarly to updating sprites; refer to the expression images documentation for details."]},{"l":"Changing Default BGM Music","p":["If a character doesn't have custom BGM in their folder, a default track will play. Here's how you can change it:","Navigate to BGM Folder:","Go to the following folder: \\SillyTavern\\data\\user-handle\\assets\\bgm.","Replace/Add Music:","Replace or add music files (.mp3, .ogg, .wav) to this folder.","These are the official audio assets downloaded using the assets extension.","One of these tracks will play randomly when no character-specific BGM is found (solo or group chat)."]},{"l":"Changing Ambient Sounds","p":["Ambient sounds add depth to your scenes. Here's how you can customize them:","Navigate to Ambient Folder:","Go to the following folder: \\SillyTavern\\data\\user-handle\\assets\\ambient.","File Naming Convention:","Ambient audio filenames correspond to background image filenames, replacing spaces with dashes.","Example: bedroom-clean.mp3 corresponds to the \"bedroom clean.jpg\" background.","If the lock button is unlock the audio file corresponding to the background will play. Activating lock will keep current ambient playing.","Custom Ambients:","You can add your own ambient sounds for custom or existing backgrounds by following the same naming pattern.","Thank you for following this guide! Your SillyTavern experience is now enriched with dynamic audio."]}],[{"l":"EmulatorJS","p":["This extension allows you to play retro console games right from the SillyTavern chat."]},{"l":"Installation","p":["Prerequisites:","Latest release version of SillyTavern.","ROM files downloaded from the net. You can find them anywhere.","How to install:","Install using SillyTavern's extensions downloader.","Or use this link: https://github.com/SillyTavern/SillyTavern-EmulatorJS"]},{"l":"Usage","p":["Open the \"EmulatorJS\" extension menu.","Click \"Add ROM file\". ROMs are saved to your browser storage and not stored on a server.","Select the game file to add. Input the name and core (if it wasn't auto-detected). If the core requires a BIOS file, add it too.","Click the \"Play\" button in the list or launch via the wand menu.","You can customize controls and other settings in the emulator frame after launching the game.","Use save/load state functions if you need to take a break.","Check the EmulatorJS docs to see the list of available cores and their requirements: Systems."]},{"l":"Comments mode","p":["With the power of multimodal models such as GPT-4 Vision, your AI bots can see your gameplay and provide witty in-character comments."]},{"l":"Requirements","p":["A browser that supports ImageCapture. Tested on desktop Chrome. Firefox requires to enable it with config. Safari won't work.","Chat Completion API with image inlining mode is recommended. Requires OpenAI or OpenRouter API key with \"gpt-4-turbo\" or \"gpt-4o\" as the selected model; Google AI Studio with Gemini 1.5 Pro or Gemini 1.5 Flash model; Anthropic Claude (Opus 3 or Sonnet 3.5 models recommended). Check the API documentation of the chosen to see if the chosen model supports multimodal prompts.","If image inlining is disabled, make sure that the \"Image Captioning\" extension is enabled, then select the \"Multimodal\" captioning source:","OpenAI, Claude, MistralAI, Google AI Studio with access with any vision-supported model.","OpenRouter API with a compatible multimodal model.","Locally hosted Llava model in Ollama, KoboldCpp, oobabooga TextGen WebUI or vLLM."]},{"l":"How to enable comments","p":["Make sure you set the interval of providing comments in the EmulatorJS extension settings. This setting defines how often the character is queried for comments using a snap of your current gameplay. A value of 0 indicates that no comments are provided.","Select a character chat and launch the game. For the best performance, make sure that the ROM file is properly named so that AI can have more background context.","Start playing as you normally would. The vision model will be queried periodically to write a comment based on the latest screenshot it \"sees\"."]},{"l":"Settings","p":["Caption template - a prompt used to describe the in-game screenshot. {{game}} and {{core}} additional macro are supported.","Comment template - a prompt used to write a comment based on the generated caption. {{game}}, {{core}}, {{caption}} additional macro are supported. For image inlining mode, {{caption}} is replaced with see included image.","Force captions - will force the use of multimodal captioning even if image inlining is supported and enabled."]},{"i":"why-im-not-seeing-any-comments","l":"Why I'm not seeing any comments?","p":["Comments are temporarily paused (interval step skipped) if:","Emulator is paused (with a pause button, not in-game).","The browser window is out of focus.","The user input area is not empty. This is to let you type your reply in peace.","Another reply generation is currently in progress.","TTS voice is being read aloud. Comment is held off (20 seconds maximum) until it finishes, but not skipped.","Other common issues:","Make sure you've set a commenting interval before launching the game.","Make sure you have set a multimodal API key and there are no errors in the ST server console.","Still doesn't work? Send us your browser debug console logs (press F12)."]},{"l":"Credits","p":["EmulatorJS engine (GPLv3): https://github.com/EmulatorJS/EmulatorJS"]}],[{"l":"Expression Images"},{"i":"what-is-it","l":"What is it?","p":["Expression images are images (aka 'sprites') of your AI character which are shown next to (or behind) the chat window.","Expression images can use a classification model running alongside SillyTavern's main application. This allows the Expressions to change automatically based on the sentiment expressed in the AI's most recent chat response."]},{"i":"setup-instructions-offline-mode-without-extras","l":"Setup Instructions (Offline Mode without Extras)","p":["Open the Extensions Panel and expand the 'Expression images' section. If you have the character chat open, you will see a grid of image placeholders. Expression Drawer","Click the 'import' button at the top left of each image in the grid, and select the image you want to apply to that emotion. This will save the image with the correct filename inside the /data/user-handle/characters/(character_name_here)/ folder.","To show the image in your SillyTavern window, click the image in the grid after it has been uploaded."]},{"i":"how-does-the-classify-module-work","l":"How does the classify module work?","p":["The classify module uses a small 'sentiment parsing' model that runs on the SillyTavern host machine (eg. on your PC, or the colab machine). This model takes the new output from the AI and detects what kind of sentiment, or emotion, the text is expressing. While multiple sentiments may be expressed in a single message, the model only picks the most likely one and returns that to the SillyTavern. The frontend plugin then displays the image that is associated with that sentiment."]},{"l":"Change Expressions Manually","p":["Click on any of the uploaded expression images (sprites) to display them near the chat interface (with default UI mode) or at the center of the screen (in Visual Novel mode).","Use the /emote (name) slash command or matching Quick Reply to set the sprite without opening the extensions menu."]},{"i":"setup-instructions-local-classification","l":"Setup Instructions (local classification)","p":["Make sure you're on the latest version of SillyTavern.","Open the extensions panel and expand the \"Character Expressions\" plugin menu.","Select \"Local\" in the classification source dropdown.","This will start a one-time download of the classification model from HuggingFace Hub (about ~ 100 Mb).","Generate any message to verify that the classification works and the sprite appears. You may also check the server console for debug logs."]},{"i":"setup-instructions-with-extras","l":"Setup Instructions (with Extras)","p":["Have Extras installed and running with the classify module enabled: python server.py --enable-modules=classify","Import the expression images the same way as mentioned above.","Select \"Extras\" in the classification source dropdown.","The appropriate expression image will display automatically whenever the AI sends you a response."]},{"i":"setup-instructions-with-llm","l":"Setup Instructions (with LLM)","p":["Connect to any of the supported and properly configured Text Generation APIs.","Import the expression images the same way as mentioned above.","Select \"LLM\" in the classification source dropdown.","Optionally, configure the classification instruction prompt.","Generate any message to verify that the classification works and the sprite appears. You may also check the server console for debug logs."]},{"i":"how-do-i-get-more-expression-options","l":"How do I get more expression options?"},{"l":"Local","p":["Local classification defaults to 28 possible image labels: Cohee/distilbert-base-uncased-go-emotions-onnx","To use the 6-option classification model, open the config.yaml file with a text editor and change the value of the classificationModel variable to Cohee/bert-base-uncased-emotion-onnx","After that, restart the ST server to redownload the model. To revert it, change the value in config.yaml again."]},{"l":"Extras API","p":["Extras API uses a classification model with 6 options by default: nateraw/bert-base-uncased-emotion","There is also a model with 28 options: joeddav/distilbert-base-uncased-go-emotions-student","To use this model you need to change your Extras command line to include the following argument (with a space before and after):","--classification-model=joeddav/distilbert-base-uncased-go-emotions-student"]},{"i":"what-image-formats-are-supported-for-expressions","l":"What image formats are supported for Expressions?","p":["Any image format is allowed, including webp and animated gifs.","The most common format is a PNG file with a transparent background."]},{"i":"using-the-default-expressions","l":"Using the 'default expressions'","p":["This feature will only activate if local classification is enabled or with Extras API connected. There is no way to manually display default expression images.","Use Default Expressions","If you don't have custom expression images for a character, you can use the built-in default expressions which are included with the base SillyTavern installation. These are simple emoji-style images. Just click the checkbox at the top of the Expression images section inside the Extension panel. Default expressions will work alongside any available custom Expressions, and will display in cases when your custom image set has any missing images for a particular emotion."]},{"l":"Importing an Expression images zip file","p":["Using the 'import ZIP' button, you can import a zip file that contains a collection of expression images, and those images will automatically be added to the correct folder for your currently selected character. The zip file must have a flat internal structure (no subfolders) and the individual images should be named correctly. Importing a zip will not automatically rename any images to make them match the emotions."]},{"l":"Limitations"},{"i":"display-names-not-character-card-filenames-dictate-which-image-set-is-used","l":"Display names (not character card filenames) dictate which image set is used","p":["If you have more than one character with the same display name, they will both use the same set of expression images.","If you want a different image set to be used for each version of the same-named character, you can use the sprites folder override."]},{"l":"How to set an override","p":["Create a folder in the /data/user-handle/characters with any name and put images there, e.g. /data/user-handle/characters/Boris.","Open the chat with the character whose sprites you'd like to override.","Enter the name of the override folder into the \"Sprite Folder Override\" input and click \"Submit\".","The Sprites list will reload and the \"Sprite set\" indicator should show the override folder.","Alternatively, you can use the /costume slash command to achieve the same result: /costume Boris.","By prepending a backslash to the override folder name, it will resolve to a subfolder in the current character sprites folder, e.g. /costume \\tracksuit for the character named Boris will resolve to the /data/user-handle/characters/Boris/tracksuit folder."]},{"l":"Custom expressions","p":["You can add your custom expression labels to the list and upload sprites for them.","However, they won't be labeled automatically by the classification model. You need to set them manually (either by clicking or the /emote command)."]}],[{"l":"Image Captioning","p":["Image Captioning allows SillyTavern to automatically generate text descriptions for images used in chats.","Use Image Captioning when you want your AI character to \"see\" and respond to visual content in your conversations.","Create captions for images you upload or paste into messages","Add context to existing images in the chat history","Use various sources for generation, including local models, cloud APIs, and crowdsourced networks","There are options that require no setup, no money, and no GPU. There are also options that require some or all of those things. Choose the one that fits your needs and resources.","The image captioning extension is built-in to SillyTavern and does not need to be installed separately."]},{"l":"Quick start","p":["Set up:","Open the Image Captioning panel in the Extensions panel","Choose a captioning source (most likely \"Local\" or \"Multimodal\")","For \"Multimodal\" ensure you've set up the connection in the API Connections tab","Generate a caption:","Choose \" Generate Caption\" from the Extensions popup menu","Select an image file when prompted","Wait for the caption to be generated","Review and send:","The captioned image will be inserted into your message","See the caption using the image tooltip","Click Send to see what your character thinks of the image!"]},{"l":"Panel controls"},{"l":"Source Selection","p":["Choose the source for image captioning. Supported options:","Source","Description","Multimodal","Cloud: OpenAI, Anthropic, Google, MistralAI, and others. Local: Ollama, llama.cpp, KoboldCpp, Text Generation WebUI, and vLLM. Supports custom prompts so you can ask your images questions.","Local","Uses transformers.js running locally inside your SillyTavern server. Zero setup!","Horde","Uses the AI Horde network, a crowdsourced distributed network of image generation models. Nothing to download, configure, or pay for. Variable response times.","Extras","The Extras project was discontinued in April 2024 and is not maintained or supported."]},{"l":"Caption Configuration","p":["Caption Prompt: Enter a custom prompt for captioning. The default prompt is \"What's in this image?\"","Ask every time: Toggle to request a custom prompt for each image caption"]},{"l":"Message Template","p":["Message Template: Customize the caption message template. Use {{caption}} macro to insert the generated caption. The default template is [{{user}} sends {{char}} a picture that contains: {{caption}}]"]},{"l":"Auto-captioning","p":["Automatically caption images: Toggle to enable automatic captioning of images pasted or attached to messages","Edit captions before saving: Toggle to allow editing captions before they are saved"]},{"l":"Captioning images","p":["All the ways to caption images in SillyTavern:","Choose \" Generate Caption\" from the Extensions popup menu and select an image file when prompted","Click the Caption icon at the top of an image already in a message","Paste an image directly into the chat input with auto-captioning enabled","Attach an image file to a message using the Embed File or Image button in the actions of a message.","Send a message with an embedded image","Use the /caption slash command"]},{"i":"auto-captioning-1","l":"Auto-Captioning","p":["The auto-captioning feature allows you to automatically generate captions for images as they are added to the chat, without manually triggering the captioning process each time.","To enable, select the \"Automatically caption images\" checkbox in the Image Captioning panel. You can also choose to edit captions before they are saved by checking the \"Edit captions before saving\" box.","Once enabled, auto-captioning will trigger in the following scenarios:","When an image is pasted directly into the chat input.","When an image file is attached to a message.","When a message with an embedded image is sent.","The system will use your selected captioning source (Local, Extras, Horde, or Multimodal) and the configured settings to generate a caption for the image."]},{"i":"editing-captions-before-saving-refine-mode","l":"Editing captions before saving (Refine Mode)","p":["If you've enabled the \"Edit captions before saving\" option:","After an image is added, a popup will appear with the generated caption.","You can review and edit the caption as needed.","Click \"OK\" to apply the caption, or \"Cancel\" to discard the caption without saving."]},{"l":"Caption sending","p":["The generated (and optionally edited) caption will be automatically inserted into the prompt using the Message Template you've configured. By default, it will be sent in this format:"]},{"i":"slash-command-caption","l":"Slash Command: /caption","p":["The extension provides a /caption slash command to use in the chatbox or in scripts."]},{"l":"Usage","p":["prompt(optional): A custom prompt for the captioning model. Only supported by multimodal sources.","quiet=true|false: If set to true, suppresses sending a captioned message to the chat. Default is false.","mesId=number: Specifies a message ID to caption an image from an existing message instead of uploading a new one.","If no mesId is provided, the command will prompt you to upload an image. When quiet is false (default), a new message with the captioned image will be sent to the chat. The generated caption can be used as input for other commands."]},{"l":"Examples","p":["Caption a new image with the default settings:","Caption a new image with a custom prompt:","Caption an image from message #5 without sending a new message:","Caption an image from message #10 with a custom prompt then generate a new image based on the caption:"]},{"l":"Local source","p":["You can change the model in config.yaml. The key is called extras.captioningModel because reasons. Enter the Hugging Face model ID you want to use. The default is Xenova/vit-gpt2-image-captioning.","You can use any model that supports image captioning ( VisionEncoderDecoderModel or \"image-to-text\" pipeline). The model needs be to compatible with the transformers.js library. That is, it needs ONNX weights. Look for models with the ONNX and image-to-text tags, or that have a folder called onnx full of .onnx files."]},{"l":"Multimodal source"},{"l":"General configuration","p":["Model: Choose the model for image captioning. Options vary based on the selected API.","Allow reverse proxy: Toggle to allow using a reverse proxy if defined and valid (OpenAI, Anthropic, Google, Mistral)","API keys and endpoint URLs for captioning sources are managed in the API Connections panel. Set the connection up in API Connections first, then select it as your captions source in Captioning.","One last time: configure the API key/address/port in API Connections and use the connection in Captioning.","You can still use Claude for chats and Google AI Studio for image captioning, or whatever. Just set them both up in the 'API Connections' tab first. Then flip your Chat Completion source to Claude and your Captioning source to Google AI Studio.","For most local backends, you will need to set some options in the model backend rather than in SillyTavern. If your backend can only run one model at a time and doesn't support automatic switching, you are unfortunately going to have a hard time using the same backend for chat and captioning with different models.","Even if you run two instances of the backend on different ports, API Connections only allows one active configuration per backend type. But what if I told you... that you can probably connect to your backend in both Text Completion and Chat Completion modes? Now you can have two connections to the same backend type."]},{"l":"Sources","p":["\"I don't want to pay anything or run anything\": Google AI Studio free tier","\"I want the best captioning possible, and I don't mind paying for it\": Anthropic","\"I want to caption images locally and have it just work\": Ollama","\"I want to complain when it doesn't work\": Extras","\"I want to keep the dream of local AI alive\": KoboldCpp","01.AI (Yi)","Anthropic","API Provider","Cloud, free tier then paid, Gemini Flash/Pro","Cloud, llama-3.2-vision in 11B/90B, LLaVA","Cloud, paid (maybe free options), many models, pick from what's available within Captioning after configuring in API connections","Cloud, paid, Claude models with vision capabilities: claude-3-5-sonnet/haiku, claude-3-opus/sonnet","Cloud, paid, GPT-4 Vision, 4-turbo, 4o, 4o-mini","Cloud, paid, pixtral-large, pixtral-12B","Cloud, paid, yi-vision","Custom (OpenAI-compatible)","Description","For custom OpenAI-compatible APIs, uses currently configured model in API Connections tab","Google AI Studio","Groq","KoboldCpp","llama.cpp","Local","Local, can switch between available models and download additional vision models within Captioning after configuring in API Connections","Local, must configure model in KoboldCpp","Local, must configure model in llama.cpp","Local, must configure model in ooba","MistralAI","Ollama","OpenAI","OpenRouter","Text Generation WebUI (oobabooga)","To use one of these caption sources, select Multimodal in the Source dropdown.","vLLM"]},{"l":"KoboldCpp","p":["For general information on installing and using KoboldCpp, see the KoboldCpp documentation.","To use KoboldCpp for multimodal captioning:","get a multimodal-capable model, trained to process text and image prompts at the same time.","also get the multimodal projections for the model. These weights allow the model to understand how the text and image parts of the input relate to each other.","load the model and projections in the KoboldCpp launch GUI or command line interface.","The original and classic local multimodal model is LLaVA. GGUF-format files for the model and projections are available from Mozilla/llava-v1.5-7b-llamafile. To load them from the command line, set the model and projections with the --model and --mmproj flags. For example:","Some LLaVA finetunes you can try: xtuner/llava-llama-3-8b-v1_1-gguf, xtuner/llava-phi-3-mini-gguf.","You can use multimodal projections for the base model that your particular finetune was built from. Projections for some common base models are available from koboldcpp/mmproj."]}],[{"l":"Image Generation","p":["Ability to view all generated images in a character gallery","Advanced ComfyUI integration for highly customizable workflows","Automatically generate images as replies to your messages for full immersion, generate from chat history and character information from the wand menu or slash commands, or use the /sd (anything_here) command in the chat input bar to make an image with your own prompt.","Character-specific prompt prefixes for tailored character images","Customizable prompt templates and prefixes for consistent style and quality","Flexible visibility options for generated images in chat","Image swipes feature to regenerate images while keeping the same prompt","Integration with AI function calling for automatic image generation detection","Interactive mode to trigger image generation based on natural language requests","Most common Stable Diffusion generation settings are customizable within the SillyTavern UI.","Options to edit prompts before generation and extend free-mode prompts","Slash commands for easy image generation within chats","Style presets to quickly switch between different image generation settings","Supports multiple image generation sources, both local and cloud-based","Use local or cloud-based Stable Diffusion, FLUX or DALL-E APIs to generate images.","Various generation modes for characters, scenes, and custom prompts"]},{"l":"Supported sources","p":["All services will be discontinued on December 31, 2024","Block Entropy","Cloud","Cloud, free of charge","Cloud, open source (AGPL3), free of charge","Cloud, open source (MIT), free of charge","Cloud, paid","Cloud, requires an active subscription","ComfyUI","Deprecated, not recommended","Draw Things","HuggingFace Serverless","Local, Mac/iOS, free of charge","Local, open source (AGPL3), free of charge","Local, open source (GPL3), free of charge, see ComfyUI Configuration.","NovelAI Diffusion","OpenAI DALL-E 2/3","Pollinations","Remarks","SD.Next / vladmandic","SillyTavern Extras","Source","Stability AI","Stable Diffusion WebUI / AUTOMATIC1111","Stable Horde","TogetherAI"]},{"l":"Generation modes","p":["-","\"Background\"","\"Me\"","\"Raw Last Message\"","\"The Last Message\"","\"The Whole Story\"","\"Your Face\"","\"Yourself\"","A chat background based on story context.","A close-up portrait of the current character.","A full-body portrait of the current character.","A portrait of the user persona.","A visual recap of the chat events.","A visual recap of the last chat message.","background","Description","face","Forces a portrait aspect ratio.","Forces a wide landscape aspect ratio.","last","Last message used as a prompt verbatim.","me","raw_last","Remarks","scene","Slash command argument","Wand menu item","you"]},{"l":"How to generate an image","p":["Use the \"Image Generation\" item in the extensions context menu (wand).","Type a /sd (argument) slash command with an argument from the Generation modes table. Anything else would trigger a \"free mode\" to make SD generate whatever you prompted. Example: /sd apple tree would generate a picture of an apple tree.","Look for a paintbrush icon in the context actions for chat messages. This will force the \"Raw Message\" mode for the selected message.","Every generation mode besides raw message and free mode will trigger a prompt generation using your currently selected main generation API to convert chat context into the SD prompt. You can configure the instruction template for generating prompts for every generation mode using the \"SD Prompt Templates\" settings drawer in the extensions panel."]},{"i":"tips-and-tricks-for-the-sd-command-usage","l":"Tips and tricks for the /sd command usage"},{"l":"View all generated images","p":["To view all saved images for a character (including other chats), open a gallery from a \"More...\" dropdown menu on a character info panel, or use a /show-gallery slash command."]},{"l":"Specify a negative prompt","p":["Use a negative named argument before the prompt to enforce a specific negative prompt for this generation."]},{"l":"Include a character-specific prefix","p":["Use a special {{charPrefix}} macro in free-prompt mode to include positive and negative prompt prefixes (if defined) for the current character."]},{"l":"Suppress a chat message","p":["You can avoid posting a generated image into the chat by passing a quiet=true named argument. The image will still be added into the character gallery, and the command will produce a relative URL to the image that can be consumed by other commands.","The example below will send the generated image using Markdown as a user persona."]},{"l":"Image swipes","p":["Images swipes allow to reroll the image generation while keeping the same prompt. If a fixed seed is set, it will be randomized for the next generation.","To cycle through images, hover a mouse cursor (tap on mobile) over a generated image to reveal arrow buttons and swipes counter. Tapping right arrow on the latest image will generate a new one.","'Swipes' here is just a name, don't try the actual swiping gesture, as this will regenerate the message itself, not the attached image."]},{"l":"Options"},{"l":"Edit prompts before generation","p":["Allow to edit the automatically generated prompts manually before sending them to the Stable Diffusion API."]},{"l":"Use function tool","p":["Uses function calling to automatically detect the intention to generate an image.","Requirements:","Must have image generation configured with a supported source.","Must use a supported Chat Completion API model and have function tool calling enabled in the AI Response settings.","The \"Use function tool\" option must be enabled in the Image Generation settings.","The user should express an intent to generate an image in the chat message, e.g. \"Send me a picture of a cat\".","The interactive mode will not trigger when the function tool is enabled."]},{"l":"Use interactive mode","p":["Allows to trigger an image generation instead of text as a reply to a user message that follows the special pattern:","Contains one of the following verbs: send, mail, imagine, generate, make, create, draw, paint, render","Followed by one of the following nouns (not further than 10 characters away): pic, picture, image, drawing, painting, photo, photograph","Followed by a target subject of image generation, could be optionally preceded by phrases like \"of a\" or \"of this\".","Examples of valid requests and captured subjects:","Can you please send me a picture of a cat=> cat","Generate a picture of the Eiffel tower=> Eiffel tower","Let's draw a painting of Mona Lisa=> Mona Lisa","Some special subjects trigger a predefined generation mode:","'you, 'yourself' => \"Yourself\"","'your face', 'your portrait', 'your selfie' => \"Your Face\"","'me', 'myself' => \"Me\"","'story', 'scenario', 'whole story' => \"The Whole Story\"","'last message' => \"The Last Message\"","'background', 'scene background', 'scene', 'scenery', 'surroundings', 'environment' => \"Background\""]},{"l":"Extend free-mode prompts","p":["When using the interactive mode of the slash command, automatically extend free-mode generation subject descriptions by prompting your main API."]},{"l":"Snap auto-adjusted resolutions","p":["Snap image generation requests with a forced aspect ratio (portraits, backgrounds) to the nearest known resolution, while trying to preserve the absolute pixel counts. Refer to the \"Resolution\" dropdown for the list of possible options.","Recommended for SDXL models."]},{"l":"Common prompt prefix","p":["Added before every generated or free-mode prompt. Commonly used for setting the overall style of the picture.","Example: best quality, anime lineart.","Pro tip: Use {prompt} macro to specify where exactly the generated prompt will be inserted."]},{"l":"Negative prompt","p":["Characteristics of the image you don't want to be present in the output.","Example: bad quality, watermark."]},{"l":"Character-specific prompt prefix","p":["Any characteristics that describe the currently selected character. Will be added after a common prefix.","Example: female, green eyes, brown hair, pink shirt.","You can also specify a negative prompt prefix for any unwanted content. It will be combined with the general negative prompt.","Limitations:","Works only in 1-to-1 chats. Will not be used in groups.","Won't be used for backgrounds and free mode generations.","If you want to share the prefixes with others, tick the \"Shareable\" checkbox. This will save them with the character data, rather than your local settings.","Pro tip: If supported by the generation source, you can also use LoRAs/embeddings here, for example: lora:DonaldDuck:1."]},{"l":"Styles","p":["Use this to quickly save and restore your favorite style/quality presets to use them later or when switching between models. The following is included in the Style preset:","Common Prompt Prefix","Negative Prompt","You can also switch between styles using the /imagine-style command (or /sd-style or /img-style)."]},{"l":"Chat Message Visibility","p":["Generated images inserted into the chat are hidden in the main API prompts by default, but this can be overriden individually per generation initiator (\"Magic wand\" icon, slash command, interactive mode). This can be used for making the experience more immersive by letting the characters \"acknowledge\" the images. Multimodal models in Chat Completions API may also 'see' the images if \"Send inline images\" is enabled.","A text message can be customized by changing the \"Chat Message Template\" under Image Prompt Templates. All regular macros can be used in this template, plus a special {{prompt}} macro to specify where the image prompt will be added."]},{"l":"ComfyUI Configuration","p":["ComfyUI is a fast and very flexible option for image generation.","If you're familiar with ComfyUI, the tl;dr is: make your workflow in ComfyUI, download it in API format, and paste it into the SillyTavern ComfyUI Workflow Editor. ST will submit your workflow to ComfyUI's API and you will get an image in your chat. But with great power comes great responsibility, and the main responsibility is inserting placeholders in your workflow JSON so you can change settings from SillyTavern.","If you're not familiar with ComfyUI, you can still use it to generate images in SillyTavern using the default workflow. Later, when you want great power, you can learn how to use ComfyUI..."]},{"l":"Controls","p":["This panel allows you to configure and manage your ComfyUI integration with SillyTavern.","Enter the URL of your ComfyUI server in the ComfyUI URL input field. The default value is http://127.0.0.1:8188. If you are using SwarmUI, the default port for the managed ComfyUI server is 7821, 20 ports higher than the default port for SwarmUI.","After entering the URL, choose Connect to validate and establish a connection. The ComfyUI server must be accessible from the SillyTavern host machine."]},{"l":"Workflow Management","p":["Select a ComfyUI workflow from the dropdown menu. Two default workflows are provided:","Default_Comfy_Workflow.json: A basic text-to-image workflow supporting the most common image generation settings.","Char_Avatar_Comfy_Workflow.json: A sample image-to-image workflow that uses the character avatar, plus the prompt, to generate an image.","Use the following buttons to manage your workflows:","Open workflow editor to view and modify the selected workflow.","Create new workflow to create a new workflow with a custom name.","Delete workflow to remove the selected workflow."]},{"l":"Workflow Editor","p":["The ComfyUI Workflow Editor allows you to view and modify ComfyUI workflows for use with SillyTavern.","The main component of the editor is a large text area where you can insert or edit your ComfyUI workflow in JSON format.","To add a ComfyUI workflow to the editor, follow these steps:","Enable 'Dev Mode' in ComfyUI settings.","Use the 'Save (API Format)' option in ComfyUI to download the JSON data.","Create a new workflow in SillyTavern and open the editor.","Paste the downloaded JSON data into the text area.","Replace specific values with placeholders as needed for your use case.","You can add the API-format JSON file directly to the data/default-user/user/workflows directory in your SillyTavern installation. This will save you from steps 3 and 4.","Retain the original JSON file. If you need to open the workflow again in ComfyUI to make changes, it is much more convenient to edit the original file than the one with all the placeholders."]},{"l":"Placeholders","p":["The editor provides a list of predefined placeholders that can be used in your workflow JSON. These placeholders are replaced with dynamic values when the workflow is executed in SillyTavern.","Placeholders marked with ✅ are present in your workflow JSON. Placeholders marked with ❌ are not present in your workflow JSON. You can add these placeholders to your workflow JSON as needed. You do not need to add all the placeholders, only the ones that your workflow uses and you want to replace dynamically."]},{"l":"Prompts","p":["The %prompt% and %negative_prompt% placeholders are used to insert the image generation prompts into the workflow. These contain the final prompts generated by SillyTavern, including the generated prompt for your chosen /sd mode, the common prompt prefix, negative prompt, and character-specific prompt prefix.","For example, you may have tested your workflow with a prompt like \"forest elf\" in ComfyUI. To use this workflow in SillyTavern, you can replace the \"forest elf\" prompt with the %prompt% placeholder:","Notice that the placeholder is wrapped in double quotes. This is important for the JSON format, and required by SillyTavern's placeholder replacement system. Even for numbers, you must use double quotes in the template JSON.","Sometimes the prompt (or other value) doesn't appear where you might expect. ComfyUI will remove nodes from the API version of the workflow if they are not necessary for the workflow to function in API mode.","For instance, this workflow uses a LoRA tag loader node with a prompt primitive so the workflow is clearer in UI mode:","Prompt primitive and LoRA loader","The prompt primitive node will be removed from the API version of the workflow, so you insert the placeholder in the LoraTagLoader node. Find the text \"apple tree\" in the workflow and replace it with the %prompt% placeholder:","In some cases you may need to make several replacements in the workflow JSON, even if the prompt appears only once in the UI."]},{"l":"Model","p":["The %model% placeholder will insert the value of the selected model in the image generation settings.","An example from the default text-to-image workflow:","To load GGUF-quantized UNets, use a UNet Loader (GGUF) node in your workflow, choose a GGUF model in the SillyTavern model dropdown, and use the %model% placeholder in the node's settings like this:","Stable Diffusion checkpoints, SD UNets, and GGUF-quantized UNets all appear in the Model dropdown. Models of one type will not work with workflows/loader nodes expecting another type. If you choose an incompatible model type in ST, ComfyUI will report a problem with the loader node."]},{"l":"Avatar images","p":["Use the %user_avatar% and %char_avatar% placeholders to include the user and character avatars in the workflow. These placeholders are replaced with the PNG data of the avatars when the workflow is executed. The image data is encoded in base64 format, so you must decode it in your workflow. A popular choice for this task is the Load image (Base64) node.","In this example, the character avatar is loaded with a Load Image (Base64) node. It also uses an Image Resize node to rescale the image to whatever size is specified in the image generation settings:","Load image from base64 string and resize","Insert the %char_avatar%, %width%, and %height% placeholders into the JSON for the Load Image (Base64) and Image Resize nodes:","To get a base64-encoded image string for testing your workflow in ComfyUI, use any online tool that converts images to base64 strings. Here's an example string you can use for initial testing: sd-comfy-base64-test-string.txt."]},{"l":"Other placeholders","p":["Most other placeholders use the values of the corresponding controls in image generation settings, or the values that you specify with the /sd command:","%vae%, but most SD models include a VAE so the default workflows do not use this placeholder. Use it with custom workflows to load a VAE alongside a UNet, override the default VAE, etc.","%sampler%","%scheduler%","%steps%","%scale%","%width%","%height%","%denoise%: for the sample image-to-image workflow, vary the denoise amount between about 0.5 (barely-noticeable changes to the source image) and 1.0 (a completely different image as if no source image was used). Not used by the default text-to-image workflow because there's no point using a value other than 1.0 for text-to-image.","%clip_skip%: not used by the default workflows but available for custom workflows.","The %seed% placeholder will insert the seed value from the control if you have specified one. If you set the seed to -1, SillyTavern will generate a new random seed for each image in %seed%."]},{"l":"Custom placeholders","p":["You can add custom placeholders to your workflow:","Look for the \"Custom\" section below the predefined placeholders.","Click the \"+\" button to add a new custom placeholder.","Enter a name for the placeholder in the find field.","Enter the value that you want to replace the placeholder with in the replace field.","Custom placeholders will appear in a separate list below the predefined ones.","For example, you could replace the \"SillyTavern\" prefix for saved image filenames in the default workflow with a custom placeholder. Add a new custom placeholder with find set to filename_prefix and replace set to ServiceTesnor. Insert the new %filename_prefix% placeholder into your workflow JSON. Now you can change the filename prefix from SillyTavern to ServiceTesnor by changing the value of the custom placeholder."]},{"l":"Comfy tricks","p":["Read all the general information on this page so you're familiar with the image generation options. Options such as switchable styles and common prompt prefixes, when combined wih the total flexibility of ComfyUI workflows, allow you to create a wide variety of image generation setups."]},{"l":"Loading LoRAs","p":["Use a LoRA tag loader node (such as Load LoRA Tag) to load any LoRAs specified in the prompt. Now you can add as many LoRAs as you like to your prompt with tags like lora:CroissantStyle:0.8, and they will be loaded into your workflow. This will also make the \"pro-tip\" of using LoRAs in character-specific prompt prefixes work with ComfyUI."]},{"l":"Setting workflow values from styles or slash-commands","p":["You can use macros in custom placeholder values. As a practical example, let's say you sometimes want to generate images without a background, and you'd like this to be switchable with a slash-command or image style. Here's how you could do it:","Make a ComfyUI workflow that removes the image background, or not, depending on the value of an input","Use a custom placeholder to set the value of that input, but use {{getvar::remove_background}} as the replace value","Now you can set the value of remove_background with /setvar key=remove_background true or /setvar key=remove_background false before generating an image","The workflow will use the value you set to determine whether to remove the background","Make an image style \"No background\" with common prompt prefix {{setvar::remove_background::true}}","Use the style control or /imagine-style No background to set the value of remove_background to true before generating an image"]}],[{"l":"Live2D","p":["This guide will walk you through the process of setting up and customizing the Live2D extension for your SillyTavern experience. This extension allows you to use Live2D animated models for your character, providing a dynamic and interactive element to your virtual character."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Branch Selection: Make sure you're using the latest version of SillyTavern to access the latest features and updates.","Extension Installation: Install the \"Live2D\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (represented by the stacked blocks icon).","Model Folder Placement: Place your Live2D model folders into the /data/user-handle/assets/live2d directory. A properly organized live2d assets folder might look like this:","Asset folder example","A Live2D model folder should include all necessary components for the Live2D model, such as expressions, motions, textures, sounds, and settings files. Notably the ***.model.json file must be at the root of the Live2D model folder for the model to be detected by the extension. In this example the shizuku live2d model folder may look like this:","Live2d model folder example","Note: Models can also be placed in character-specific folders, such as /data/user-handle/characters/Shizuku/live2d/. However, models in character folders will only be accessible for that specific character."]},{"l":"Extension Settings","p":["The Live2D extension offers various settings to customize the behavior of your animated model. Here are the key settings:","UI global settings"]},{"l":"Global Settings","p":["Enabled:","Enable this checkbox to activate the extension, allowing your Live2D model to interact within SillyTavern.","You can disable the extension if you want to use normal sprites only.","You can disable the extension when you want to move normal sprites in a group chat and enable it again when you're ready to use Live2D models.","Follow Cursor:","Enable this checkbox to make the Live2D model follow your cursor, provided that the model supports this feature.","Auto-send Interaction:","Enable this checkbox to automatically trigger character interactions when you click on areas with mapped messages (refer to the hit areas section for details)."]},{"l":"Debug Settings","p":["These settings help you control the behavior and visibility of your Live2D model for debugging purposes.","Reset Model Before Animation:","Enable this checkbox to reload the model before any animation. This forces the animation to start and allows you to spam clicks if necessary. Some models may require this to ensure that animations begin from a compatible state.","Show Model Frames:","Enable this checkbox to display the model frame, making it easier to identify where to click to drag the model around. It also shows the hit area, if available. Hovering over a hit area will show its name.","Reload button","Click this button to reload every live2d model. Use it in case something glitches."]},{"l":"Character Selection","p":["These settings allow you to manage characters and assign Live2D models to them.","Refresh Button:","Click the refresh button to update the list of characters in the current chat.","Select Character:","Use the drop-down list to choose a character to assign a Live2D model to.","Remove Button:","Click this button to delete all assigned models for a character. A confirmation prompt will appear to confirm the deletion."]},{"l":"Model Selection","p":["UI model list","Refresh Button:","Click the refresh button if your Live2D model does not appear in the list.","Select Model:","Choose a model from the list to assign it to the selected character.","The model can be located in the asset folder or the current character's folder.","The list displays the model folder name, its origin (asset or character), and the name of the detected model setting file.","Note that some model folders may contain different versions of the same model. You can try different model files to see which one works best.","Selecting none will use normal sprites if there is any","Settings are saved per character and model"]},{"l":"Model Settings","p":["UI model settings","Model Scale:","Use the slider to adjust the size of the model, making it larger or smaller.","Model Center X Offset:","Use the slider to change the horizontal position of the model relative to the window center.","Model Center Y Offset:","Use the slider to adjust the vertical position of the model relative to the window center."]},{"l":"Remarks","p":["The settings are saved and carry over different chats.","You can also drag the model with your mouse, and those settings will be updated and saved.","Use these UI settings to bring your model back on the screen if you somehow made it out of view. Also, check the \"Show frame\" checkbox to see clearly where you can click to drag the model."]},{"l":"Model Talk","p":["UI model talk","Param mouth open Y id","Select from the list the ID of the parameter corresponding to the model's mouth Y value. Not all models have one, and names may vary from model to model. Usually something like \"PARAM_MOUTH_OPEN_Y\" or \"ParamMouthOpenY\". Check the model when selecting an element from the list; it will try to run the speak animation. If the mouth moves, you got it!","Mouth movement speed","Adjust the slider to change the movement speed of the mouth animation.","Time per character","Set the time duration of each character. The duration of the talk animation will be this time multiplied by the number of characters of the message."]},{"i":"remarks-1","l":"Remarks","p":["This mouth animation does not work on every model and every animation. Even if your model has animations where the mouth moves, it does not mean the mouth animation can be controlled by this extension. If nothing shows in the parameter list, your model is probably made with a too old version of Live2D to access the parameters properly."]},{"l":"Model Animations","p":["UI model animations","Starter animation","Select an expression and motion from the lists that will play when starting a chat with the character. You can also add a delay during which the model will be invisible if you need to hide the character for some time to achieve a perfect effect.","Default animation","Select an expression and motion from the list that will play when the character sends a message. Use a fallback animation when using the classify expression extension."]},{"i":"remarks-2","l":"Remarks","p":["Animations will play when you select one in the lists.","Use the replay button to replay the selected animation.","Some models have expressions defined as motions.","If nothing shows in the lists, it's probable your model's setting file has no expressions/motions defined."]},{"l":"Hit areas mapping","p":["UI model mapping","Default click animation","Select an expression and motion from the list that will play when you click on the model. You can also set a message that will be sent as a user message.","Hit areas","If the model has hit areas, they will be listed, and you can assign an animation/message to each of them."]},{"i":"remarks-3","l":"Remarks","p":["Some models have no hit areas, but the default click is detected for all.","The default click will trigger if you click on a hit area with nothing mapped or if you click outside of any hit area.","Hit areas have priority defined in the model; for example, \"mouth\" is inside \"head.\" If it does not behave properly, it may be due to the model file.","For some models, animations need to be finished before starting another one. Use the debug checkbox if you want to force the refresh and spam animations."]},{"l":"Classified Expressions Mapping","p":["UI model classify","Requirements","Requires the use of the classify expression extension; otherwise, it will fall back to the default animation.","Mapping","For each detected emotion by the classify extension, you can assign an expression/motion animation."]},{"i":"remarks-4","l":"Remarks","p":["If the previous animation did not finish when a new message is received, it's possible that the new animation will not play. This behavior is dependent on the Live2D model. Use the debug checkbox if you want to force the animation to play.","Thank you for following this guide! Your SillyTavern experience is now enriched with animated and interactive Live2D models."]}],[{"l":"Objective"},{"i":"what-is-it","l":"What is it?","p":["The Objective extension lets the user specify an Objective for the AI to strive towards during the chat. This objective is broken down into step-by-step tasks. Tasks may be branched, where child tasks can be created automatically or manually. This gives the ability to create complex task trees. The completion status of each task in the list will be checked at certain intervals.","This differs from adding static direction through prompting in that it adds sequential and paced directives for the AI to follow without user intervention. It gives a more genuine experience of the AI autonomously striving to reach a goal."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Objective\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"l":"Common Use Cases","p":["Your imagination is the limit, you can give the AI any objective you wish and it will plan out how to achieve it. You can ask it to plan how to slay a demon, rob a temple, throw a lavish party, or even take over the world.","Objective Settings Panel"]},{"l":"Configuration","p":["The extension is found in the Extensions menu under Objective.","Type an objective into the top text box, then click on Auto-Generate Tasks. This sends a request to the connected API and asks it to provide a list of tasks which match the objective you have typed in.","Note: Clicking Auto-Generate Tasks will delete all existing tasks for the currently selected Objective before adding new ones.","Upon receiving the response from the AI, a list of tasks will be created automatically in the space below the Objective input box. Tasks can be edited after creation.","At the bottom of the panel are two boxes: Position in Chat and Task Check Frequency","Position in Chat- This is how 'deep' in the chat section of the prompt you want the current task to be inserted. The lower the number, the more attention the AI will give to the task. Setting to 0 will make the task the primary thing in the AI's mind. Setting at high values will put the task in the background and allow the AI to focus on the conversation at hand, but setting it too high may cause the AI to never 'get around' to the task at all.","Task Check Frequency- This is how often you want the AI to check if the task has been completed. If it is set to 3, the AI will be asked if the current task has been completed every 3rd message.","Objectives, tasks, and their descriptions are saved in real-time to the current chat session. Custom prompts are saved globally."]},{"l":"Custom Prompts","p":["You can customize the prompts sent to the LLM to generate tasks, check task completion, and for prompt injection. Editing prompts will save them for the current session. Custom prompts can be saved and loaded for persistence.","Click Edit Prompts to open the prompt editor window. You can edit your prompts as desired.","To save prompts, enter a name and click Save Prompt.","To load prompts, select the prompt from the dropdown list.","To delete a saved prompt, select it from the dropdown list and click Delete Prompt","WARNING: Task Checking happens in a separate API request. Setting Task Check Frequency to 1 will double your API calls to the LLM service. Be careful with this if you are using a paid service."]},{"l":"Usage","p":["By default the Objective extension will keep track of all tasks and their respective completion status automatically.","The User can also manually create, update, delete, and complete tasks at any time."]},{"l":"Current Task Selection","p":["The current task will always be the first listed incomplete task. Any manual updates to tasks will trigger a check for what the current task should be. So if you add a task above a bunch of completed tasks, it will be set as the current task. Once it's completed, previously completed tasks will be skipped and the next incomplete task will be selected as 'Current'.","When using parent/child tasks in a task tree, tasks are selected depth-first, meaning all child tasks will be selected in order first, then continue down the list of tasks for the current Objective/Task."]},{"l":"Branch Tasks","p":["Click the Branch Task button to set the current task as an Objective where you can auto generate or manually create tasks as child tasks. You can continue to turn any child task into an Objective and keep generating to your hearts content.","Marking a parent task as complete will cause the extension to skip all subtasks. When all child tasks are complete, the parent task will be marked as complete"]},{"l":"Manually Complete Tasks","p":["You can manually toggle the completion status of a task by clicking the checkbox next to it. This will set the next incomplete task to be selected."]},{"l":"Manual Task Check","p":["If you want to manually trigger the AI to check for task completion, click on the Extras Extension button (the magic wand on the right side of the chat input bar) and select Manual Task Check."]},{"l":"Manually Add Tasks","p":["When no tasks are present, an Add Task button is visible, allowing you to manually create the first task.","If other tasks are already present, click the + button to the right of any task to insert a new task after it."]},{"l":"Delete Tasks","p":["Click the red x to delete an existing task. The next incomplete task will be selected as the current task automatically.","Deleting a task with child tasks will delete all child tasks and their descendants."]},{"l":"Hiding Tasks","p":["If you want to remain unaware of what tasks the AI is attempting to complete, check the Hide Tasks box to hide the task list and make the AI's intentions a mystery. For 100% mysteriousness, do this before clicking Auto-Generate Tasks!"]}],[{"i":"retrieval-based-voice-conversion-rvc","l":"Retrieval-based Voice Conversion (RVC)","p":["This guide will walk you through using RVC, a technique that allows transferring voice features from one audio clip to another, enabling voices to speak in different tones and styles.","Ever enjoyed those famous \"Presidents Play X\" videos? They were created using RVC. With the RVC extension, you can make your SillyTavern characters speak in any voice you desire, be it anime, movie, or even your own unique voice.","RVC is NOT TTS: it's more like speech-to-speech. It takes an audio clip as its input. In the background, what RVC does is work in tandem with SillyTavern's TTS extension: it waits for TTS to generate an audio file (which TTS would've done regardless of whether you use RVC or not), then RVC will perform a second pass that takes the TTS audio file and transforms it into the cloned voice from your RVC configuration."]},{"l":"RVC Setup","p":["SillyTavern's RVC supports several API sources that perform audio conversion:","rvc-python","SillyTavern Extras(deprecated)"]},{"l":"Common prerequisites","p":["Before you begin, ensure you've met the following prerequisites."]},{"l":"ffmpeg","p":["Make sure you have ffmpeg binary in your PATH environment variable. This tool is used to convert incoming audio.","Windows:","Use the Toolbox in SillyTavern Launcher script to install ffmpeg automatically: https://github.com/SillyTavern/SillyTavern-Launcher","Or download the build here: https://www.gyan.dev/ffmpeg/builds/","How to modify PATH variable: https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/","To test whether you did things correctly, open a command prompt and run ffmpeg. It should print the ffmpeg version and info.","Linux:","Install ffmpeg using your package manager.","macOS:","Install ffmpeg using Homebrew:"]},{"l":"Make sure TTS is enabled and works","p":["RVC depends on TTS, you need to enable a TTS extension. Your TTS has to be already working properly and narrating your chats before you try to add RVC to the mix!","Please note, that:","System TTS engine does not support voice conversion at all.","Streaming TTS will wait for the audio stream to end before conversion."]},{"l":"Install the extension","p":["Install the \"RVC\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon)."]},{"i":"enable-rvc-in-sillytavern","l":"Enable RVC in SillyTavern*","p":["In SillyTavern, navigate to Extensions> RVC and enable it."]},{"l":"Pick the source","p":["In the extension settings, choose an RVC source to use. Then proceed to the source-specific installation instructions."]},{"l":"rvc-python Setup"},{"l":"1. Install the package","p":["Follow the installation instructions from the GitHub page: rvc-python Installation. It is recommended to follow CUDA installation instructions if you have an Nvidia GPU.","If you're experiencing problems when installing on Windows (e.g. building fairseq step fails), make sure the following software is installed on your PC:","Windows 10 SDK","Visual Studio Build Tools 2022"]},{"l":"2. Prepare the models","p":["Create a directory for storing RVC models. By default it is named rvc_models and is picked up from your current directory when starting up the server. Every model is a subfolder (its name will be visible in the UI) that should contain .pth(required) and .index(optional) files.","Read more: rvc-python Model Management"]},{"l":"3. Start the API server","p":["Start the API server by running the following command:","Arguments:","5050- sets a listening port for the server. Change if you want to host on a different port.","models_path- sets a path for models. Remove if you want to use the default rvc_models directory.","-l- sets the server to listen on all network interfaces. Remove to only listen on localhost."]},{"l":"4. Connect to the server","p":["In the RVC extension settings, set an appropriate rvc-python API URL. By default, it will be http://localhost:5050.","Check the Use CUDA checkbox if you have installed rvc-python to support CUDA acceleration.","Press \"Refresh\" to load a list of available voices."]},{"l":"5. Configure a voice map","p":["Voice map defines voice conversion settings for every character or user persona.","To set up a voice map, choose your character or persona name from the \"Character\" dropdown, then choose an RVC \"Voice\", then click Apply.","Optionally, you can also configure other related settings such as pitch correction or filtering.","If you did everything correctly, the Voice Map debug area will show something like 'Betty:MyVoice(rvpme)'."]},{"l":"SillyTavern Extras Setup"},{"l":"1. Prepare RVC Model Files","p":["In a file browser, navigate to: \\SillyTavern-extras\\data\\models\\rvc.","Create a subfolder like 'Betty' and place the .pth and .index files into it. (Hint: you can download voice files from https://voice-models.com, make sure the voice name says it's RVPME.)"]},{"l":"2. Install Requirements","p":["Install the necessary requirements using the command:"]},{"l":"3. Run SillyTavern-extras with RVC enabled","p":["Launch SillyTavern-extras with the RVC module enabled. This example invocation assumes you used Edge TTS which comes pre-installed with SillyTavern-extras:","Optionally, you may wish to run RVC on your GPU if you have a capable one, by adding --cuda to the startup command. Based on a quick test, VRAM usage was 3.4GB for narrating 50 tokens (~ 36 words), and 7.6GB for 200 tokens (~ 150 words)."]},{"l":"4. Set Up Voice Mapping","p":["Create a Voice map for RVC. Set your Character to your desired SillyTavern character name, and set Voice to the RVC folder you created at step 1, then click Apply. If you did things correctly, the Voice Map will show something like 'Betty:MyVoice(rvpme)'."]},{"l":"5. Select Pitch Extraction","p":["Choose \"rmvpe\" as the pitch extraction method.","If you have trouble with \"rmvpe\" try other methods (for example, \"harvest\" or \"torchcrepe\")."]},{"i":"6-optional-configure-rvc-to-save-your-generations-to-file","l":"6. (Optional) Configure RVC to save your generations to file","p":["If for testing or troubleshooting purposes you wish to save the generated RVC audio, add --rvc-save-file to your startup command. This will save the last generation under SillyTavern-extras/data/tmp/rvc_output.wav:"]},{"l":"Expression-Based Dynamic Voice"},{"l":"1. Configure RVC Models","p":["In your RVC model folder, have separate .pth and .index files for each classified expression (e.g., anger, fear, joy, love, sadness, surprise)."]},{"l":"2. Enable Modules","p":["Enable both RVC and classify modules:"]},{"l":"3. Use RVC Module","p":["The remaining setup is similar to using the RVC module alone (as explained above)."]},{"l":"Train Your Own RVC Model"},{"i":"using-rvc-easy-menu-by-deffcolony-windows-only","l":"Using RVC Easy Menu by Deffcolony (Windows Only)","p":["Automatically install and launch Mangio-RVC: https://github.com/deffcolony/rvc-easy-menu"]},{"l":"1. Clone Repository","p":["Clone the repository to your desired location:"]},{"i":"2-launch-rvc-launcherbat","l":"2. Launch RVC-Launcher.bat","p":["Open the RVC-Launcher.bat file.","Choose option 1 to install RVC."]},{"l":"3. Complete Installation","p":["When prompted, install required packages and dependencies."]},{"l":"4. Open WebUI for Voice Training","p":["After installation, choose option 2 to open the WebUI for voice training."]},{"i":"mangio-rvc-training-a-voice-model","l":"Mangio-RVC: Training a Voice Model","p":["1. Access Training Tab:","1. Prepare Audio:","2. Configure Experiment:","3. Process Data and Extract Features:","4. Training Parameters:","Click \"Process data\" and \"Feature extraction\".","Click \"Train feature index\" and \"Train model\".","Click on the training tab in the WebUI.","Dataset Preparation:","Ensure the audio is free of background noise – only raw voice is needed.","Enter an experiment name (e.g., my-epic-voice-model).","Longer audio makes a better output quality.","Place the audio you want to train in the datasets folder.","Set \"Save frequency\" to 50.","Set \"Total training epochs\" to 300.","Set version to v2.","WebUI Training:"]}],[{"l":"Speech Recognition","p":["This guide will walk you through setting up speech recognition to transcribe your voice into text within SillyTavern."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Make sure you're on the latest version of SillyTavern.","Install the \"Speech Recognition\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon).","Have ffmpeg binary installed. See RVC setup for more details."]},{"i":"speech-recognition-setup-browser","l":"Speech Recognition Setup (Browser)","p":["Append: Your message will be appended to the current user message text area.","Auto send: Your message will automatically be sent once the end of speech is detected.","Choose the \"Message Mode\" you want:","Choose the language you want to speak (Note: not every browser supports all languages).","Configure SillyTavern:","Enable Message Mapping(Optional):","For instance, by adding \"command delete = /del2\", the \"/del2\" command will replace your voice message when \"command delete\" is detected.","If your browser doesn't support voice recognition, an error popup will appear.","Launch SillyTavern and go to Extensions> Speech Recognition.","Recording:","Replace: Your message will replace the current user message in the text area.","Select \"Browser\" from the dropdown options.","Select Language:","Select Message Mode:","Setup phrases mapping for vocal shortcuts.","To start recording, click the microphone button to the right of the message area next to the send button. Click again to stop recording. Recording may stop automatically if no voice is detected.","Useful when combined with auto send mode for full voice control. Enable this by checking \"Enable messages mapping\"."]},{"i":"speech-recognition-setup-whispervosk","l":"Speech Recognition Setup (Whisper/Vosk)","p":["Enable Provider:","Enable the desired speech recognition provider on the extras server using the following command:","or","You can also use a custom model by adding the option --stt-vosk-model-path or --stt-whisper-model-path with the path to the model.","Configure SillyTavern:","Launch SillyTavern and go to Extensions> Speech Recognition.","Select \"Vosk\" or \"Whisper\" from the dropdown options (whisper is more accurate).","The settings are similar to the \"Browser\" provider setup (except for language) see above."]},{"i":"speech-recognition-setup-streaming","l":"Speech Recognition Setup (Streaming)","p":["Enable Provider:","Enable the streaming speech recognition module on Sillytavern-extras with the following command:","Configure SillyTavern:","(Optional) Specify a custom Whisper model as in the Whisper setup above.","(Optional but recommended) Set up trigger words in SillyTavern. Only messages starting with these trigger words will be sent to SillyTavern as actual messages. This prevents random speech or noise from being transcribed. Enable this with the checkbox. The trigger words can be included/excluded from the actual message using a checkbox.","Other settings are similar to other providers.","You're now ready to transcribe your voice into text using speech recognition in SillyTavern."]}],[{"l":"Summarize"},{"i":"what-is-it","l":"What is it?","p":["This extension allows you to create, store, and utilize automatically generated summaries based on the events happening in your chats. Summarization can help with outlining general details of what is happening in the story, which could be interpreted as a long-term memory, but take that statement with a grain of salt. Since the summaries are generated by language models, the outputs may lose some important details or contain hallucinations, so you're always advised to keep track of the summary state and correct it manually if needed."]},{"l":"Common configuration","p":["The summarization extension is installed in SillyTavern by default, thus it will show up in ST's Extensions panel (stacked cubes icon) list like this:","Summarize Config Panel","Current summary- displays and provides an ability to modify the current summary. The summary is updated and embedded into the chat file's metadata for the message that was the last in context when the summary was generated. Deleting or editing a message from the chat that has a summary attached to it, will revert the state to the last valid summary.","Restore Previous- removes the current summary, rolling it back to the previous state. This is useful if the summarizer does a poor job at any given point.","Pause- check this to prevent the summary from being automatically updated. This is useful if you want to provide a custom summary of your own or to effectively disable the summary by clearing the box and stopping updates.","Popup window- allows to detach the summary into a movable UI panel on the sidebar. Useful for the desktop layout to easily have access to summarization settings without having to navigate through the extensions menu.","Injection Template- defines how the summary will be wrapped when being inserted into regular chat prompts. A special {{summary}} macro should be used to denote the exact location of the current summary state in the prompt injection text.","Injection Position- sets the location of the prompt injection. The options are the same as for Author's Notes: before or after the main prompt, or in-chat at designated depth."]},{"l":"Supported summary sources"},{"l":"Main API","p":["Summarization will be powered by your currently selected AI backend, model and settings. This method requires no additional setup, just a working API connection.","This option has the following sub-modes that differ depending on how the summary prompt is built:","Raw, blocking. The summary will be generated using nothing but the summarization prompt and the chat history. Subsequent prompts will also include the previous summary with messages that were sent after the summary was generated (see example). This mode can (and will) generate prompts that have a lot of variability between them, so it is not recommended to use it with backends that have slow prompt processing times, such as llama.cpp and its derivatives.","Raw, non-blocking. Same as above, but the chat generation will not be blocked during the summary generation. Not every backend supports simultaneous requests, so switch to blocking mode if summarization fails.","Classic, blocking. The summarization prompt will be sent at the end of your usual generation prompt, as a neutral system instruction, not omitting the character card, main prompt, example dialogues and other parts of chat prompts. This usually results in prompts that play nicely with reusing processed prompts, so it is recommended to use with llama.cpp and its siblings."]},{"l":"Summary Settings explained","p":["Summary Prompt- defines the prompt that will used for creating a summary. May include any of the known macros, as well as a special {{words}} macro (see below).","Target summary length (words)- defines the value of the {{words}} macro that can be inserted into the Summary Prompt. This setting is completely optional and has no effect at all if the macro is not used.","API response length (tokens)- allows to set an override API response length for generating summaries that are different from the globally set value.","Max messages per request (raw modes only)- set to limit the maximum number of messages that will be included in one summarization prompt. 0 means no explicit limitation, but the resulting number of messages to summarize will still depend on the maximum context size, calculated using the formula: max summary buffer = context size - summarization prompt - previous summary - response length. Use this when you want to get more focused summaries on models with large context sizes.","No WI/AN- omit World Info and Author's Note from text to be summarized. Only has an effect when using the Classic prompt builder. The Raw prompt builder always omits WI/AN.","Update every X messages- sets the interval at which the summary is generated. 0 means that the automatic summarization is disabled, but you can still trigger it manually by clicking the \"Summarize now\" button. This should be adjusted based on how quickly the prompt buffer entirely fills with chat messages. Ideally, you'd want to have the first summary generated when the messages are starting to get dropped out of the prompt.","Update every X words- same as above, but using words (not tokens!) instead of messages, theoretically can be a more accurate measurement due to how unpredictable the contents of chat messages usually are, but your mileage may vary.","If both \"Update every\" sliders are set to a non-zero value, then both will trigger summary updates at their respective intervals, depending on what happens first. It is strongly advised to update these values accordingly when you switch to another model that has differing context sizes, otherwise, the summary generation may trigger too often, or never at all.","If you're unsure about the interval settings, you can click the \"magic wand\" button above the \"Update every\" sliders to try and guess the optimal values based on some simple heuristics. A brief description of the algorithm is as follows:","Calculate token and word counts for all chat messages","Determine target summary length based on desired prompt words","Calculate the maximum number of messages that can fit in the prompt based on the average message length","If \"Max messages\" is set, adjust the average to account for messages that don't fit the summary limit","Round down the adjusted average messages per prompt to a multiple of 5"]},{"l":"Example prompts","p":["Raw prompt","Classic prompt"]},{"l":"Extras API","p":["Extras server with the summarize module could run an auxiliary summarization model (BART).","It has a very small context size (~ 1024 tokens), so its ability to handle large summaries is quite limited.","To configure the Extras summary source, do the following:","Install or Update Extras to the latest version.","Run Extras with the summarize module enabled: python server.py --enable-modules=summarize"]},{"l":"Changing Summary Model","p":["By default, Summarize uses the Qiliang/bart-large-cnn-samsum-ChatGPT_v3 model for summarization purposes.","This can be changed by using the command line argument --summarization-model=(###Hugging-Face-Model-URL-Here###)","A known alternate Summarize model is Qiliang/bart-large-cnn-samsum-ElectrifAi_v10."]}],[{"l":"TTS","p":["SillyTavern has a wide range of TTS options. This page explains the setup and use."]},{"i":"what-is-it","l":"What is it?","p":["TTS is used to have a voice narrate parts of your chat."]},{"l":"Configuring TTS"},{"l":"TTS Provider Selectbox","p":["Used to select which TTS service you want to use.","ElevenLabs- paid subscription required, highest quality voices available at present.","Silero- free, runs on your PC, quality can vary widely","System- uses your OS TTS engine, if one exists. Quality can vary widely depending on the OS.","Edge- free, runs via Azure, generally quite fast, and voices feel natural but dry and emotionless. Like listening to the evening news or a radio announcer. When running with \"Plugin\" selected as the provider, you also need to install this server plugin, otherwise the TTS won't work.","Coqui-TTS- free, No API Implementation at this time. High-performance Text2Speech models (Tacotron, Tacotron2, Glow-TTS, SpeedySpeech) as well as Bark.","Novel- requires a paid NovelAI subscription, generated by NovelAI's TTS engine","RVC- free, voice cloning"]},{"l":"Checkboxes","p":["\"Good evening, senpai\"","\"Good evening, senpai\", she says.","\"nya\"... \"Good evening, senpai\"","Auto Generation- lets TTS start playing automatically when a new message enters the chat","Cohee approaches you with a faint \"nya\" \"Good evening, senpai\", she says.","Disabled","Enabled","Enabled- turns TTS playback on/off","Given the example text: *Cohee approaches you with a faint nya* Good evening, senpai, she says. Here's a table showing how the text will be modified based on the boolean states of Ignore *text, even \"quotes\", inside asterisks* and Only narrate \"quotes\":","having both \"only narrate quotes\" and \"ignore asterisks\" checkboxes both checked will result in the TTS only reading \"quotes\" which are not in asterisks, and ignoring everything else.","Ignore *text, even \"quotes\", inside asterisks*","Ignore *text, even \"quotes\", inside asterisks*- TTS will not play any text within *asterisks*, even \"quotes\" (internal variable name = narrate_dialogues_only)","Narrate only the translated text- this will make the TTS only narrate the translated text.","Only narrate \"quotes\"","Only narrate \"quotes\"- Limits TTS playback to only include text within quotation marks. This will *include quotes within asterisk lines*(internal variable name = narrate_quoted_only)","Output"]},{"l":"Sliders","p":["These will change depending on the API you select.","(explanation coming soon)"]},{"l":"Buttons","p":["Apply- this must be clicked after setting a TTS API and after editing the voice map.","Available voices- loads a popup with all voices available for your selected API, and lets you preview them with sample dialogues."]},{"l":"Using TTS","p":["Click the \"Enable\" checkbox, or nothing will ever happen.","Click the \"Auto-generation\" checkbox if you want the TTS to start automatically every time a new message arrives in chat.","Optionally, click the megaphone icon inside the top-right of any message to playback on demand.","Click the lower right \"Stop\" button (found inside the wand menu) to stop any playback."]},{"l":"Voice Map","p":["You must provide a voice map for the TTS to use, otherwise, it won't know what voices should be used for each character.","These must be in the exact format stated below:","CharacterName:TTSVoice,CharacterName2:TTSVoice2","For Coqui-TTS the format needs to include the speaker and language from the WebGUI:","CharacterName:TTSVoice[speakerid][langid] or Aqua:tts_models--multilingual--multi-dataset--your_tts\\model_file.pth[2][1]"]},{"l":"Bark ZeroShot Voice Cloning Speakers","p":["If using Bark you must create a voice folder with a voice file to clone. Ensure you add voices to homedir\\tts\\bark_v0\\speakers. On Windows it is probably C:\\Users\\USERACCOUNT\\AppData\\Local\\tts\\bark_v0\\speakers\\ type %appdata% in windows explorer then go UP a directory to local and you should see tts.","The directory should look like this:","homedir","tts","bark_v0","speakers","customvoice1","speaker.wav","speaker.npz","robinwilliams","speaker.mp3","me","One first load of this model and voice bark will clone the voice and create a .npz file, this is needed for faster TTS."]}],[{"l":"AllTalk TTS V2","p":["AllTalk is a voice cloning system based on Coqui XTTS, F5-TTS, VITS, Piper and other TTS model engines, designed to produce high-quality voice reproduction (either zero shot voice cloning or built-in voices). In AllTalk V2, significant updates enhance functionality and ease of use, including multiple TTS engine support, expanded customization, and performance optimizations. For a comprehensive list of features, refer to the AllTalk Wiki here."]},{"i":"key-features-in-alltalk-v2","l":"\uD83D\uDFE9 Key Features in AllTalk V2","p":["Multi-engine Support: Easily switch between Coqui XTTS, VITS, Piper, Parler, F5, and custom engines.","Voice Conversion (RVC): Enhanced retrieval-based voice cloning pipeline.","Customizable Settings: Adjust per-engine settings and save startup configurations.","Narrator Functionality: Specify separate voices for narration and characters.","Standalone and Integrated Use: Seamless integration with SillyTavern.","DeepSpeed and Low VRAM Modes: Performance optimization for resource-limited environments.","Screenshots: See AllTalk V2’s interface here."]},{"i":"setup-and-installation-options","l":"\uD83D\uDFE8 Setup and Installation Options","p":["AllTalk offers both standalone and integrated installation methods. The fastest setup involves using one of the quick installation options provided, with scripts automating most of the process.","Standalone Installation: Recommended for most users ( Standalone Guide)","Text-generation-webui Integration: For integration into Text-generation-webui ( TGWUI Installation Guide)"]},{"i":"manual-installation","l":"\uD83D\uDFE9 Manual Installation","p":["For advanced users requiring detailed control, follow the Manual Installation Guide for a step-by-step setup on Windows, Linux, or Mac (untested)."]},{"i":"google-colab-installation","l":"\uD83D\uDFE9 Google Colab Installation","p":["Run AllTalk in a cloud environment with the Google Colab Installation for users who prefer not to install locally."]},{"i":"using-alltalk-within-sillytavern","l":"\uD83D\uDFE8 Using AllTalk within SillyTavern","p":["Once AllTalk is loaded, select it within SillyTavern on the TTS page, ensuring to select the correct AllTalk server version in the settings.","Settings Management: AllTalk may enable or disable specific settings based on your selected configuration.","Loading Sequence: If SillyTavern is loaded before AllTalk, reload the TTS extensions page.","Performance Optimization: Enable DeepSpeed and Low VRAM modes selectively to improve performance based on system resources.","Narrator function: Details of the Narrator function can be found on the AllTalk Wiki.","Full details of the SillyTavern AllTalk Extension will be updated on the AllTalk Wiki page for SillyTavern","TGWUI Users who user the AllTalk extension for TGWUI need to disable Enable TGWUI TTS in the TGWUI chat interface, otherwise you will have duplicate TTS audio generated."]},{"i":"troubleshooting","l":"\uD83D\uDFE8 Troubleshooting","p":["If you experience issues that you believe are specific to AllTalk within SillyTavern, please refer to the AllTalk Wiki page for SillyTavern for the lastest information."]},{"i":"support-assistance-and-feature-requests","l":"\uD83D\uDFEA Support, Assistance, and Feature Requests","p":["For further assistance:","Refer to the Wiki and built-in documentation.","Join discussions on the Discussion Board.","Submit bugs or feature requests through the Issue Tracker."]}],[{"l":"XTTS with voice cloning","p":["Greetings! So, you've been blown away by those Reddit posts showcasing how far the technology went for the AI text-to-speech?","Feeling excited to give your robotic waifu/husbando a new shiny voice modulator?","Fear not, this stunning groundbreaking technology is already available at your local SillyTavern, you just need a simple..."]},{"l":"Prerequisites","p":["Latest version of SillyTavern.","Miniconda installed.","(Windows) Visual C++ Build Tools installed.","WAV files with voice clips to clone from (~ 10 seconds per file). File requirements: PCM, Mono, 22050Hz, 16-bit (convert via Audacity).","Create a folder with \"speakers\" and \"output\" subfolders. Put WAV files into \"speakers\".","Example folder structure:"]},{"l":"Installing","p":["daswer123 made an API server that runs the XTTSv2 model on your computer and connects to SillyTavern's TTS extension.","It's completely independent of Extras API and would use a separate environment.","Very important: Don't install the following requirements to your Extras environment or system Python. It will break your other packages, do unnecessary downgrades, etc.","The following instruction is provided using Miniconda, but you can also do it with venv (not covered here). Open the Anaconda command prompt and follow the instructions line by line."]},{"l":"Getting the server up and running","p":["Navigate to the folder you've created at step 4 of prerequisites.","Create a new conda env. From now on, we'll call it xtts.","Activate a newly created env.","Install Python 3.10 to your env. Confirm with \"y\" when prompted.","Install the XTTS server with its requirements.","Install PyTorch. This can take some time. The following line installs PyTorch with GPU acceleration support (CUDA). If you want to use just the CPU inference, drop the last part that starts with --index-url.","Start the XTTS server on the default host and port: http://localhost:8020","During your first startup, the model will be downloaded (about ~ 2 GB). Don't forget to read the legal notice from Coqui AI very carefully. Lol, I'm kidding, just hit \"y\" again."]},{"l":"Connecting to SillyTavern","p":["Open the extensions panel, expand the TTS menu, and pick \"XTTSv2\" in the provider list.","Choose your text-to-speech language in the Language dropdown (I'll be sad if it's not Polish).","Verify that the provider endpoint points to http://localhost:8020 and \"Available voices\" shows a list of your voice samples.","Pick any character and set a mapping between the voice sample and the character. If the characters list is empty, hit \"Reload\" a couple of times.","Configure the rest of the TTS settings according to your preferences."]},{"i":"youre-all-set-now","l":"You're all set now!","p":["Click on the bullhorn icon in the context actions menu for any message and hear the beautiful cloned voice emanating from your speakers. The generation takes some time and it's not real-time even on high-end RTX GPUs."]},{"i":"streaming","l":"Streaming?","p":["It's possible to use HTTP streaming with the latest version of the XTTS server to get the chunks of generated audio as soon as it is available!"]},{"i":"this-doesnt-work-with-rvc","l":"This doesn't work with RVC!","p":["The audio will still be generated (assuming you're using the latest version of the RVC extension) and converted, but not streamed as RVC requires to have the full audio file before initiating the conversion. Streamed RVC is still being investigated..."]},{"i":"how-to-get-streaming-support","l":"How to get streaming support?","p":["Update SillyTavern to the latest version.","Update the XTTS server to the latest version.","Start and connect XTTS to ST as usual.","Enable the \"Streaming\" XTTS extension setting in SillyTavern."]},{"i":"choppy-audio","l":"Choppy audio?","p":["Try increasing the \"chunk size\" setting.","For reference: with a chunk size of 200, RTX 3090 can produce uninterrupted audio at the cost of slightly increased audio latency."]},{"i":"how-to-restart-the-tts-server","l":"How to restart the TTS server?","p":["Just do steps 1, 3 and 7 from the installation instruction."]},{"i":"android","l":"Android??","p":["Unlikely, it can't run apps that require PyTorch without some arcane black magic that we don't provide support for. You can try it out at your own risk, but no support will be provided if you face any problems.","Your best solution is to host the TTS API on your PC over the local network, just don't forget to specify the host and port to listen on - see README."]}],[{"l":"VRM","p":["This guide will walk you through the process of setting up and customizing the VRM extension for your SillyTavern experience. This extension allows you to use VRM animated models for your character, providing a dynamic and interactive element to your virtual character."]},{"l":"Prerequisites","p":["Before you begin, ensure you've met the following prerequisites:","Branch Selection: Make sure you're using the latest version branch of SillyTavern to access the latest features and updates.","Extension Installation: Install the \"VRM\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (represented by the stacked blocks icon).","Model Folder Placement: Place your VRM model files (.vrm) into the /data/user-handle/assets/vrm/model directory and your animation files into the /data/user-handle/assets/vrm/animation directory. The currently supported animation file format are .fbx and .bvh that are compatible with VRM models. This include any animation you can get from Mixamo ( https://www.mixamo.com/) and any animation you can export from tools like XR Animator ( https://github.com/ButzYung/SystemAnimatorOnline)."]},{"l":"Extension Settings","p":["The VRM extension offers various settings to customize the behavior of your animated model. Here are the key settings:","UI global settings"]},{"l":"Global Settings","p":["Enabled:","Enable this checkbox to activate the extension, allowing your VRM model to interact within SillyTavern.","You can disable the extension if you want to use normal sprites only.","Look at camera:","Enable this checkbox to make the VRM model eyes look at the camera.","Blink:","Enable this checkbox to make the VRM model eyes blink at random intervals. Model expressions should define properly blinking weight property otherwize model can blink with closed eyes for example, if that happens either:","correct the model if you have the .vroid file","don't use that incorrect face experession","disable blinking completly with this checkbox","TTS Lip sync","Enable this checkbox to have the VRM mouth movement follow the sound of your TTS when it's played. Only work with TTS whose sound is played by Sillytavern itself like XTTS (not in streaming mode). If disabled, mouth will be animated according to the message text length when a new character message is received.","Auto-send Interaction:","Enable this checkbox to automatically trigger character interactions when you click on areas with mapped messages (refer to the hit areas section for details)."]},{"l":"Performances Settings","p":["Body hitboxes","Enable this checkbox to activate detection of click on several part of the VRM model depending on the model the following area can be detected: head/chest/hands/groin/butt/legs/feets. Hitboxes location are computed at each frames and follow the body animation, disabling this option can improve performance.","Use model cache","Enable this checkbox to keep in memory VRM model when switching models, allows to switch back to previous model faster. Usefull if you use different model for the same character to change outfit or form for example. Can affect performance.","Use animation cache","Enable this checkboxx to keep in memory all animations played during the session. All animation assigned to a model will also be loaded the first time the model appear. Will increase the time you load the model the first time but make all animation switch instant. Can affect performance."]},{"l":"Debug Settings","p":["Show grid","Enable this checkbox to visualize the 3d grid, model dragging box and body hitboxes.","Reload button","Click this button to reload the 3d scene, clear the cache and all VRM models. Use it if some bug occurs or if cache starts to hit performance."]},{"l":"Scene Settings","p":["UI scene settings","Light Color","Set the color of the light in the 3d scene. Click on the reset button to set it back to the default white color. Depending on your browser you can use a color picker, for example you can color pick the color of your background image to add more immersion.","Light intensity","Set the light intensity in percent using the slider. Click on the reset button to set it back to the default value of 100%. VRM model can react differently to light depending on the baked shaders into the model, play with the value and see how it goes.","UI model settings"]},{"l":"Character Selection","p":["These settings allow you to manage characters and assign VRM models to them.","Refresh Button:","Click the refresh button to update the list of characters in the current chat.","Select Character:","Use the drop-down list to choose a character to assign a VRM model to.","Remove Button:","Click this button to delete the assigned model for a character."]},{"l":"Model Selection","p":["Refresh Button:","Click the refresh button if your VRM model does not appear in the list.","Select Model:","Choose a model from the list to assign it to the selected character.","The model has to be located in /data/user-handle/assets/vrm/model directory.","Reset button","Click this button to reset the model settings to its default. If you have animation files that correspond to the default value they will be auto mapped. See the naming mapping at the end of this README."]},{"l":"Model Settings","p":["Model Scale:","Use the slider to adjust the size of the model, making it larger or smaller.","Model Center X/Y Offset:","Use those sliders to change the horizontal/vertical position of the model relative to the window center.","Model X/Y Rotation","Use those sliders to change the horizontal/vertical rotation of the model relative to the model hips."]},{"l":"Remarks","p":["UI hitboxes settings"]},{"l":"Hitboxes mapping","p":["UI classify settings"]},{"l":"Classified Expressions Mapping","p":["Requirements","Requires the use of the classify expression extension; otherwise, it will fallback to the default animation.","Mapping","For each detected emotion by the classify extension, you can assign an expression/motion/message. The message can contain commands."]},{"l":"Commands","p":["\"/vrmmotion idle\" or \"/vrmmotion character=Seraphina motion=idle loop=true random=false\"","/vrmexpression","/vrmlightcolor","/vrmlightintensity","/vrmmodel","/vrmmotion","arguments: character, expression","arguments: character, model","arguments: character, motion, loop, random","arguments: color","arguments: intensity","assign the vrm model to the character","change the animation of the model","change the expression of the model","example: \"/vrmexpression happy\" in solo chat or \"/vrmexpression character=Seraphina expression=happy\" in group chat","example: \"/vrmlightcolor white\" or \"/vrmlightcolor purple\".","example: \"/vrmlightintensity 0\" or \"/vrmlightintensity 100","example: \"/vrmmodel Seraphina.vrm\" in solo chat or \"/vrmmodel character=Seraphina model=Seraphina.vrm\" in group chat","set the light color","set the light intensity in percent"]},{"l":"Animations default mapping","p":["If your animation file are named in the following way they will be mapped automatically when reseting a model settings. For example the files named \"assets/vrm/animation/neutral.bvh\" and \"assets/vrm/animation/neutral1.fbx\" will be automatically mapped as a group for default and neutral classified animation. Same goes for the hitboxes.","Thank you for following this guide! Your SillyTavern experience is now enriched with animated and interactive 3D models."]},{"i":"remarks-1","l":"Remarks"}],[{"l":"Web Search","p":["Adds web search results to LLM prompts."]},{"l":"Available sources"},{"l":"Selenium Plugin","p":["Requires an official server plugin to be installed and enabled.","See SillyTavern-WebSearch-Selenium for more details.","Supports Google and DuckDuckGo engines."]},{"l":"Extras API","p":["Requires a websearch module and Chrome/Firefox web browser installed on the host machine.","Supports Google and DuckDuckGo engines."]},{"l":"SerpApi","p":["Requires SerpApi key and provides access to Google search.","Get the key here: https://serpapi.com/dashboard"]},{"l":"SearXNG","p":["Requires a SearXNG instance URL (either private or public). Uses HTML format for search results.","Learn more: https://docs.searxng.org/"]},{"l":"Tavily AI","p":["Requires an API key. Get the key here: https://app.tavily.com/"]},{"l":"KoboldCpp","p":["KoboldCpp URL must be provided in Text Completion API settings. KoboldCpp version must be >= 1.81.1 and WebSearch module must be enabled on startup: enable Network => Enable WebSearch in the GUI launcher or add --websearch to the command line.","See: https://github.com/LostRuins/koboldcpp/releases/tag/v1.81.1"]},{"l":"How to use","p":["Make sure you use the latest version of SillyTavern.","Install the extension via the \"Download Extensions & Assets\" menu in SillyTavern.","Open the \"Web Search\" extension settings, set your API key or connect to Extras, and enable the extension.","The web search results will be added to the prompt organically as you chat. Only user messages trigger the search.","To include search results more organically, wrap search queries with single backticks: Tell me about the `latest Ryan Gosling movie`. will produce a search query latest Ryan Gosling movie.","Optionally, configure the settings to your liking."]},{"l":"Settings"},{"l":"General","p":["Enabled - toggles the extension on and off.","Sources = sets the search results source.","Cache Lifetime - how long (in seconds) the search results are cached for your prompt. Default = one week."]},{"l":"Prompt Settings","p":["Prompt Budget - sets the maximum capacity of the inserted text (in characters of text, NOT tokens). Rule of thumb: 1 token ~ 3-4 characters, adjust according to your model's context limits. Default = 1500 characters.","Insertion Template - how the result gets inserted into the prompt. Supports the usual macro + special macro: {{query}} for search query and {{text}} for search results.","Injection Position - where the result goes in the prompt. The same options as for the Author's Note: as in-chat injection or before/after system prompt."]},{"l":"Search Activation","p":["Use function tool - uses function calling to activate search or scrape web pages. Must use a supported Chat Completion API and be enabled in the AI Response settings. Disables all other activation methods when engaged.","Use Backticks - enables search activation using words encased in single backticks.","Use Trigger Phrases - enables search activation using trigger phrases.","Regular expressions - provide a JS-flavored regex to match the user message. If the regex matches, the search with a given query will be triggered. Search query supports `` and $1-syntax to reference the matched group. Example: /what is happening in (.*)/i regex for search query news in $1 will match a message containing what is happening in New York and trigger the search with the query news in New York.","Trigger Phrases - add phrases that will trigger the search, one by one. It can be anywhere in the message, and the query starts from the trigger word and spans to \"Max Words\" total. To exclude a specific message from processing, it must start with a period, e.g. .What do you think?. Priority of triggers: first by order in the textbox, then the first one in the user message.","Max Words - how many words are included in the search query (including the trigger phrase). Google has a limit of about 32 words per prompt. Default = 10 words."]},{"l":"Page Scraping","p":["Visit Links - text will be extracted from the visited search result pages and saved to a file attachment.","Visit Count - how many links will be visited and parsed for text.","Visit Domain Blacklist - site domains to be excluded from visiting. One per line.","File Header - file header template, inserted at the start of the text file, has an additional {{query}} macro.","Block Header - link block template, inserted with the parsed content of every link. Use {{link}} macro for page URL and {{text}} for page content.","Save Target - where to save the results of scraping. Possible options: trigger message attachments, or chat attachments of Data Bank."]},{"l":"More info","p":["Search results from the latest query will stay included in the prompt until the next valid query is found. If you want to ask additional questions without accidentally triggering the search, start your message with a period.","Web Search function tool always overrides other triggers if enabled and available.","Priority of triggers (if multiple are enabled):","Backticks.","Regular expressions.","Trigger phrases.","To discard all previous queries from processing, start the user message with an exclamation mark, for example, a user message !Now let's talk about... will discard this and every message above it.","This extension also provides a /websearch slash command to use in STscript. More info here: STscript Language Reference"]},{"i":"what-can-be-included-in-the-search-result","l":"What can be included in the search result?"},{"i":"serpapi-1","l":"SerpApi","p":["Answer box. Direct answer to the question.","Knowledge graph. Encyclopedic knowledge about the topic.","Page snippets (max 10). Relevant extracts from the web pages.","Relevant questions (max 10). Questions and answers to similar topics."]},{"l":"Selenium Plugin and Extras API","p":["Google - answer box, knowledge graph, page snippets.","DuckDuckGo - page snippets."]},{"i":"searxng-1","l":"SearXNG","p":["Infobox.","Page snippets."]},{"i":"tavily-ai-1","l":"Tavily AI","p":["Answer.","Page contents."]},{"i":"koboldcpp-1","l":"KoboldCpp","p":["Page titles.","Page snippets."]}],[{"l":"Extras","p":["The Extras project was discontinued in April 2024 and won't receive any new updates or modules. The vast majority of modules are available natively in the main SillyTavern application. You may still install and use it but don't expect to get immediate support if you face any issues."]}],[{"l":"Running Extras in Colab","p":["The Extras project was discontinued in April 2024 and won't receive any new updates or modules. The vast majority of modules are available natively in the main SillyTavern application. You may still install and use it but don't expect to get immediate support if you face any issues."]},{"l":"Instructions","p":["API key will appear in the colab's console output, for example: Your API key is fee2f3f559","Click \"Connect\"","Click the Start button on the left (looks like a triangle 'play' button)","Copy the API URL link that is listed under that line. ( DO NOT copy the 'localhost' URL, use the other one)","If you have enabled the secure option, paste the generated API key into the API Key box.","If you have NOT enabled the secure option, make sure the API Key box is completely empty when using the official colab.","It will start with the text Running on","Look for the trycloudflare.com link at the bottom of the output. Ignore the localhost link, it won't work (we tried!).","Navigate to SillyTavern's Extensions menu (click the 'stacked blocks' icon at the top of the page).","Not required, but recommended: select the secure option to generate the API key to protect your shared instance.","Open the Official Extras Colab","Paste the API URL into the box at the top. ( NOT the API Key box)","Select the desired \"Extra\" options","select use_cpu to run Extras without requiring GPU credit","Start SillyTavern with extensions support: (set enableExtensions to true in your config.yaml if necessary)","this will make Stable Diffusion slower, but everything else will run normally","Wait for it to finish loading everything"]}],[{"l":"Extras Installation","p":["This page contains instructions for installing SillyTavern Extras on your local device.","The Extras project was discontinued in April 2024 and won't receive any new updates or modules. The vast majority of modules are available natively in the main SillyTavern application. You may still install and use it but don't expect to get immediate support if you face any issues.","Local installation of Extras can be difficult or impossible on your OS (especially Termux)."]},{"l":"Use the Official Extras Colab","p":["Simple to setup","Free to use","No Colab GPU credits required (use the use_cpu options)","See the Colab Guide Page for details."]},{"l":"Installation Methods"},{"i":"miniconda-recommended","l":"MiniConda (recommended)","p":["(Chads who installed SillyTavern with git to begin with can skip this step!)","(Important!) Read how to use Conda","Activate the new environment","After you have both of them installed...","cd SillyTavern-extras","Clone the Extras GitHub repo","conda activate extras(you should see (extras) pop up on the left side of your command prompt)","conda create -n extras","conda install python=3.11 git","Create a new Conda environment (let's call it extras):","git clone https://github.com/SillyTavern/SillyTavern-extras","Install Extras' requirements by using one of the following commands (will take time, again):","Install git","Install Miniconda","Install the required system packages (this will take some time)","Navigate to your cloned Extras repo","pip install -r requirements-coqui.txt- for Coqui TTS (not recommended)","pip install -r requirements-rvc.txt- for real-time voice cloning","pip install -r requirements.txt- for basic features","See below 'Running Extras After Install'","See the Common Problems page if you get errors at this step!","This method is recommended because Conda makes a 'virtual environment' for the Extras requirement packages to live inside, so they do not affect your system-wide Python setup.","Type/paste the commands below ONE BY ONE IN THE CONDA COMMAND PROMPT WINDOW and hit Enter after each one."]},{"l":"System-Wide Installation","p":["This is easier, but will affect your system-wide Python installation.","This can cause conflicts if you work with many Python programs that have different requirements.","If this is your first time touching anything Python-related, that should not be a problem.","Install Python 3.11: https://www.python.org/downloads/release/python-3115/","Install git: https://git-scm.com/downloads","Open a command prompt window and go to a folder in which you have complete access permissions.","Clone the repo: git clone https://github.com/SillyTavern/SillyTavern-extras, hit Enter.","After the clone has finished, type cd SillyTavern-extras, hit Enter.","Type python -m pip install -r requirements.txt","See below 'Running Extras After Install'"]},{"l":"Running Extras After Install"},{"l":"Confirm extensions are enabled","p":["Open the file called config.yaml in a text editor. The file is located in ST's base install folder.","Look for the line that reads enableExtensions.","Make sure that line has true, and not false."]},{"l":"Decide which module to use","p":["(This only needs to be done once)","Below is a table that describes each module.","caption","chromadb","classify","Coqui TTS","coqui-tts","Decide which modules you want to add to your Python command line.","Description","edge-tts","Example: python server.py --enable-modules=caption,summarize,classify","Extras is always started with a Python command line.","Image captioning","Microsoft Edge TTS client","Name","NOTE: There must be no spaces at all in your Python command's module list!","python server.py is the bare minimum, but it does not enable any useful modules.","Real-time voice cloning","rvc","sd","Silero TTS server","silero-tts","Stable Diffusion image generation","summarize","Text sentiment classification","Text summarization","They will be used in the next step.","This would enable Image Captioning, Chat Summary, and live updating Character Expressions.","to enable modules you must use the --enable-modules= modifier, with a comma-separated list of module names","Vector storage server"]},{"l":"Start Extras Server","p":["While still in your command prompt window inside the Extras installation folder...","Make sure your conda environment is active (if you used the Conda install method)","Type activate extras if the environment is not active.","Type python server.py --enable-modules=YOUR,SELECTED,MODULE,LIST,HERE","The extras server will load.","After a while it will show you a URL at the end. For local installs, this defaults to http://localhost:5100.","Copy the API URL."]},{"l":"Connect ST to the Extras server","p":["Start your SillyTavern server, and view the SillyTavern interface in your browser.","Open the Extensions panel (via the 'Stacked Blocks' icon at the top of the page)","Paste the API URL into the input box.","Click Connect.","To run Extras again, simply activate the environment and run these commands in a command prompt.","conda activate extras, Hit Enter. python server.py, Hit Enter.","Be sure to the additional options for server.py (see below) that your setup requires."]},{"l":"Make a .bat File for Easy Startup","p":["This is Optional and only applies to Windows, but something similar should be possible on MacOS.","View your Windows Desktop","Right-click, select New, and then click Text Document","A new file will appear on your Desktop, asking for a name.","Name the file STExtras.txt","Open the newly created file in a text editor.","Paste the following code into it:","Replace the placeholder folder path with your actual Extras install folder path.","Replace the python command line with your actual command line","Save the file with a new name STExtras.bat(Use File>> Save As in most text editors)","You can now simply double-click on this .bat file to easily start Extras.","If you ever want to change the module list (or any other command line modifiers for the extras server), simply edit the python command inside the .bat file."]}],[{"l":"Extras Install Common Problems","p":["This page lists common questions and problems encountered while installing SillyTavern Extras.","Local installation of Extras can be difficult or impossible on your OS (especially Termux)."]},{"l":"Use the Official Extras Colab","p":["Simple to setup","Free to use","No Colab GPU credits required (use the use_cpu options)","See the Colab Guide Page for details."]},{"i":"error-could-not-import-the-talkinghead-module-on-linux","l":"Error: Could not import the 'talkinghead' module on Linux","p":["It requires the installation of an additional package because it's not installed automatically due to incompatibility with Colab. Run this after you install other requirements:","pip install wxpython"]},{"i":"extras-server-cant-connect-to-automatic1111s-stable-diffusion-web-ui","l":"Extras server can't connect to AUTOMATIC1111's Stable Diffusion Web UI","p":["Could not connect to remote SD backend at http://127.0.0.1:7860! Disabling SD module...","Make sure webui-user.bat that you start Stable Diffusion with contains --api command line option in the COMMANDLINE_ARGS variable.","Find and replace that line in your \"webui-user.bat\": set COMMANDLINE_ARGS=--api","How it shoud look","If the API mode is disabled for SD Web UI, the Extras server won't be able to make a connection and you won't be able to generate images!"]},{"i":"still-doesnt-work","l":"Still doesn't work?","p":["Ensure that you start everything in the proper order, waiting for every program to finish loading before proceeding to the next step:","Stable Diffusion Web UI","SillyTavern Extras","SillyTavern","The extras server can't reconnect to the Stable Diffusion API if it was loaded after."]},{"l":"hnswlib wheel building error when installing ChromaDB","p":["ERROR: Could not build wheels for hnswlib, which is required to install pyproject.toml-based projects","Before installing the ChromaDB module you must first do one of the following:","Install Visual C++ build tools: https://visualstudio.microsoft.com/visual-cpp-build-tools/","Install the hnswlib package with conda: conda install -c conda-forge hnswlib"]},{"l":"Error when installing Python requirements on Mac","p":["ERROR: No matching distribution found for torch== 2.0.0+cu117","Mac does not support CUDA, so torch packages should be installed without CUDA support.","Install the requirements using the requirements-silicon.txt file instead."]},{"i":"missing-modules","l":"Missing modules?","p":["You must specify a list of module names in your Python command line, with the --enable-modules modifier.","See Modules section."]},{"i":"what-is-the-api-key-box-for","l":"What is the API Key box for?","p":["The API Key box in SillyTavern's Extensions panel is only used when you have:","created a text file named api_key.txt in your Extras install folder, which contains your chosen Extras 'password'.","started extras with the --secure commandline argument.","This makes the Extras API 'password locked', so only users who have that key in their API Key box can access it.","This is mainly useful for people who want to make their own public deployment of Extras (colab, etc).","Users running Extras on their own PC for personal use should not type anything into the API Key box."]},{"i":"what-about-mobile-android-termux","l":"What about mobile/Android/Termux? \uD83E\uDD14","p":["There are some folks in the community having success running Extras on their phones via Ubuntu on Termux.","However, Extras were not made with mobile support in mind.","No support will be provided for people running Extras on their Android devices.","Direct all your questions to the creator of the guide linked below instead."]},{"i":"this-is-unsupported","l":"❗ This is UNSUPPORTED","p":["https://rentry.org/STAI-Termux#downloading-and-running-tai-extras"]}],[{"l":"Smart Context"},{"i":"this-extension-is-no-longer-maintained-and-not-recommended-to-use-consider-chat-vectorization-as-a-possible-alternative","l":"THIS EXTENSION IS NO LONGER MAINTAINED AND NOT RECOMMENDED TO USE. CONSIDER CHAT VECTORIZATION AS A POSSIBLE ALTERNATIVE.","p":["The use of this extension does not guarantee a better chatting experience or improved memory of any sort. Only use if you understand all the implications of vector database utilization."]},{"i":"what-is-it","l":"What is it?","p":["Smart Context is a SillyTavern extension that uses the ChromaDB library to give your AI characters access to information that exists outside the normal chat history context limit."]},{"i":"how-is-that-useful","l":"How is that useful?","p":["If you have a very long chat, the majority of the contents are outside the usual context window and thus unavailable to the AI when it comes to writing a response.","Smart Context automatically takes the entire history of the chat file and puts it into a vector database. This database is then searched each time you input something new into the chat, and if messages with matching keywords are found, those chat messages are placed into the context so the AI can see them when writing its next reply."]},{"l":"Setup Instructions","p":["Update SillyTavern to at least version 1.10.6.","Install the \"Smart Context\" extension from the \"Download Extensions & Assets\" menu in the Extensions panel (stacked blocks icon).","Install or Update Extras to the latest version. Alternatively, use the Colab notebook.","Local installs only: Install requirements-complete.txt for Extras (even if you did it once before in a prior install).","Run Extras with the chromadb module enabled: python server.py --enable-modules=chromadb"]},{"i":"getting-an-error-when-installing-chromadb","l":"Getting an error when installing ChromaDB?","p":["Installing chromadb package requires one of the following:","Have Visual C++ build tools installed: https://visualstudio.microsoft.com/visual-cpp-build-tools/","Installing hnswlib from conda: conda install -c conda-forge hnswlib"]},{"l":"Configuration","p":["Once Smart Context is enabled, you should configure it in the SillyTavern UI. Smart Context configuration can be done from within the Extensions menu STExtensionMenuIcon","Smart Context Config Panel","There are 4 main concepts to be aware of:","Chat History Preservation","Memory Injection Amount","Individual Memory Length","Injection Strategy"]},{"l":"SmartContext only starts after 10 mesages are in the chat history","p":["At the start of a new chat, ChromaDB is inactive.","Once the chat has accumulated 10 messages, it will begin recording all messages into the database, and recalling messages as needed."]},{"i":"chat-history-preservation-kept-mesages","l":"Chat History Preservation ('kept mesages')","p":["By default, ChromaDB will keep as many recent natural chat history messages as specified in the slider. Any messages beyond this amount will be removed from your sent prompt, and if 'memories' exist in the database they will be added in place of the older chat history messages (see Strategy below)."]},{"l":"Memory Injection Amount","p":["The maximum number of 'memories' Smart Context will insert into the context. Not every injection attempt will get this full amount. If you send an input related to 'dogs' and only one other message in the DB is related to dogs, then only 1 item will be inserted."]},{"l":"Individual Memory Length","p":["This is the maximum length allowed for each injected 'memory'. This is in CHARACTERS(not tokens). If set too small, the memory could be cut off midway.","Example:","Ross: I like dogs with long fur and fluffy tails. I dislike dogs with short fur and short tails.","This database 'memory' is 103 characters long, so you would need to set the slider to at least 103 in order to pull it entirely into the context.","If the slider is less than 103, the message would be cut off and injected like that."]},{"l":"Injection Strategy"},{"l":"Replace oldest history","p":["This strategy keeps X recent messages, removes all message before that, and replaces them with 'memories'.","Advantage","less likely to overflow your context limit","memories existing near the top of the context will have less immediate impact on the response while still providing 'background information'.","Disadvantage","old messages are inserted directly into the chat history with no special demarcation, and usually have no immediate natural relevance to the preserved natural chat history messages. This can confuse less intelligent AI models."]},{"l":"Add to Bottom","p":["This strategy leaves the chat history in its natural state and adds 'memories' after it inside a formatted [bracket header]. This means the 'kept messages' sliders is effectively disabled.","Advantage","does not shorten or alter the current natural chat history","'memories' exist after chat and have a stronger impact on the next AI response","Disadvantage","because no chat items are being removed/replaced, there is a higher chance you will overflow your context limit.","because the memories exist very close to the end of the prompt they can have TOO MUCH effect on the AI's response."]},{"l":"Custom Depth","p":["This strategy leaves the chat history in its natural state and adds 'memories' at the depth you determine within the template you specify. This means the 'kept messages' slider is effectively disabled. The custom injection message should include the `` template word which is where all queried memories will be placed.","Advantage","flexibility to experiment with memory placement","customizable introductions to memory within context","Disadvantage","because no chat items are being removed/replaced, there is a higher chance you will overflow your context limit."]},{"i":"use--strategy","l":"Use % Strategy","p":["Note: This is not compatible with the 'Add to Bottom' strategy, which does not remove any messages at all.","While using the 'Replace Oldest History' strategy, checking this box will enable the slider for selecting a percentage of the in-context chat history to replace with SmartContext memories. It will also disable the two sliders for manually selecting the number of messages.","This strategy automatically calculates a percentage of the chat history to be replaced with SmartContext memories, instead of a fixed number of messages.","Advantage","easier than manually calculating the number of messages yourself","adjusts with the available context size, applying the same percentage to small and large prompt spaces","Disadvantage","calculations for how much history to remove can be slightly innacurate as they are based on estimated tokens per message","it rounds the number of messages to remove to the nearest number divisible by 5 (0, 5, 10, 15, 20, etc), so it is not as fine grained as manual numeric selection."]},{"l":"Memory Recall Strategy"},{"l":"Recall only from this chat","p":["This is the default behavior of smart-context and pulls 'memories' only from the ChromaDB collection for this specific chat."]},{"l":"Recall from all character chats","p":["This is an experimental behavior of smart-context which pulls 'memories' from all ChromaDB collections for the selected character. Hypothetically this should allow for the development of a more robust memory set spanning many interactions. Reccomended that this be used with 'Add to Bottom' or 'Custom Depth' strategies and 'kept messages' set to a low number so that ChromaDB will pull from memory sooner."]},{"l":"Using Smart Context","p":["Once it is enabled and configured, Smart Context happens automatically.","ChromaDB makes a new database for each chat that is opened inside SillyTavern. This database is automatically filled with the entire chat history.","You can also manually insert text files into the database.","These text files do not have to be chats. They can be anything (wikipedia entries, fanfic, etc)."]},{"l":"Purging the Database","p":["You can use the 'Purge DB' button to clear the database for the current chat.","This can be helpful if you find inaccurate memories have been stored (such as chat message you have since deleted or edited)."]},{"l":"FAQ"},{"i":"what-happens-to-the-databases-when-im-done-chatting-can-i-save-them","l":"What happens to the databases when I'm done chatting? Can I save them?","p":["For locally installed Extras servers, Smart Context saves the databases. There is no need to save them manually in usual use cases.","For colab users, the databases are wiped when the extras server shuts down. Use the export button to save the database as a JSON file, and import it next time you want to use it.","Usually there is no need to save Smart Context databases.","Currently we have an Import/Export feature, which allows you to save the chat's DB and use it again at a later date."]},{"i":"can-i-make-one-big-database-for-all-of-my-chats-to-reference","l":"Can I make one big database for all of my chats to reference?","p":["This would not be a good use of Smart Context's capabilities. We recommend using World Info for this purpose."]}],[{"l":"talkinghead"},{"i":"what-is-it","l":"What is it?","p":["An implementation of Talking Head Anime 3 Demo for AITuber. It possesses the following features:","Generates random Live 2D-like motion actions from a single static image.","Lip-syncs to the sound output from any TTS output.","This extension contains the original demo programs for the Talking Head(?) Anime from a Single Image 3: Now the Body Too project. As the name implies, the project allows you to animate anime characters, and you only need a single image of that character to do so. There are two demo programs:","The manual_poser lets you manipulate a character's facial expression, head rotation, body rotation, and chest expansion due to breathing through a graphical user interface, so you can save them as default expressions IE Happy, sad, joy, etc. ifacialmocap_puppeteer lets you transfer your facial motion to an anime character."]},{"l":"Hardware Requirements","p":["You can use either CPU or GPU Modes (CPU is default). However, in CPU mode expect about 1 FPS, and in GPU mode on an RTX3060 I am getting about 9-10 FPS.","The ifacialmocap_puppeteer requires an iOS device that is capable of computing blend shape parameters from a video feed. This means that the device must be able to run iOS 11.0 or higher and must have a TrueDepth front-facing camera. (See this page for more info.) In other words, if you have the iPhone X or something better, you should be all set."]},{"l":"How to use","p":["You must launch extras with the following modules for talkinghead to work: classify and talkinghead! classify is required for the handling of the talkinghead.png file. Additionally, you may also use --talkinghead-gpu to load the blend models into GPU memory and make the animations 10x faster. It is highly recommended to use GPU acceleration! By default, once the program starts it will load a default image SillyTavern-extras\\talkinghead\\tha3\\images\\lambda_00.png. You can verify it is working by going to http://localhost:5100/api/talkinghead/result_feed or YOUR EXT URL:PORT/api/talkinghead/result_feed.","Once the server has started go to the Extension API tab and connect. Then simply select a character card to load. (--enable-modules=classify,talkinghead --talkinghead-gpu when starting server.py)","Now select the Character Expressions, if you check the image type talkinghead box the script will replace your current character expression with the result of YOUR EXT URL:PORT/api/talkinghead/result_feed unchecking the box SHOULD return the image back to the original expression, however sometimes you have to send a new message to the chat to \"reload\" the image.","If you do not have a talkinghead.png file in the character directory it will simply show either the default image or the last character card that had a talkinghead.png file. The animation source image is changed when the character card is changed.","Now open the character expressions scroll down to the talkinghead image and upload an image file that meets the requirements in the section below called \"Constraints on Input Images\".","Then check and uncheck the talkinghead box to reload the character. If the image is funny looking it is probably because it is not transparent / has no alpha layer. Otherwise, follow the instructions and template below."]},{"l":"Constraints on Input Images","p":["In order for the system to work well, the input image must obey the following constraints:","It should be of resolution 512 x 512. (If the program receives an input image of any other size, it will resize the image to this resolution and also output at this resolution.) It must have an alpha channel. It must contain only one humanoid character. The character should be standing upright and facing forward. The character's hands should be below and far from the head. The head of the character should roughly be contained in the 128 x 128 box in the middle of the top half of the image. The alpha channels of all pixels that do not belong to the character (i.e., background pixels) must be 0.","Input Constraints"]},{"l":"ADVANCED SECTION"},{"l":"Python Environment","p":["In addition to the base feature (app.py), both manual_poser and ifacialmocap_puppeteer are available as desktop applications. To run them, you need to set up an environment for running programs written in the Python language. The environment needs to have the following software packages:","Python >= 3.8","PyTorch >= 1.11.0 with CUDA support","SciPY >= 1.7.3","wxPython >= 4.1.1","Matplotlib >= 3.5.1","One way to do so is to install Anaconda and run the following commands in your shell:","conda create -n talking-head-anime-3-demo python=3.8 conda activate talking-head-anime-3-demo conda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorch conda install scipy pip install wxpython conda install matplotlib"]},{"l":"Additional Blend Models","p":["There is only one (lightest) model included, if you want the additional blend models you need to download the model files from https://www.dropbox.com/s/y7b8jl4n2euv8xe/talking-head-anime-3-models.zip?dl=0 and unzip it to the SillyTavern-extras\\talkinghead\\tha3\\models folder. In the end, the data folder should look like:","tha3","models","separable_float","editor.pt","eyebrow_decomposer.pt","eyebrow_morphing_combiner.pt","face_morpher.pt","two_algo_face_body_rotator.pt","separable_half","editor.pt:","standard_float","standard_half","The model files are distributed with the Creative Commons Attribution 4.0 International License, which means that you can use them for commercial purposes. However, Pramook Khungurn. Talking Head(?) Anime from a Single Image 3: Now the Body Too. https://github.com/pkhungurn/talking-head-anime-3-demo, is the creator."]},{"l":"Running the manual_poser Desktop Application","p":["Open a shell. Change your working directory to the repository's root directory. Then, run:","python tha3/app/manual_poser.py Note that before running the command above, you might have to activate the Python environment that contains the required packages.","conda activate extras if you have not already activated the environment."]}],[{"l":"Development and Automation","p":["SillyTavern's default package only provides a barebones platform that can be extended in a multitude of ways.","STscript","STscript is a powerful scripting language based on batched chat commands that can be approached without any prior coding knowledge.","Function Calling","Add more dynamic capabilities by letting the LLM use external sources of data or trigger specific functionality of the extension.","UI Extensions","UI extensions run in a browser environment and expand the functionality of SillyTavern by hooking into its events and API.","Server Plugins","Server plugins allow adding functionality such as new API endpoints by running code in the NodeJS environment.","Internationalization (i18n)","Learn how to translate SillTavern's UI into your language."]}],[{"l":"STscript Language Reference"},{"i":"what-is-stscript","l":"What is STscript?","p":["It's a simple yet powerful scripting language that could be used to expand the functionality of SillyTavern without serious coding, allowing you to:","Create mini-games or speed run challenges","Build AI-powered chat insights","Unleash your creativity and share with others","STscript is built using the slash commands engine, utilizing command batching, data piping, macros, and variables. These concepts are going to be described in the following document."]},{"l":"Security precaution","p":["With great power comes great responsibility. Be careful and always inspect the scripts before executing them."]},{"i":"hello-world","l":"Hello, World!","p":["To run your first script, open any SillyTavern chat and type the following into the chat input bar:","Hello World","You should see the message in the toast on top of the screen. Now let's break it down bit by bit.","A script is a batch of commands, each one starting with the slash, with or without named and unnamed arguments, and terminated with the command separator character: |.","Commands are executed sequentially, one after another, and transfer data between each other.","The /pass command accepts a constant value of \"Hello, World!\" as an unnamed argument and writes it to the pipe.","The /echo command receives the value through the pipe from the previous command and displays it as a toast notification.","Hint: To see a list of all available commands, type /help slash into the chat.","As constant unnamed arguments and pipes are interchangeable, we could rewrite this script simply as:"]},{"l":"User input","p":["Now let's add a little bit of interactivity to the script. We will accept the input value from the user and display it in the notification.","The /input command is used to display an input box with the prompt specified in the unnamed argument and then writes the output to the pipe.","Because /echo already has an unnamed argument that sets the template for the output, we use the {{pipe}} macro to specify a place where the pipe value will be rendered.","Slim Shady Input","Slim Shady Output"]},{"i":"other-inputoutput-commands","l":"Other input/output commands","p":["/popup (text)— shows a blocking popup, supports lite HTML formatting, e.g: /popup font color=redI'm red!/font.","/setinput (text)— replaces the contents of the user input bar with the provided text.","/speak voice=name (text)— narrates the text using the selected TTS engine and the character name from the voice map, e.g. /speak name=Donald Duck Quack!.","/buttons labels=[a,b] (text)— shows a blocking popup with the specified text and button labels. labels must be a JSON-serialized array of strings or a variable name containing such an array. Returns the clicked button label into the pipe or empty string if canceled. The text supports lite HTML formatting."]},{"i":"arguments-for-popup-and-input","l":"Arguments for /popup and /input","p":["/popup and /input support the following additional named arguments:","large=on/off- increases the vertical size of the popup. Default: off.","wide=on/off- increases the horizontal size of the popup. Default: off.","okButton=string- adds ability to customize the text on the \"Ok\" button. Default: Ok.","rows=number- (only for /input) increases the size of the input control. Default: 1.","Example:"]},{"i":"arguments-for-echo","l":"Arguments for /echo","p":["/echo supports the following values for the additional severity argument that sets the style of the displayed message.","warning","error","info(default)","success","Example:"]},{"l":"Variables","p":["/addglobalvar key=name or {{addglobalvar::name:increment}}— adds the increment to the value of the global variable.","/addvar key=name increment or {{addvar::name::increment}}— adds the increment to the value of the local variable.","/decglobalvar name or {{decglobalvar::name}}— decrements a value of the global variable by 1.","/decvar name or {{decvar::name}}— decrements a value of the local variable by 1.","/flushglobalvar name— deletes the value of the global variable.","/flushvar name— deletes the value of the local variable.","/getglobalvar name or {{getglobalvar::name}}— gets the value of the global variable.","/getvar name or {{getvar::name}}— gets the value of the local variable.","/incglobalvar name or {{incglobalvar::name}}— increments a value of the global variable by 1.","/incvar name or {{incvar::name}}— increments a value of the local variable by 1.","/setglobalvar key=name or {{setglobalvar::name::value}}— sets the value of the global variable.","/setvar key=name value or {{setvar::name::value}}— sets the value of the local variable.","All slash commands for variable manipulation write the resulting value into the pipe for the next command to use.","For macros, only the \"get\", \"inc\", and \"dec\" type macro returns the value, \"add\" and \"set\" are replaced with an empty string instead.","Global variables — saved to the settings.json and exist everywhere across the app.","If a command argument accepts a variable name and both local and global variables exist with the same name, then the local variable takes priority.","Increment in the /addvar command performs an addition or subtraction of the value if both increment and the variable value can be converted to a number, or otherwise does the string concatenation.","Local variables — saved to the metadata of the current chat, and unique to it.","Now, let's consider the following example:","Since the variables are saved and not flushed between the script executions, you can reference the variable in other scripts and via macros, and it will resolve to the same value as during the execution of the example script. To guarantee that the value will be discarded, add the /flushvar command to the script.","The default value of previously undefined variables is an empty string or a zero of it is first used in the /addvar, /incvar, /decvar command.","The getvar command is used to retrieve the value of the variable and pass it through the pipe.","The getvar macro is used to display the value in the /echo command.","The value is passed to the /imagine command (provided by the Image Generation plugin) to be used as its input prompt.","The value of the user input is saved in the local variable named SDinput.","Variables are used to store and manipulate data in scripts, using either commands or macros. The variables could be one of the following types:"]},{"l":"Arrays and objects","p":["Variable values can contain JSON-serialized arrays or key-value pairs (objects).","Examples:","Array: [apple,banana,orange]","Object: {fruits:[apple,banana,orange]}","The following modifications can be applied to commands to work with these variables:","/len commands gets a number of items in the array.","index=number/string named argument can be added /getvar or /setvar and their global counterparts to get or set sub-values by either a zero-based index for arrays or a string key for objects.","If a numeric index is used on a nonexistent variable, the variable will be created as an empty array [].","If a string index is used on a nonexistent variable, the variable will be created as an empty object {}.","/addvar and /addglobalvar commands support pushing a new value to array-typed variables."]},{"i":"flow-control---conditionals","l":"Flow control - conditionals","p":["You can use the /if command to create conditional expressions that branch the execution based on the defined rules.","/if left=valueA right=valueB rule=comparison else=(command on false) (command on true)","Let's review the following example:","This script evaluates the user input against a required value and displays different messages, depending on the input value."]},{"i":"arguments-for-if","l":"Arguments for /if","p":["left is the first operand. Let's call it A.","right is the second operand. Let's call it B.","rule is the operation to be applied to the operands.","else is the optional string of subcommands to be executed if the result of boolean comparison is false.","Unnamed argument is the subcommand to be executed if the result of boolean comparison is true.","The operand values are evaluated in the following order:","Numeric literals","Local variable names","Global variable names","String literals","String values of named arguments could be escaped with quotes to allow multi-word strings. Quotes are then discarded."]},{"l":"Boolean operations","p":["Supported rules for boolean comparison are the following. An operation applied to the operands results in either a true or false value.","eq(equals) => A = B","neq(not equals) => A != B","lt(less than) => A < B","gt(greater than) => A > B","lte(less than or equals) => A <= B","gte(greater than or equals) => A >= B","not(unary negation) => !A","in(includes substring) => A includes B, case insensitive","nin(not includes substring) => A not includes B, case insensitive"]},{"l":"Subcommands","p":["A subcommand is a string containing a list of slash commands to execute.","To use command batching in subcommands, the command separator character should be escaped (see below).","Since macro values are executed when the conditional is entered, not when the subcommand is executed, a macro could be additionally escaped to delay their evaluation to the subcommand execution time.","The result of the subcommands execution is piped to the command after /if.","The /abort command interrupts the script execution when encountered.","/if commands can be used as a ternary operator. The following example will pass a \"true\" string to the next command the variable a equals 5, and a \"false\" string otherwise."]},{"l":"Escape Sequences"},{"l":"Macros","p":["Escaping of macros works just like before. However, with closures, you will need to escape macros a lot less often than before. Either escape the two opening curly braces, or both the opening and closing pair."]},{"l":"Pipes","p":["Pipes don't need to be escaped in closures (when used as command separators). Everywhere where you want to use a literal pipe character instead of a command separator, you need to escape it.","With the parser flag STRICT_ESCAPING you don't need to escape pipes in quoted values."]},{"l":"Quotes","p":["To use a literal quote-character inside a quoted value, the character must be escaped."]},{"l":"Spaces","p":["To use space in the value of a named argument, you either have to surround the value in quote, or escape the space character."]},{"l":"Closure Delimiters","p":["If you want to use the character combinations used to mark the beginning or end of a closure, you have to escape the sequence with a single backslash."]},{"l":"Pipe Breakers","p":["To prevent the previous command's output from being automatically injected as the unnamed argument into the next command, put double pipes between the two commands."]},{"l":"Closures","p":["Closures (block statements, lambdas, anonymous functions, whatever you want to call them) are a series of commands wrapped between {: and :}, that are only evaluated once that part of the code is executed."]},{"l":"Sub-Commands","p":["Closures make using sub-commands a lot easier and get rid of the need to escape pipes and macros."]},{"l":"Scopes","p":["Closures have their own scope and support scoped variables. Scoped variables are declared with /let, their values set and retrieved with /var. Another way to get a scoped variable is the {{var::}} macro.","Within a closure, you have access to all variables declared within that same closure or in one of its ancestors. You don't have access to variables declared in a closure's descendants. If a variable is declared with the same name as a variable that was declared in one of the closure's ancestors, you don't have access to the ancestor variable in this closure and its descendants."]},{"l":"Named Closures","p":["Closures can be assigned to variables (only scoped variables) to be called at a later point or to be used as sub-commands.","/: can also be used to execute Quick Replies, as it is just a shorthand for /run."]},{"l":"Closure Arguments","p":["Named closures can take named arguments, just like slash commands. The arguments can have default values."]},{"l":"Closures and Piped Arguments","p":["The piped value from a parent closure will not be automatically injected into the first command of a child closure. You can still explicitly reference the parent's piped value with {{pipe}}, but if you leave the unnamed argument of the first command inside a closure blank, the value will not be automatically injected."]},{"l":"Immediately Executed Closures","p":["Closures can be immediately executed, meaning they will be replaced with their return value. This is helpful in places where no explicit support for closures exists, and to shorten some commands that would otherwise require a lot of intermediate variables.","In addition to running named closures saved inside scoped variables, the /run command can also be used to execute closures immediately."]},{"l":"Comments","p":["A comment is a human-readable explanation or annotation in the script code. Comments don't break pipes."]},{"l":"Block Comments","p":["Block comments can be used to quickly comment out multiple commands at once. They will not terminate on a pipe."]},{"l":"Flow Control"},{"i":"loops-while-and-times","l":"Loops: /while and /times","p":["If you need to run some command in a loop until a certain condition is met, use the /while command.","On each step of the loop it compares the value of variable A with the value of variable B, and if the condition yields true, then executes any valid slash command enclosed in quotes, otherwise exists the loop. This command doesn't write anything to the output pipe."]},{"i":"arguments-for-while","l":"Arguments for /while","p":["The set of available boolean comparisons, handing of variables, literal values, and subcommands is the same as for the /if command.","The optional guard named argument ( on by default) is used to protect against endless loops, limiting the number of iterations to 100. To disable and allow endless loops, set guard=off.","This example adds 1 to the value of i until it reaches 10, then outputs the resulting value (10 in this case)."]},{"i":"arguments-for-times","l":"Arguments for /times","p":["Runs a subcommand a specified number of times.","/times (repeats) (command)– any valid slash command enclosed in quotes repeats a number of times, e.g. /setvar key=i 1 | /times 5 /addvar key=i 1 adds 1 to the value of \"i\" 5 times.","{{timesIndex}} is replaced with the iteration number (zero-based), e.g. /times 4 /echo {{timesIndex}} echoes the numbers 0 through 4.","Loops are limited to 100 iterations by default, pass guard=off to disable."]},{"l":"Breaking out of Loops and Closures","p":["The /break command can be used to break out of a loop (/while or /times) or a closure early. The unnamed argument of /break can be used to pass a value different from the current pipe along./break is currently implemented in the following commands:","/while- exits the loop early","/times- exits the loop early","/run(with a closure or closure via variable) - exits the closure early","/:(with a closure) - exits the closure early"]},{"l":"Math operations","p":["/abs (a)– performs an absolute value operation of a value, e.g. /abs -10","/add (a b c d)– performs an addition of the set of values, e.g. /add 10 i 30 j","/cos (a)– performs a cosine operation of a value, e.g. /cos i","/div (a b)– performs a division of two values, e.g. /div 10 i","/log (a)– performs a natural logarithm operation of a value, e.g. /log i","/max (a b c d)– returns a maximum from the set of values, e.g. /max 1 0 4 k","/min (a b c d)– return a minimum from the set of values, e.g. /min 5 4 i 2","/mod (a b)– performs a modulo operation of two values, e.g. /mod i 2","/mul (a b c d)– performs a multiplication of the set of values, e.g. /mul 10 i 30 j","/pow (a b)– performs a power operation of two values, e.g. /pow i 2","/rand (round=round|ceil|floor from=number=0 to=number=1)– returns a random number between from and to, e.g. /rand or /rand 10 or /rand from=5 to=10. Ranges are inclusive. The returned value will contain a fractional part. Use round named argument to get an integral value, e.g. /rand round=ceil to round up, round=floor to round down, and round=round to round to nearest.","/round (a)– performs a rounding to the nearest integer operation of a value, e.g. /round 3.14","/sin (a)– performs a sine operation of a value, e.g. /sin i","/sqrt (a)– performs a square root operation of a value, e.g. /sqrt 9","/sub (a b)– performs a subtraction of two values, e.g. /sub i 5","All of the following operations accept a series of numbers or variable names and output the result to the pipe.","Invalid operations (such as division by zero), and operations that result in a NaN value or infinity return zero.","List of operations:","Multiplication, addition, minimum and maximum accept an unlimited number of arguments separated by spaces.","Sine, cosine, natural logarithm, square root, absolute value, and rounding accept one argument.","Subtraction, division, exponentiation, and modulo accept two arguments separated by spaces."]},{"i":"example-1-get-an-area-of-a-circle-with-a-radius-of-50","l":"Example 1: get an area of a circle with a radius of 50."},{"i":"example-2-calculate-a-factorial-of-5","l":"Example 2: calculate a factorial of 5."},{"l":"Using the LLM","p":["Scripts can make requests to your currently connected LLM API using the following commands:","/gen (prompt)— generates text using the provided prompt for the selected character and including chat messages.","/genraw (prompt)— generates text using just the provided prompt, ignoring the current character and chat.","/trigger— triggers a normal generation (equivalent to clicking a \"Send\" button). If in group chat, you can optionally provide a 1-based group member index or a character name to have them reply, otherwise triggers a group round according to the group settings."]},{"i":"arguments-for-gen-and-genraw","l":"Arguments for /gen and /genraw","p":["lock— can be on or off. Specifies whether a user input should be blocked while the generation is in progress. Default: off.","stop— JSON-serialized array of strings. Adds a custom stop string (if the API supports it) just for this generation. Default: none.","instruct(only /genraw) — can be on or off. Allows to use instruct formatting on the input prompt (if instruct mode is enabled and the API supports it). Set to off to force pure prompts. Default: on.","as(for Text Completion APIs) — can be system(default) or char. Defines how the last prompt line will be formatted. char will use a character name, system will use no or neutral name.","The generated text is then passed through the pipe to the next command and can be saved to a variable or displaced using the I/O capabilities:","Cthulhu Says"]},{"l":"Prompt injections","p":["Scripts can add custom LLM prompt injections, making it essentially an equivalent of unlimited Author's Notes.","/inject (text)— inserts any text into the normal LLM prompt for the current chat, and requires a unique identifier. Saved to chat metadata.","/listinjects— shows a list of all prompt injections added by scripts for the current chat in a system message.","/flushinjects— deletes all prompt injections added by scripts for the current chat.","/note (text)— sets the Author's Note value for the current chat. Saved to chat metadata.","/interval— sets the Author's Note insertion interval for the current chat.","/depth— sets the Author's Note insertion depth for the in-chat position.","/position— sets the Author's Note position for the current chat."]},{"i":"arguments-for-inject","l":"Arguments for /inject","p":["id— an identifier string or a reference to a variable. Consequent calls of /inject with the same ID will overwrite the previous text injection. Required argument.","position— sets a position for the injection. Default: after. Possible values:","after: after the main prompt.","before: before main prompt.","chat: in-chat.","depth— sets an injection depth for the in-chat position. 0 means insertion after the last message, 1 - before the last message, etc. Default: 4.","Unnamed argument is a text to be injected. An empty string will unset the previous value for the provided identifier."]},{"l":"Access chat messages"},{"l":"Read messages","p":["You can access messages in the currently selected chat using the /messages command.","The names argument is used to specify whether you want to include character names or not, default: on.","In an unnamed argument, it accepts a message index or range in the start-finish format. Ranges are inclusive!","If the range is unsatisfiable, i.e. an invalid index or more messages than exist are requested, then an empty string is returned.","Messages that are hidden from the prompt (denoted by the ghost icon) are excluded from the output.","If you want to know the index of the latest message, use the {{lastMessageId}} macro, and {{lastMessage}} will get you the message itself.","To calculate the start index for a range, for example, when you need to get the last N messages, use variable subtraction. This example will get you 3 last messages in the chat:"]},{"l":"Send messages","p":["A script can send messages as either a user, character, persona, neutral narrator, or add comments.","/send (text)— adds a message as the currently selected persona.","/sendas name=charname (text)— adds a message as any character, matching by their name. name argument is required. Use the {{char}} macro to send as the current character.","/sys (text)— adds a message from the neutral narrator that doesn't belong to the user or character. The displayed name is purely cosmetic and can be customized with the /sysname command.","/comment (text)— adds a hidden comment that is displayed in the chat but is not visible to the prompt.","/addswipe (text)— adds a swipe to the last character message. Can't add a swipe to the user or hidden messages.","/hide (message id or range)— hides one or several messages from the prompt based on the provided message index or inclusive range in the start-finish format.","/unhide (message id or range)— returns one or several messages to the prompt based on the provided message index or inclusive range in the start-finish format.","/send, /sendas, /sys, and /comment commands optionally accept a named argument at with a zero-based numeric value (or a variable name that contains such a value) that specifies an exact position of message insertion. By default new messages are inserted at the end of the chat log.","This will insert a user message at the beginning of the conversation history:"]},{"l":"Delete messages","p":["These commands are potentially destructive and have no \"undo\" function. Check the /backups/ folder if you accidentally deleted something important.","/cut (message id or range)— cuts one or several messages from the chat based on the provided message index or inclusive range in the start-finish format.","/del (number)— deletes last N messages from the chat.","/delswipe (1-based swipe id)— deletes a swipe from the last character message based on the provided 1-based swipe ID.","/delname (character name)— deletes all messages in the current chat that belong to a character with the specified name.","/delchat— deletes the current chat."]},{"l":"World Info commands","p":["World Info (also known as Lorebook) is a highly utilitarian tool for dynamically inserting data into the prompt. See the dedicated page for more detailed explanation: World Info.","/getchatbook– gets a name of the chat-bound World Info file or create a new one if was unbound, and pass it down the pipe.","/findentry file=bookName field=fieldName [text]– finds a UID of the record from the specified file (or a variable pointing to a file name) using fuzzy matching of a field value with the provided text (default field: key) and passes the UID down the pipe, e.g. /findentry file=chatLore field=key Shadowfang.","/getentryfield file=bookName field=field [UID]– gets a field value (default field: content) of the record with the UID from the specified World Info file (or a variable pointing to a file name) and passes the value down the pipe, e.g. /getentryfield file=chatLore field=content 123.","/setentryfield file=bookName uid=UID field=field [text]– sets a field value (default field: content) of the record with the UID (or a variable pointing to UID) from the specified World Info file (or a variable pointing to a file name). To set multiple values for key fields, use a comma-delimited list as a text value, e.g. /setentryfield file=chatLore uid=123 field=key Shadowfang,sword,weapon.","/createentry file=bookName key=keyValue [content text]– creates a new record in the specified file (or a variable pointing to a file name) with the key and content (both of these arguments are optional) and passes the UID down the pipe, e.g. /createentry file=chatLore key=Shadowfang The sword of the king."]},{"l":"Valid entry fields","p":["(see below)","0 = AND ANY","0 = before main prompt","0 = System","1 = after main prompt","1 = NOT ALL","1 = User","2 = Assistant","2 = NOT ANY","2 = top of Author's Note","3 = AND ALL","3 = bottom of Author's Note","4 = in-chat at depth","5 = top of example messages","6 = bottom of example messages","Boolean (1/0)","Case-Sensitive","caseSensitive","comment","constant","Constant Status","content","depth","Depth Role","disable","Disabled Status","excludeRecursion","Field","key","keysecondary","List of strings","Logic","Logic values","Match Whole Words","matchWholeWords","Non-recursable","Number","Number (0-100)","Number (0-999)","Optional Filter","order","position","Position values","Primary Keywords","probability","role","Role values(Position = 4 only)","Scan Depth","scanDepth","selectiveLogic","String","Title / Memo","Trigger%","UI element","Value type"]},{"i":"example-1-read-a-content-from-the-chat-lorebook-by-key","l":"Example 1: Read a content from the chat lorebook by key"},{"i":"example-2-create-a-chat-lorebook-entry-with-key-and-content","l":"Example 2: Create a chat lorebook entry with key and content"},{"i":"example-3-expand-an-existing-lorebook-entry-with-new-information-from-the-chat","l":"Example 3: Expand an existing lorebook entry with new information from the chat"},{"l":"Text manipulation","p":["There's a variety of useful text manipulation utility commands to be used in various script scenarios.","/trimtokens— trims the input to the specified number of text tokens from the start or from the end and outputs the result to the pipe.","/trimstart— trims the input to the start of the first complete sentence and outputs the result to the pipe.","/trimend— trims the input to the end of the last complete sentence and outputs the result to the pipe.","/fuzzy— performs fuzzy matching of the input text to the list of strings, outputting the best string match to the pipe.","/regex name=scriptName [text]— executes a regex script from the Regex extension for the specified text. The script must be enabled."]},{"i":"arguments-for-trimtokens","l":"Arguments for /trimtokens","p":["direction sets the direction for trimming, which can be either start or end. Default: end.","limit sets the amount of tokens to left in the output. Can also specify a variable name containing the number. Required argument.","Unnamed argument is the input text to be trimmed."]},{"i":"arguments-for-fuzzy","l":"Arguments for /fuzzy","p":["list is a JSON-serialized array of strings containing the candidates. Can also specify a variable name containing the list. Required argument.","Unnamed argument is the input text to be matched. Output is one of the candidates matching the input most closely."]},{"l":"Autocomplete","p":["Autocomplete is enabled both on the chat input, and the large Quick Reply editor.","Autocomplete works anywhere in your input. Even with multiple piped commands and nested closures.","Autocomplete supports three ways of looking up matching commands ( User Settings-> STscript Matching).","Starts with The \"old\" way. Only commands that begin exactly with the typed value will show up.","Includes All commands that include the type value will show up. Example: When entering /delete, the commands /qr-delete and /qr-set-delete will show up in the autocomplete list (/qr- delete, /qr-set- delete).","Fuzzy All commands that can be fuzzy-matched against the typed value will show up. Example: When entering /seas, the command /sendas will show up in the autocomplete list (/ se nd as).","Command arguments are supported by autocomplete as well. The list will show up for required arguments automatically. For optional arguments, press Ctrl+ Space to open the list of available options.","When entering /: to execute a closure or QR, autocomplete will show a list of scoped variables and QRs.","Autocomplete has limited support for macros (in slash commands). Type {{ to get a list of available macros.","Use the up and down arrow keys to select an option from the list of autocomplete options.","Press Enter or Tab or click on an option to place the option at the cursor.","Press Escape to close the autocomplete list.","Press Ctrl+ Space to open the autocomplete list or toggle the selected option's details."]},{"l":"Parser Flags","p":["The parser accepts flags to modify its behavior. These flags can be toggled on and off at any point in a script and all following input will be evaluated accordingly. You can set your default flags in user settings."]},{"l":"Strict Escaping","p":["Changes with STRICT_ESCAPING enabled are as follows."]},{"i":"pipes-1","l":"Pipes","p":["Pipes don't need to be escaped in quoted values."]},{"l":"Backslashes","p":["A backslash in front of a symbol can be escaped to provide the literal backslash followed by the functional symbol."]},{"l":"Replace Variable Macros","p":["This flag helps to avoid double-substitutions when the variable values contain text that could be interpreted as macros. The {{var::}} macros get substituted last and no further substitutions happen on the resulting text / variable value.","Replaces all {{getvar::}} and {{getglobalvar::}} macros with {{var::}}. Behind the scenes, the parser will insert a series of command executors before the command with the replaced macros:","call /let to save the current {{pipe}} to a scoped variable","call /getvar or /getglobalvar to get the variable used in the macro","call /let to save the retrieved variable to a scoped variable","call /return with the saved {{pipe}} value to restore the correct piped value for the next command"]},{"i":"quick-replies-script-library-and-auto-execution","l":"Quick Replies: script library and auto-execution","p":["Quick Replies is a built-in SillyTavern extension that provides an easy way to store and execute your scripts."]},{"l":"Configuring Quick Replies","p":["In order to get started, enable open the extensions panel (stacked blocks icon), and expand the Quick Replies menu.","Quick Reply","Quick Replies are disabled by default, you need to enable them first. Then you will see a bar appearing above your chat input bar.","You can set the displayed button text label (we recommend using emojis for brevity) and the script that will be executed when you click the button.","The number of buttons is controlled by the Number of slots settings (max = 100), adjust it according to your needs and click \"Apply\" when done.","Inject user input automatically recommended to be disabled when using STscript, otherwise it may interfere with your inputs, use the {{input}} macro to get the current value of the input bar in scripts instead.","Quick Reply presets allow to have multiple sets of predefined Quick Replies and switch between manually or by using the /qrset (name of set) command. Don't forget to click \"Update\" before switching to a different set to write your changes to the currently used preset!"]},{"l":"Manual execution","p":["Now you can add your first script to the library. Pick any free slot (or create one), type \"Click me\" into the left box to set the label, then paste this into the right box:","Then click 5 times on the button that appeared above the chat bar. Every click increments the variable clicks by one and displays a different message when the value equals 5 and resets the variable."]},{"l":"Automatic execution","p":["Open the modal menu by clicking the ⋮ button for the created command.","In this menu you can do the following:","Edit the script in a convenient full-screen editor","Hide the button from the chat bar, making it accessible only for auto-execution.","Enable automatic execution on one or more of the following conditions:","App startup","Sending a user message to the chat","Receiving an AI message in the chat","Opening a character or group chat","Triggering a reply from a group member","Activating a World Info entry using the same Automation ID","Provide a custom tool tip for the quick reply (text displayed when hovering over the quick reply in your UI)","Execute the script for test purposes","Commands are executed automatically only if the Quick Replies extension is enabled.","For example, you can display a message after sending five user messages by adding the following script and setting it to auto-execute on the user message."]},{"l":"Debugger","p":["A basic debugger exists inside the expanded Quick Reply editor. Set breakpoints with /breakpoint | anywhere in your script. When executing the script from the QR editor, the execution will be interrupted at that point, allowing you to examine the currently available variables, pipe, command arguments, and more, and to step through the rest of the code one by one.","QR Editor Debugger"]},{"l":"Calling procedures","p":["A /run command can call scripts defined in the Quick Replies by their label, basically providing the ability to define procedures and return results from them. This allows to have reusable script blocks that other scripts could reference. The last result from the procedure's pipe is passed to the next command after it.","Let's create two Quick Replies:","Label:","GetRandom","Command:","GetMessage","Clicking on the GetMessage button will call the GetRandom procedure which will resolve the {{roll}} macro and pass the number to the caller, displaying it to the user.","Procedures do not accept named or unnamed arguments, but can reference the same variables as the caller.","Avoid recursion when calling procedures as it may produce the \"call stack exceeded\" error if handled unadvisedly."]},{"l":"Calling procedures from a different Quick Reply preset","p":["You can call a procedure from a different quick reply preset using the a.b syntax, where a = QR preset name and b = QR label name","By default, the system will first look for a quick reply label a.b, so if one of your labels is literally \"QRpreset1.QRlabel1\" it will try to run that. If no such label is found, it will search for a QR preset name \"QRpreset1\" with a QR labeled \"QRlabel1\"."]},{"l":"Quick Replies management commands"},{"l":"Create Quick Reply","p":["/qr-create (arguments, [message])– creates a new Quick Reply, example: /qr-create set=MyPreset label=MyButton /echo 123","Arguments:","label- string - text on the button, e.g., label=MyButton","set- string - name of the QR set, e.g., set=PresetName1","hidden- bool - whether the button should be hidden, e.g., hidden=true","startup- bool - auto execute on app startup, e.g., startup=true","user- bool - auto execute on user message, e.g., user=true","bot- bool - auto execute on AI message, e.g., bot=true","load- bool - auto execute on chat load, e.g., load=true","title- bool - title / tooltip to be shown on button, e.g., title=My Fancy Button"]},{"l":"Delete Quick Reply","p":["/qr-delete (set=string [label])– deletes Quick Reply"]},{"l":"Update Quick Reply","p":["/qr-update (arguments, [message])– updates Quick Reply, example: /qr-update set=MyPreset label=MyButton newlabel=MyRenamedButton /echo 123","Arguments:","newlabel- string - new text fort the button, e.g. newlabel=MyRenamedButton","label- string - text on the button, e.g., label=MyButton","set- string - name of the QR set, e.g., set=PresetName1","hidden- bool - whether the button should be hidden, e.g., hidden=true","startup- bool - auto execute on app startup, e.g., startup=true","user- bool - auto execute on user message, e.g., user=true","bot- bool - auto execute on AI message, e.g., bot=true","load- bool - auto execute on chat load, e.g., load=true","title- bool - title / tooltip to be shown on button, e.g., title=My Fancy Button"]},{"i":"#","p":["qr-get- retrieves all of a Quick Reply's properties, eample: /qr-get set=myQrSet id=42"]},{"l":"Create or update QR preset","p":["/qr-presetupdate (arguments [label]) or /qr-presetadd (arguments [label])","Arguments:","enabled- bool - enable or disable the preset","nosend- bool - disable send / insert in user input (invalid for slash commands)","before- bool - place QR before user input","slots- int - number of slots","inject- bool - inject user input automatically (if disabled use {{input}})","Create a new preset (overrides existing ones), example: /qr-presetadd slots=3 MyNewPreset"]},{"l":"Add QR context menu","p":["/qr-contextadd (set=string label=string chain=bool [preset name])– add context menu preset to a QR, example: /qr-contextadd set=MyPreset label=MyButton chain=true MyOtherPreset"]},{"l":"Remove all context menus","p":["/qr-contextclear (set=string [label])– remove all context menu presets from a QR, example: /qr-contextclear set=MyPreset MyButton"]},{"l":"Remove one context menu","p":["/qr-contextdel (set=string label=string [preset name])– remove context menu preset from a QR, example: /qr-contextdel set=MyPreset label=MyButton MyOtherPreset"]},{"l":"Quick Reply value escaping","p":["|{} can be escaped with backslash in the QR message / command.","For example, use /qr-create label=MyButton /getvar myvar \\| /echo \\{\\{pipe\\}\\} to create a QR that calls /getvar myvar | /echo {{pipe}}."]},{"l":"Extension commands","p":["SillyTavern extensions (both built-in, downloadable and third-party) can add their own slash command. Below is just an example of the capabilities in the official extensions. The list may be incomplete, make sure to check /help slash for the most complete list of available commands.","/websearch (query)— searches snippets of the web pages online for the specified query and returns the result into the pipe. Provided by the Web Search extension.","/imagine (prompt)— generates an image using the provided prompt. Provided by the Image Generation extension.","/emote (sprite)— sets a sprite for the active character by fuzzy matching its name. Provided by the Character Expressions extension.","/costume (subfolder)— sets a sprite set override for the active character. Provided by the Character Expressions extension.","/music (name)— force changes a played background music file by its name. Provided by the Dynamic Audio extension.","/ambient (name)— force changes a played ambient sound file by its name. Provided by the Dynamic Audio extension.","/roll (dice formula)— adds a hidden message to the chat with the result of a dice roll. Provided by the D&D Dice extension."]},{"l":"UI interaction","p":["Scripts can also interact with SillyTavern's UI: navigate through the chats or change styling parameters."]},{"l":"Character navigation","p":["/random— opens a chat with the random character.","/go (name)— opens a chat with the character of the specified name. First, searches for the exact name match, then by a prefix, then by a substring."]},{"l":"UI styling","p":["/bubble— sets the message style to the \"bubble chat\" style.","/flat— sets the message style to the \"flat chat\" style.","/single— sets the message style to the \"single document\" style.","/movingui (name)— activates a MovingUI preset by name.","/resetui— resets the MovingUI panels state to their original positions.","/panels— toggles the UI panels visibility: top bar, left and right drawers.","/bg (name)— finds and sets a background using fuzzy names matching. Respect the chat background lock state.","/lockbg— locks the background image for the current chat.","/unlockbg— unlocks the background image for the current chat."]},{"l":"More examples"},{"i":"generate-chat-summary-by-ikaridevgit","l":"Generate chat summary (by @IkariDevGIT)"},{"l":"Buttons popup usage"},{"i":"get-nth-fibonaccis-number-using-binets-formula","l":"Get Nth Fibonacci's number (using Binet's formula)","p":["Hint: Set value of fib_no to the desired number"]},{"i":"recursive-factorial-using-closures","l":"Recursive Factorial (using closures)"}],[{"l":"Function Calling","p":["Function Calling allows adding dynamic functionality to your extensions by letting the LLM use structured data that you then can use to trigger a specific functionality of the extension.","This feature is currently under development. Implementation details may change."]},{"l":"Example use cases","p":["Query external APIs for additional information (news, weather, web search, etc.).","Perform calculations or conversions based on user input.","Store and recall important memories or facts, including RAG and database queries.","Introduce true randomness into the conversation (dice rolls, coin flips, etc.)."]},{"l":"Officially supported extensions using function calling","p":["Image Generation(built-in) - generate images based on user prompts.","Web Search- trigger a web search for a query.","RSS- fetch the latest news from RSS feeds.","AccuWeather- fetch the weather information from AccuWeather.","D&D Dice- roll dice for D&D games."]},{"l":"Prerequisites and limitations","p":["This feature is only available for certain Chat Completion sources: OpenAI, Claude, MistralAI, Groq, Cohere, OpenRouter and Custom API sources.","Text Completion APIs don't support function calls, but some locally-hosted backends like Ollama and TabbyAPI may run in Custom OpenAI-compatible mode under Chat Completion.","The support for function calling must be explicitly allowed by the user first. This is done by enabling the \"Enable function calling\" option in the AI Response Configuration panel.","There is no guarantee that an LLM will perform any function calls at all. Most of them require an explicit \"activation\" through the prompt (e.g., the user asking to \"Roll a dice\", \"Get the weather\", etc.).","Not all prompts can trigger a tool call. Continuations, impersonation, background ('quiet') prompts are not allowed to trigger a tool call. They can still use past successful tool calls in their responses."]},{"l":"How to make a function tool"},{"l":"Check if the feature is supported","p":["To determine if the function tool calling feature is supported, you can call isToolCallingSupported from the SillyTavern.getContext() object. This will check if the current API supports function tool calling and if it's enabled in the settings. Here is an example of how to check if the feature is supported:"]},{"l":"Register a function","p":["To register a function tool, you need to call the registerFunctionTool function from the SillyTavern.getContext() object and pass the required parameters. Here is an example of how to register a function tool:"]},{"l":"Unregister a function","p":["To deactivate a function tool, you need to call the unregisterFunctionTool function from the SillyTavern.getContext() object and pass the name of the function tool to disable. Here is an example of how to unregister a function tool:"]},{"l":"Tips and tricks","p":["Successful tool calls are saved as a part of the visible history and will be displayed in the chat UI, so you can inspect the actual parameters and results.","If you don't want to see the tool call in the chat history. If you want to stylize or hide them with custom CSS, target a toolCall class on .mes elements, i.e. .mes.toolCall { display: none; } or .mes.toolCall { color: #999; }."]}],[{"l":"UI Extensions","p":["UI extensions expand the functionality of SillyTavern by hooking into its events and API. You can easily create your own extensions.","Want to contribute your extensions to the official repository? Contact us!"]},{"l":"Examples","p":["See live examples of simple SillyTavern extensions:","https://github.com/city-unit/st-extension-example- basic extension template. Showcases manifest creation, local script imports, adding a settings UI panel, and persistent extension settings usage."]},{"l":"Bundling","p":["Extensions can also utilize bundling to isolate themselves from the rest of the modules and use any dependencies from NPM, including UI frameworks like Vue, React, etc.","https://github.com/SillyTavern/Extension-ReactTemplate- template repository of a barebone extension using React and Webpack.","To use relative imports from the bundle, you may need to create an import wrapper. Here's an example for Webpack:"]},{"i":"manifestjson","l":"manifest.json","p":["Every extension must have a folder in data/user-handle/extensions and have a manifest.json file which contains metadata about the plugin and a JS script file.","display_name is required. Displays in the \"Manage Extensions\" menu.","loading_order is optional. Higher number loads later.","requires specifies the required Extras modules dependencies. An extension won't be loaded unless the connected Extras API provides all of them.","optional specifies the optional Extras dependencies.","js is the main JS file reference, and is required.","css is an optional style file reference.","author is required. It should contain the name or contact info of the author(s).","auto_update is set to true if the extension should auto-update when the version of the ST package changes.","Downloadable extensions are mounted into the /scripts/extensions/third-party folder, so relative imports should be used based on that. Be careful about where you create your extension during development if you plan on installing it from your GitHub which overwrites the content in the third-party folder."]},{"l":"requires vs optional","p":["requires- extension could be installed, but will not be loaded until the user connects to the Extras API that provides all of the specified modules.","optional- extension could be installed and will always be loaded, but any of the missing Extras API modules will be highlighted in the \"Manage extensions\" menu.","To check which modules are currently provided by the connected Extras API, import the modules array from scripts/extensions.js."]},{"l":"Using getContext","p":["The getContext() function gives you access to the SillyTavern context:","Use this to interact with the main app state.","You can also use a globally defined window object: SillyTavern.getContext()."]},{"l":"Importing from other files","p":["Unless you're building a bundled extension, you can import variables and functions from other JS files.","For example, this code snippet will generate a reply from the currently selected API in the background:"]},{"l":"Important note","p":["Using imports from SillyTavern code is unreliable and can break at any time if the internal structure of ST's modules changes. getContext provides a more stable API.","If you're missing any of the functions/properties in getContext, please get in touch with the developers or send us a Pull Request!"]},{"i":"registering-slash-commands-new-way","l":"Registering slash commands (new way)","p":["While registerSlashCommand still exists for backward compatibility, new slash commands should now be registered through SlashCommandParser.addCommandObject() to provide extended details about the command and its parameters to the parser (and in turn to autocomplete and the command help)."]},{"i":"deprecated-registering-slash-commands-old-way","l":"(DEPRECATED) Registering slash commands (old way)","p":["Use registerSlashCommand() to register a new slash command:","Example of command execution:","Arguments explanation:","command- the main command name. It will be used in autocompletion and help commands.","callback- a function that will be executed when the command is triggered. A callback function can accept two arguments:","namedArgs- an object with named arguments","unnamedArgs- a string containing the unnamed argument","aliases- an array of alias strings. The command can be called using any of the aliases, but they won't be shown in the autocomplete but will be listed in the help command.","helpString- a string that will be displayed when the /help slash command is called. Must describe what your command does and which arguments it accepts. May contain HTML markup.","All registered commands can be used in STscript in any possible way.","In rare circumstances, the unnamed command argument can also receive a number so be sure to type check or convert if you expect a concrete type!"]},{"l":"Listening to event types","p":["Use eventSource.on() to listen for events:","The main event types are:","MESSAGE_RECEIVED","MESSAGE_SENT","CHAT_CHANGED","The rest can be found here."]},{"l":"Do Extras request","p":["The doExtrasFetch() function allows you to make requests to your SillyTavern Extra server.","For example, to call the /api/summarize endpoint:","getApiUrl() returns the base URL of the Extras serve.","The doExtrasFetch() function:","Adds the Authorization and Bypass-Tunnel-Reminder headers","Handles fetching the result","Returns the result (the response object)","This makes it easy to call your Extra's API from your plugin.","You can specify:","The request method: GET, POST, etc.","Additional headers","The body for POST requests","And any other fetch options"]}],[{"l":"Server Plugins","p":["These plugins allow adding functionality that is impossible to achieve using UI extensions alone, such as creating new API endpoints or using Node.JS packages that are unavailable in a browser environment.","Plugins are contained in the plugins directory of SillyTavern and loaded on server startup, but only if enableServerPlugins is set to true in the config.yaml file.","Plugins are not sandboxed, be careful what you install and run!"]},{"l":"Types of plugins"},{"l":"Files","p":["An executable JavaScript file with \".js\" (for CommonJS modules) or \".mjs\" (for ES modules) extension containing a module that exports an init function that accepts an Express router (created specifically for your plugin) as an argument and returns a Promise.","The module should also export an info object containing the information about the plugin ( id, name, and description strings). This will provide the information about the plugin to the loader.","You can register routes via the router that will be registered under the /api/plugins/{id}/{route} path. For example router.get('/foo') for plugin example will produce a route like this: /api/plugins/example/foo.","A plugin could also optionally export an exit function that performs clean-up on shutting down the server. It should have no arguments and must return a Promise.","TypeScript contract for plugin exports:","See below for a \"Hello world!\" plugin example:"]},{"l":"Directories","p":["You can load a plugin from a subdirectory in the plugins in one of the following ways (in the order of checks):","package.json file that contains a path to an executable file in the \"main\" field.","index.js file for CommonJS modules.","index.mjs file for ES modules.","A resulting file must export an init function and info object with the same requirements as for individual files.","Example of a directory plugin (with index.js file): https://github.com/SillyTavern/SillyTavern-DiscordRichPresence-Server"]},{"l":"Bundling","p":["It is preferable to use a bundler (such as Webpack or Browserify) that will package all of the requirements into one file. Make sure to set \"Node\" as a build target.","Template repository for plugins using Webpack and TypeScript: https://github.com/SillyTavern/Plugin-WebpackTemplate"]}],[{"i":"internationalization-i18n","l":"Internationalization (i18n)","p":["SillyTavern supports multiple languages. This guide explains how to add and manage translations.","You're probably here because some piece of text is untranslated in your language, and it's driving you nuts. First I'll show you how I fixed some missing translations in the Chinese (Traditional) locale. Each was missing for a different reason, so you'll get a good idea of how to fix your own missing translations.","In the second half, we look at","how i18n works in SillyTavern,","writing translations and code to use them,","debug functions to find missing translations,","adding a new language,","and contributing your changes.","If you're developing an extension or modifying the core code, write your HTML and JavaScript with i18n in mind. This way your work is ready for other people to translate it into their language.","Nobody knows 15 languages by themselves. We work together to make SillyTavern accessible to everyone.","Everyone in the world should be able to use their own language on phones and computers."]},{"i":"lets-fix-some-missing-translations","l":"Let's fix some missing translations!","p":["All 3 of these issues required code changes to fix. If you're adding a new translation, you might not need to touch the code at all. Just add the translation to the JSON file. It just so happens that somebody recently added a large number of missing translations to the Chinese (Traditional) JSON file, so the remaining issues were all in the code. In other locales there are plenty of missing translations you can fix without touching the code."]},{"l":"Generate Image","p":["... which we can add to the JSON file just after the \"Generate Image\" translation.","After some discussion with Claude, we're actually going to go with the following translations:","But while we have the HTML open, what's with Stop Image Generation just under it? The HTML doesn't look right.","First fix the HTML:","generate-image-lang.png","generate-image-post.png","generate-image-pre.png","If we generate an image and then open the wand menu while it's generating, we see untranslated text.","Japanese: \"Stop Image Generation\": \"画像生成を停止\"","Now it works! Reload the page and see.","Right-click on the element and inspect it. You'll see the HTML:","Simplified Chinese: \"Stop Image Generation\": \"中止图像生成\"","stop-generating-image-pre.png","stop-generating-post-2.png","The text \"Generate Image\" is untranslated in the Chinese (Traditional) locale. Why?","This isn't enough to fix the issue. There are no translations for \"Stop Image Generation\" in the Chinese (Traditional) file. We can add it! Here's one possible translation:","Traditional Chinese: \"Stop Image Generation\": \"終止圖片生成\"","We are in luck, that string Generate Image is in many of the language files, including in Chinese (Traditional).","Where is its data-i18n attribute? It's missing! Let's add it. We find it in the source code:","Why isn't it showing up? We have to wire the element up correctly:"]},{"l":"Generate Caption","p":["\"Generate Caption\" is untranslated in the Chinese (Traditional) locale. Let's fix it!","generate-image-post.png","Where is it? Inspect the element.","Turns out that this HTML is produced by JavaScript. Let's find the source code.","We will first have to fix the code:","There are also no translations for \"Generate Caption\" in the Chinese (Traditional) file. Let's add it!","We will use the following translations:","Traditional Chinese: \"Generate Caption\": \"生成圖片說明\"","Simplified Chinese: \"Generate Caption\": \"生成图片说明\"","Japanese: \"Generate Caption\": \"画像説明を生成\"","generate-caption-post.png"]},{"l":"Inspect Prompts","p":["The text \"Inspect Prompts\" is untranslated in the Chinese (Traditional) locale. Why? This one is a bit more complicated. The text is generated by JavaScript, and the translation is missing.","Well wouldn't you know it... neither phrase is in the i18n files. Let's add them.","Now we have to fix the JavaScript code. It has to use the t function to get the translation.","We got these suggestions from Claude. Keep the strings, ignore the code. They have to be added to the JSON files.","We will merge those into the JSON files.","toggle-prompt-inspection-post-tt.png","A pity about that tooltip. The problem is that the code doesn't use the t function.","We will have to fix that in the extension code.","We also need to add the translations to the JSON files.","Prompt inspector is a separate extension, so we will PR the code fixes to that repo: https://github.com/SillyTavern/Extension-PromptInspector/pull/1","The translations will be added to the main SillyTavern repo. https://github.com/SillyTavern/SillyTavern/pull/3198","start-inspecting-post.png"]},{"l":"Language files","p":["Each language has a JSON file in public/locales/ named with its language code (e.g., ru-ru.json).","The file contains key-value pairs where:","Keys are either the original English text or unique identifiers","Values are the translated text","Example:"]},{"l":"How translations work","p":["There are two ways translations are used in the application:","HTML Elements: Using data-i18n attributes","The default text in the HTML will be replaced with the translated text if available.","Template Strings: In the JavaScript code using the t function","These strings should be translated keeping the ${0}, ${1}, etc. placeholders intact.","SillyTavern uses HTML elements with data-i18n attributes to mark translatable content. There are several ways to use this:"]},{"l":"1. Translating Element Text","p":["For simple text content:","This replaces the element's text content with the translation of \"Role:\"."]},{"l":"2. Translating Attributes","p":["To translate an attribute like a title or placeholder:","The [title] prefix indicates which attribute to translate. The rest of the attribute value is the text that will be used as a lookup key in the JSON file. It is common for coders to use the English text as the key, but it is not required. The key can be any unique identifier.","The original English text must be present in the corresponding attribute ( title=Insert prompt) though. It's used as a fallback if the translation is missing. Most notably, there is no translation file for English.","Here is an example of using a unique identifier no_items_text as the key, rather than the English text:"]},{"l":"3. Multiple Translations Per Element","p":["Some elements need both content and attribute translations, separated by semicolons. The most common pattern is translating both the element's text content and its title attribute:","This translates:","The element's text content using the key \"Authorize\"","The title attribute using the key \"Get your OpenRouter API token using OAuth flow. You will be redirected to openrouter.ai\"","Note that both the title attribute and the element's text content are provided in English as fallbacks.","You can also translate multiple attributes:","The corresponding translations in your language file would look like:","When the page loads, the system:","Finds all elements with data-i18n attributes","Parses any attribute prefixes like [title] or [placeholder]","Looks up each key in your language's JSON file","Replaces the element's content or attributes with the translated text"]},{"l":"Dynamic Text","p":["For dynamic text in JavaScript code, translations use either:","Template literals with the t function:","Direct translation function:"]},{"l":"Variable Placeholders","p":["Some strings contain placeholders for dynamic values using ${0}, ${1}, etc:","Keep the placeholders the same for key and translation. The system will replace ${0} with the value of presetName, etc."]},{"l":"Finding missing translations","p":["Let's say you don't just want to fix one annoying missing translation, you want to find them all.","That's a big ambition! Even fixing one translation is worth it. But if you want to catch 'em all, you need a tool."]},{"l":"SillyTavern-i18n","p":["https://github.com/SillyTavern/SillyTavern-i18n","Tools for working with frontend localization files.","Features:","Automatically add new keys to translate from HTML files.","Prune missing keys from localization files.","Use automatic Google translation to auto-populate missing values.","Sort JSON files by keys."]},{"l":"Inbuilt debug functions","p":["These are under User Settings> Debug Menu."]},{"l":"Get missing translations","p":["Detects missing localization data in the current locale and dumps the data into the browser console. If the current locale is English, searches all other locales.","The console will show a table of missing translations with:","key: The text or identifier needing translation","language: Your current language code","value: The English text to translate"]},{"l":"Apply locale","p":["Reapplies the currently selected locale to the page","they don't catch missing translations in JavaScript code","they don't catch missing data-i18n attributes in HTML, they just catch untranslated keys","there are bugs in the code for getMissingTranslations: keys should not be prefixed with [title] or [placeholder]"]},{"l":"Adding a new language","p":["To add support for a new language:","Add your language to public/locales/lang.json:","Create public/locales/xx-xx.json with your translations"]},{"l":"Contributing","p":["When your translations are ready:","Verify your JSON file is valid","Test thoroughly in the application","Submit via GitHub pull request"]}],[{"l":"Administration","p":["Despite following many security best practices, the SillyTavern server is not secure enough for public internet exposure.","NEVER HOST ANY INSTANCES TO THE OPEN INTERNET WITHOUT ENSURING PROPER SECURITY MEASURES FIRST.","WE ARE NOT RESPONSIBLE FOR ANY DAMAGE OR LOSSES IN CASES OF UNAUTHORIZED ACCESS DUE TO IMPROPER OR INADEQUATE SECURITY IMPLEMENTATION.","Multi-user","To share your SillyTavern instance with others, you can create multiple user accounts. Each user has their own settings, extensions, and data. User accounts can also be password-protected.","Remote access","You can access your SillyTavern instance from your phone, tablet, or another computer.","VPNs and Tunneling","To access your SillyTavern instance from the internet, you can use a VPN or a tunneling service like Cloudflare Zero Trust, ngrok, or Tailscale.","Reverse proxying","For enthusiasts, you can set up a reverse proxy to access your SillyTavern instance from the internet."]},{"l":"Security checklist","p":["This is just a recommendation. Please consult a web application security specialist before making your ST instance live.","Keep your operating system and runtime software like Node.js updated. This will ensure that your system is up-to-date with the latest security patches and fixes which can help prevent potential vulnerabilities.","Use a whitelist and a network firewall. Only allow trusted IP ranges to access the server.","Enable basic authentication. It acts as a \"master password\" before you can proceed to the front-end app.","Alternatively, configure external authentication. Some known services for that are Authelia and authentik. See more in the SSO guide.","Never leave admin accounts passwordless. A server will warn you upon the startup if you have any unprotected admin accounts.","Use the discreet login setting outside of the local network. This will hide the user list from any potential outsiders.","Check the access logs often. They are written to the server console and the access.log file and provide information on incoming connections, such as IP address and user agent.","Configure HTTPS. For a localhost server, you can generate and use a self-signed certificate. Otherwise, you may need to deploy a proxying web server like Traefik or Caddy.","Find more on secure proxying in the following guide: Reverse Proxying SillyTavern."]}],[{"l":"Configuration File","p":["This documentation may be obsolete, incomplete, or incorrect. Please refer to the default config.yaml in your installation for the most up-to-date list of settings.","config.yaml is the main configuration file for the SillyTavern server that you can find in the repository root directory after completing the installation. It is a YAML file that contains various settings, such as the network settings, security settings, and backend-specific options. The changes made to this file will take effect after restarting the server.","New settings that added to the upstream version will be automatically populated with the default values when you run npm install(or specifically, the post-install.js script) after updating the repository. You can then modify these settings as needed.","For nested settings, dot notation is used to indicate the hierarchy. For example, protocol.ipv6: false refers to the ipv6 setting under the protocol section with a value of false."]},{"l":"Data Configuration","p":["./data","100","Any positive integer","Any valid directory path","cardsCacheCapacity","dataRoot","Default","Description","false","Permitted Values","Root directory for user data storage","Setting","Skip new default content checks","skipContentCheck","The maximum amount of memory that parsed character cards can use in MB.","true, false"]},{"l":"Network Configuration","p":["8000","Any valid port number (1-65535)","Default","Description","dnsPreferIPv6","Enable listening for incoming connections","Enable listening on IPv4 protocol","Enable listening on IPv6 protocol","false","listen","Permitted Values","port","Prefer IPv6 for DNS resolution","protocol.ipv4","protocol.ipv6","Server listening port","Setting","true","true, false"]},{"l":"Security Configuration","p":["[::1, 127.0.0.1]","Allow API keys exposure in the UI","allowKeysExposure","Array of valid IP addresses","Check forwarded headers for whitelisted IPs","Default","Description","Disable CSRF protection (not recommended)","Disable startup security checks (not recommended)","disableCsrfProtection","Enable CORS proxy middleware","Enable IP whitelist filtering","enableCorsProxy","enableForwardedWhitelist","false","List of allowed IP addresses","Permitted Values","securityOverride","Setting","true","true, false","whitelist","whitelistMode"]},{"l":"User Authentication","p":["''(auto-generated)","86400(24 hours)","Any number (-1 to disable, 0 for browser close, >0 for timeout)","Any string","autheliaAuth","Basic auth password","Basic auth username","basicAuthMode","basicAuthUser.password","basicAuthUser.username","cookieSecret","Default","Description","Enable Authelia-based auto login. See: SSO","Enable basic authentication","Enable multi-user mode","enableDiscreetLogin","enableUserAccounts","false","Hide user list on login screen","password","Permitted Values","perUserBasicAuth","Secret for signing session cookies","sessionTimeout","Setting","true, false","Use account credentials for basic auth","user","User session timeout in seconds"]},{"l":"Request Proxy Configuration","p":["[localhost, 127.0.0.1]","Array of hostnames/IPs","Default","Description","Enable proxy for outgoing requests","false","Hosts to bypass proxy","null","Permitted Values","Proxy server URL","requestProxy.bypass","requestProxy.enabled","requestProxy.url","Setting","true, false","Valid proxy URL (e.g., socks5://username:password@example.com:1080)"]},{"l":"AutoRun Configuration","p":["-1","-1(use server port), any valid port number","auto","auto, any valid hostname (e.g., localhost, st.example.com)","autorun","autorunHostname","autorunPortOverride","Avoid using 'localhost' for autorun","avoidLocalhost","Default","Description","false","Hostname used when autorun opens the browser","Open browser automatically on startup","Override port for browser autorun","Permitted Values","Setting","true","true, false"]},{"l":"Thumbnailing Configuration","p":["[160, 90]","[96, 144]","0-100","95","Array of two numbers (width, height)","Avatar thumbnails size","Background thumbnails size","Default","Description","Enable thumbnail generation","Image format for thumbnails","JPEG thumbnail quality","jpg","jpg, png","Permitted Values","Setting","thumbnails.dimensions.avatar","thumbnails.dimensions.bg","thumbnails.enabled","thumbnails.format","thumbnails.quality","true","true, false"]},{"l":"Backup Configuration","p":["-1","10000","50","Any positive integer","Any positive integer or -1","Backup throttle interval (ms)","backups.chat.enabled","backups.chat.maxTotalBackups","backups.chat.throttleInterval","backups.common.numberOfBackups","Default","Description","Enable automatic chat backups","Maximum total chat backups to keep","Number of backups to keep","Permitted Values","Setting","true","true, false"]},{"l":"Extensions Configuration","p":["Auto-update extensions","Cohee/distilbert-base-uncased-go-emotions-onnx","Cohee/jina-embeddings-v2-base-en","Default","Description","Disable automatic model downloads","Enable on-demand tokenizer downloads","Enable UI extensions","enableDownloadableTokenizers","enableExtensions","enableExtensionsAutoUpdate","extras.captioningModel","extras.classificationModel","extras.disableAutoDownload","extras.embeddingModel","extras.speechToTextModel","extras.textToSpeechModel","false","HuggingFace model ID for classification","HuggingFace model ID for embeddings","HuggingFace model ID for image captioning","HuggingFace model ID for speech-to-text","HuggingFace model ID for text-to-speech","Permitted Values","Setting","true","true, false","Valid model ID","Xenova/speecht5_tts","Xenova/vit-gpt2-image-captioning","Xenova/whisper-small"]},{"l":"Server Plugins","p":["Setting","Description","Default","Permitted Values","enableServerPlugins","Enable server-side plugins","false","true, false"]},{"l":"API Integration Settings"},{"l":"OpenAI Configuration","p":["Setting","Description","Default","Permitted Values","promptPlaceholder","Default message for empty prompts","[Start a new chat]","Any string","openai.randomizeUserId","Randomize user ID for API calls","false","true, false","openai.captionSystemPrompt","System message for caption completion"]},{"l":"MistralAI Configuration","p":["Setting","Description","Default","Permitted Values","mistral.enablePrefix","Enable reply prefilling. The prefix will be echoed in the response","false","true, false"]},{"l":"Ollama Configuration","p":["Setting","Description","Default","Permitted Values","ollama.keepAlive","Model keep-alive duration (seconds)","-1","-1(indefinite), 0(immediate unload), positive integer"]},{"l":"Claude Configuration","p":["IMPORTANT!","Use with caution and only when the prompt prefix is static and doesn't change between requests. {{random}} macro, lorebooks, vectors, summaries, etc. will likely invalidate the cache and you'll just waste money on cache misses. Behavior may be unpredictable and no guarantees can or will be made.","See: Prompt Caching","Setting","Description","Default","Permitted Values","claude.enableSystemPromptCache","Enable system prompt caching","false","true, false","claude.cachingAtDepth","Enable message history caching","-1","-1(disabled), 0 or positive integer"]},{"l":"DeepL Configuration","p":["Setting","Description","Default","Permitted Values","deepl.formality","Translation formality level","default, more, less, prefer_more, prefer_less"]}],[{"l":"Multi-user mode","p":["Multi-user mode allows several people to use one SillyTavern server. Each user has their own settings, extensions, and data. User accounts can also be password-protected.","User passwords provide basic privacy between users of a multi-user setup. They are not a security feature and should not be considered as such. All user data (including chat history, API keys, and other sensitive information) is stored in plain text on the server. It can be viewed and modified by anyone with access to the server's filesystem. Do not use SillyTavern on a public server or with untrusted users."]},{"l":"Configuration","p":["To enable and use the multi-user mode, edit the config.yaml file:","When the user account setting is disabled, a default-user fallback admin account is utilized for storing the user data.","When the discreet login setting is disabled, a list of active users is displayed on the login screen. If enabled, a user must enter their handle manually.","You can't delete the default-user account from the users list because it is used for serving the user data in case if enableUserAccounts is set to false. But you can disable it to hide it from the list and disallow logins."]},{"l":"User handles","p":["A handle is the unique identifier of a user. It can consist only of lowercase letters, numbers, and dashes.","A path to the user data directory assumes using the following pattern: %DATA_ROOT%/%USER_HANDLE%.","Examples of valid user handles:","default-user","juan555","flux-the-cat","cool-guy1337"]},{"l":"Roles","p":["Admin- can manage (create, delete, modify) other users.","User- can't manage other users.","Except for having admin panel access, both user roles are functionally identical and can use a full range of SillyTavern features without any restrictions. An implementation of user permissions is TBD.","All user accounts are created as regular users first, and then could be promoted to admins if needed."]},{"l":"Login screen","p":["There you can select a user account to use. Has two styles, depending on the enableDiscreetLogin config value.","The login screen is bypassed and not displayed when you have only one active user and it is not password protected."]},{"l":"User profile","p":["You can access an account self-management menu using an \"Account\" button under the \"User settings\" panel in the top menu bar.","Display name - used in the login screen, can be changed. Does not correlate with personas and is not visible for the AI APIs - you can still use as many personas as you want.","Profile picture - used in the login screen. You can either use a custom picture, the default persona picture (if set), or the last used persona otherwise.","Password - a lock icon reflects the account protection status (open lock = no password). A password can be set, changed, or removed using the \"Change Password\" button.","Settings Snapshots - access and review the backups of your settings.json file, with the ability to create or restore snapshots.","Download Backup - download an archive of your user data folder.","Reset Settings - reset factory default settings, while leaving other data (character, chats) intact."]},{"l":"Password recovery","p":["A password can be recovered from a login screen. You need access to the server console to get a one-time recovery code (consisting of 4 digits).","Alternatively, you can use a utility script in the SillyTavern server to reset a password by providing the user handle."]}],[{"i":"single-sign-on-sso","l":"Single Sign-On (SSO)","p":["SSO allows you to create users and secure many different pages using a login portal presented on sites you want to secure. While it is complex to setup, it is a good way to both learn SSO and secure your ST instance out on the internet more.","Authelia and Authentik are open-source SSO providers that can be used with SillyTavern."]},{"l":"Sign in with SSO","p":["If your SSO-provided username exactly matches the username of a SillyTavern user account, you can sign in to SillyTavern as that user by SSO.","To do this, enable autheliaAuth in config.yaml.","This augments or replaces the built-in password management component of a multi-user mode setup."]},{"l":"Replacing HTTP BA","p":["SSO can also replace HTTP Basic Authentication as an access control mechanism for remote connections.","This is recommended because SSO provides better security and functionality than HTTP BA.","To use an SSO provider in place of HTTP BA, enable securityOverride in config.yaml. Otherwise, SillyTavern will refuse to start."]}],[{"l":"Remote connections","p":["Most often this is for people who want to use SillyTavern on their mobile phones while their PC runs the ST server within the same WiFi network.","It is also the first step for allowing remote connections from outside the local network.","You should not use port forwarding to expose your ST server to the internet. Instead, use a VPN or a tunneling service like Cloudflare Zero Trust, ngrok, or Tailscale. See the VPN and Tunneling guide for more information.","NEVER HOST ANY INSTANCES TO THE OPEN INTERNET WITHOUT ENSURING PROPER SECURITY MEASURES FIRST.","WE ARE NOT RESPONSIBLE FOR ANY DAMAGE OR LOSSES IN CASES OF UNAUTHORIZED ACCESS DUE TO IMPROPER OR INADEQUATE SECURITY IMPLEMENTATION."]},{"l":"Allowing remote connections","p":["By default, the ST server only accepts connections from the machine that it's running on (localhost). To allow it to listen for connections from other devices, set the listen option in config.yaml to true.","When ST is listening for remote connections, you should see this message in the console:","and some explanation about what that means.","When ST is not listening for remote connections, you should see this message in the console:"]},{"l":"Access control","p":["After activating the remote connection listening, you must turn on at least one access control method, or the server will refuse to start."]},{"l":"Access control by whitelist","p":["Create a new text file inside your SillyTavern base install folder called whitelist.txt.","Open the file in a text editor, add a list of IPs you want to be allowed to connect.","Each IP must be on its own line.","127.0.0.1 MUST be included in the list, or you will not be able to connect on the host machine","Individual IPs, and wildcard (*) IP ranges are accepted.","CIDR masks are also accepted (eg. 10.0.0.0/24).","Save the whitelist.txt file.","Restart your SillyTavern server."]},{"i":"example-whitelisttxt-files","l":"Example whitelist.txt files","p":["Allows any device on the local network to connect:","If you are not sure what addresses your local network uses, use the whitelist above.","Allows two specific devices to connect:","Allows any device on the 192.168.0.* subnet to connect:","Change whitelistMode to false, remove (or rename) whitelist.txt in the SillyTavern base install folder, and restart the server."]},{"l":"Access control by HTTP Basic Authentication","p":["HTTP Basic Authentication does not provide strong security.","There is no rate-limiting to prevent brute-force attacks. If this is a concern, it is recommended to use a reverse proxy with TLS and rate-limiting, and a dedicated authentication service.","The server will ask for username and password whenever a client connects via HTTP. This only works if the Remote connections (listen: true) are enabled.","To enable HTTP BA, Open config.yaml in the SillyTavern base directory and search for basicAuthMode Set basicAuthMode to true and set username and password. Note: config.yaml will only exist if ST has been executed before at least once.","Alternatively you can enable basic auth as follows:","In this perUserBasicAuth mode the basic auth's username and password will be the same as any valid multi user account that has a password. Additionally SillyTavern will login directly to that account. Ensure you have an account with a password prior to enabling perUserBasicAuth.","Save the file and restart SillyTavern if it was already running. You should be prompted for username and password when connecting to your ST. Both username and password are transmitted in plain text. If you are concerned about this, you can serve ST via HTTPS."]},{"l":"Connecting to your SillyTavern instance"},{"l":"Getting the IP address for the ST host machine","p":["After the whitelist has been setup, you'll need the IP of the ST-hosting device.","If the ST-hosting device is on the same wifi network, you will use the ST-host's internal wifi IP:","For Windows: windows button > type cmd.exe in the search bar > type ipconfig in the console, hit Enter > look for IPv4 listing.","If you (or someone else) wants to connect to your hosted ST while not being on the same network, you will need the public IP of your ST-hosting device.","While using the ST-hosting device, access this page and look for for IPv4. This is what you would use to connect from the remote device."]},{"l":"Connecting to the ST server","p":["Whatever IP you ended up with for your situation, you will put that IP address and port number into the remote device's web browser.","A typical address for an ST host on the same wifi network would look like:","http://192.168.0.5:8000","Use http:// NOT https://"]},{"l":"Connection logging","p":["New connections to the server are displayed in the console window and logged in the access.log file in the SillyTavern base directory.","A console message for a browser on the same machine as the server looks like:","A console message for a browser on a different machine on the same network as the server might look like:","If a connection is refused, the console message will look like:","access.log will contain the connection information, with timestamps, but not whether the connection was accepted or refused."]},{"l":"Troubleshooting","p":["Still unable to connect?","If the connection attempt appears in the console, but is forbidden, it is a whitelist issue.","If ST is listening for remote connections but the connection attempt does not appear in the console, it is a network issue.","If ST is not listening for remote connections, it is a reading issue."]},{"l":"Network issues","p":["On Windows, the application may be blocked by the application firewall. The quickest way to fix this is to uninstall and reinstall node.js, and when prompted by the firewall, allow it to access the network. Otherwise, you will need to manually allow the node.js application through the Windows application firewall.","On Windows 11, enable the Private Network profile type in Settings > Network and Internet > Ethernet. This is VERY important for Windows 11, otherwise, you would be unable to connect even with the aforementioned firewall rules.","On Linux, you may need to allow the port through the firewall. The command to do this is sudo ufw allow 8000. This will allow traffic on port 8000.","Do not modify the port forwarding settings on your router. This is not necessary for accessing ST within your local network, and can expose your server to the internet.","If you are trying to access your ST server from outside your local network, and it's not working, identify whether the problem is between the remote device and the tunnel/VPN endpoint, or between the tunnel endpoint on the server and the ST service. Otherwise you will spend a lot of time troubleshooting the wrong thing."]},{"l":"HTTPS"},{"i":"start-sillytavern-with-tlsssl","l":"Start SillyTavern with TLS/SSL","p":["To encrypt traffic from and to your ST instance, start the server with the --ssl flag.","Example:","As per default, ST will search for your certificates inside the certs folder. If your files are located elsewhere, you can use the --keyPath and --certPath arguments.","The user you're running SillyTavern with requires read permissions on the certificate files."]},{"l":"How to get a certificate","p":["The simplest, quickest way to get a certificate is by using certbot."]}],[{"l":"VPNs and Tunneling","p":["VPNs and tunnels are a secure way to access your home network from anywhere in the world. This guide will show you how to use a VPN or a tunnel to access your SillyTavern instance from anywhere."]},{"l":"Methods","p":["Use a home-made VPN.","Several routers come with the ability to host a VPN server (primarily OpenVPN or WireGuard) in the router administration page. Refer to your router's manual to setup a VPN and add your devices to the VPN. Once connected, just go to the private IP you have set for SillyTavern and you can connect just fine. Easier for users and for Windows use.","Use Cloudflare Zero Trust.","Cloudflare Zero Trust is a free organizational feature in Cloudflare that allows you to add 50 users. This will proxy your traffic through Cloudflare and by adding your ST PC as a tunnel using cloudflared, you can connect to your ST instance as if you were home.","Do note that after making a tunnel, you will have to add a route to your router's private IP addresses and calculate IP CIDR values to have full local access on the go using Cloudflare Zero Trust.","Use a standalone Cloudflare or ngrok tunnel.","Similar to how AI backends can connect, you can also connect your ST instance via a Cloudflare Tunnel and open the Cloudflare Tunnel page. However, you will have to copy and paste each new link generated by Cloudflare/NGROK each time you want to use ST on-the-go.","Use Tailscale.","Tailscale is a VPN provider enabling a secure remote connection to your PC."]},{"l":"Tailscale setup","p":["Tailscale is a VPN provider enabling a secure remote connection to your PC. An open-source implementation of the Tailscale server exists and you can also host the server using Headscale, but that is outside of the scope of this tutorial."]},{"l":"1. Creating an account","p":["Go to Tailscale's website and create a new account.","NOTE: For everyday use by a single person Tailscale will be permanently free. If you fear hidden costs, just don't add any payment options."]},{"l":"2. Setting up clients","p":["Go to Tailscale's download page and download the client/app on the device you have SillyTavern running on and on the device you want to use from a remote location.","Log in on both devices with your previously created account.","Go to Tailscale's admin page and approve both devices.","Take note of both of the connected devices' names."]},{"l":"3. Adding your devices to the whitelist","p":["Add your connecting device's machine name (the one you want to use SillyTavern with) to SillyTavern's whitelist by following Managing whitelisted IPs."]},{"l":"4. Connecting","p":["Now whenever you want to use SillyTavern from anywhere all you have to do is:","Have Tailscale turned on on both the PC hosting SillyTavern and your device that wants to use it remotely.","Open a browser on the device that wants to connect and go to http://machine name of PC running st:8000/"]},{"i":"5-sharing-sillytavern-instance-with-a-friend-optional","l":"5. Sharing SillyTavern instance with a friend (optional)","p":["Tell your friend to create their own Tailscale account and download the client on their device.","Go to Tailscale's admin page.","Hover over the three-dot button on your PC hosting SillyTavern and press \"Share...\" or press the three-dot button and press \"Sharing settings...\".","Uncheck \"Allow use as an exit node\" (unless you want your friend to be able to route all their internet traffic through your PC).","Either send the link as an email or change the tab to \"Copy share link\", press the big blue button with the same text, and send it to your friend in any other way.","After clicking your share link, your friend will see your PC pop up in their Tailscale network.","Send your friend the same link you use to access SillyTavern as explained in the last step.","NOTE: This will give your friend full access to any services running locally on your PC like SillyTavern, automatic1111, etc. Only do this if you truly trust your friend."]}],[{"l":"Reverse proxying","p":["This section does not refer to OpenAI/Claude reverse proxies. This refers exclusively to HTTP/HTTPS Reverse Proxies.","Is Termux confusing to setup? Are you tired of updating and installing ST on every device you have? Want organization of your chats and characters? Well you are in luck. This guide will hopefully cover how to host SillyTavern on your PC where you can connect from anywhere and chat to your bots on the same PC you use to run AI models!","This guide is not meant for beginners. This will be very technical."]},{"l":"Fair Warning","p":["This guide is not for Windows users. We recommend using a Linux VM or WSL2 to follow this guide.","You must have prior knowledge of","Linux console commands","DNS Records","Public IP addresses","Docker","You will have to buy a domain for yourself and configure a CNAME for your SillyTavern page. We suggest adding or buying the domain on Cloudflare as this guide will cover how to do this with Cloudflare itself."]},{"l":"Installation"},{"i":"linux-bare-metal-sillytavern","l":"Linux (Bare-Metal SillyTavern)","p":["A","Auto","Before enabling perUserBasicAuth ensure you have a valid multi-user setup with working passwords.","cd into appdata/traefik and using nano or a similar editor, create a file name config.yml and paste the following. Replace PRIVATE_IP with the private IP you obtained, and silly.DOMAIN.com with the name of your subdomain and domain page, then save the file.","cd into secrets/cloudflare and using nano or a similar editor, create a file named CF_DNS_API_KEY and paste your key inside.","Click on Continue to summary followed by Create Token.","Click on Create Token then Create Custom Token and make sure you give your token the following permissions.","CNAME","Copy the Token Key given to you and store it somewhere secure.","Create a acme.json file using touch and set the permissions of it to 600.","Create another record of the CNAME type, then click Save. Here is an example on how it should appear on the Cloudflare dashboard.","Do not install Docker Desktop.","DOMAIN.com","Enjoy! :D","Execute chown, replacing with your Linux username to set the permissions in the docker folder.","Follow the steps in Manage Docker as a non-root user in the Docker post-installation guide here.","For Linux, we will reverse proxying SillyTavern through Traefik. There are other options such as NGINX or Caddy, but for this guide, we will use Traefik as it is what we use ourselves.","Get the private IP of your computer using ifconfig or from your router.","Get your public IP of your modem by Googling what's my ip.","Go to your root folder in Linux and make a new folder named docker.","Go to your SillyTavern folder and edit config.yaml to enable listen mode and basic authentication, whilst disabling whitelistMode.","If nothing happens after several minutes, check the container logs for Traefik for any possible errors.","Install Docker by following the Docker installation guide here.","It is recommended to set your private IP to a Static IP. Refer to your router's manual or Google to configure static IPs.","Login to Cloudflare and click on your Domain, followed by Get your API token.","Make a folder inside the docker folder, that being appdata and inside appdata being traefik. Enter the appdata/traefik folder afterwards.","Make a folder inside the docker folder, that being secrets and inside secrets being cloudflare.","Make sure to change the default username and password to something strong that you can remember.","Most residential/home networks use Dynamic IPs which are renewed after months of use. If you have a dynamic IP, use either DDClient or remember to check and change your public IP ever so often on the Cloudflare Dashboard.","N/A","Name (required)","Or to use the SillyTavern accounts as usernames and passwords:","Proxied","Proxy Status","PUBLIC_IP","Return back to the docker folder.","Return to your domain page and go to DNS. Create a new record using Add record and create two A type keys like the ones below. Replace PUBLIC_IP with your own public IP, then click Save.","Run Docker Compose using the following commands:","silly","Target (required)","TTL","Type","Using nano or a similar editor, create a file name docker-compose.yaml and paste the following. Save the file afterwards.","Using nano or a similar editor, create a file name traefik.yml and paste the following. Replace the template email with your own, then save the file.","Wait a few minutes, then open your domain page you made for ST. At the end of it, you should be able to open SillyTavern from anywhere you go just with one URL and one account.","www","Zone -> DNS -> Edit","Zone -> Zone -> Read"]},{"i":"linux-docker-sillytavern","l":"Linux (Docker SillyTavern)","p":["A","Auto","cd into secrets/cloudflare and using nano or a similar editor, create a file named CF_DNS_API_KEY and paste your key inside.","Click on Continue to summary followed by Create Token.","Click on Create Token then Create Custom Token and make sure you give your token the following permissions.","CNAME","Copy the Token Key given to you and store it somewhere secure.","Create another record of the CNAME type, then click Save. Here is an example on how it should appear on the Cloudflare dashboard.","Do note that we run SillyTavern on bare-metal over Docker. This is a rough idea of what we would do on Docker with other Docker containers we tend to use with ST.","DOMAIN.com","Enjoy! :D","Follow Steps 1-11 of Linux (Bare-Metal SillyTavern).","Git clone SillyTavern into the docker folder.","Go to your SillyTavern folder ( appdata/sillytavern/config) and edit config.yaml to enable listen mode and basic authentication, whilst disabling whitelistMode.","If nothing happens after several minutes, check the container logs for Traefik for any possible errors.","Login to Cloudflare and click on your Domain, followed by Get your API token.","Make sure to change the default username and password to something strong that you can remember.","N/A","Name (required)","Proxied","Proxy Status","PUBLIC_IP","Return to your domain page and go to DNS. Create a new record using Add record and create two A type keys like the ones below. Replace PUBLIC_IP with your own public IP and the example domain with your domain, then click Save.","Run Docker Compose using the following commands:","silly","Start the SillyTavern Docker container again.","Stop the SillyTavern Docker container.","Target (required)","TTL","Type","Using nano or a similar editor, create a file name docker-compose.yaml and paste the following. Replace silly.DOMAIN.com with the subdomain you added above, the save the file afterwards.","Wait a few minutes, then open your domain page you made for ST. At the end of it, you should be able to open SillyTavern from anywhere you go just with one URL and one account.","www","Zone -> DNS -> Edit","Zone -> Zone -> Read"]},{"l":"Updating your Cloudflare DNS","p":["DDClient allows you to sync your public IP to Cloudflare in the situation that your ISP changes it, allowing you to continue accessing your ST instance as if nothing ever happened."]}],[{"l":"License and credits","p":["This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.","See the GNU Affero General Public License for more details.","Original TavernAI 1.2.8 by Humi: MIT License"]},{"i":"pre-v190-contributors","l":"Pre-v1.9.0 Contributors","p":["The git commit history was squashed to the state of release 1.9.0.","Unfortunately, losing commit history also means losing the code contribution history. If you contributed to the SillyTavern development and want to see yourself credited in the README file and Docs website, please get in touch with us!"]},{"l":"Documentation Contributors","p":["Click the image below to see the full list of SillyTavern documentation contributors.","Contributors"]}]]
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 9d350e6ca..28f069466 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/tags/attachments/index.html b/tags/attachments/index.html
index 6a93c9ace..9538162e5 100644
--- a/tags/attachments/index.html
+++ b/tags/attachments/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/chats/index.html b/tags/chats/index.html
index f1f11e4fe..9782f0512 100644
--- a/tags/chats/index.html
+++ b/tags/chats/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/documents/index.html b/tags/documents/index.html
index 7bbaae6ce..7c4cf61c0 100644
--- a/tags/documents/index.html
+++ b/tags/documents/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/files/index.html b/tags/files/index.html
index 95b6237f0..8330e595c 100644
--- a/tags/files/index.html
+++ b/tags/files/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/index.html b/tags/index.html
index 74673c353..3d79d4589 100644
--- a/tags/index.html
+++ b/tags/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/messages/index.html b/tags/messages/index.html
index 48ebb20a3..abade703f 100644
--- a/tags/messages/index.html
+++ b/tags/messages/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/rag/index.html b/tags/rag/index.html
index 212861352..873a2b631 100644
--- a/tags/rag/index.html
+++ b/tags/rag/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/retrieval-augmented-generation/index.html b/tags/retrieval-augmented-generation/index.html
index f54434fed..af44d4e1d 100644
--- a/tags/retrieval-augmented-generation/index.html
+++ b/tags/retrieval-augmented-generation/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/summarization/index.html b/tags/summarization/index.html
index 116ce167b..9836155de 100644
--- a/tags/summarization/index.html
+++ b/tags/summarization/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/vector-storage/index.html b/tags/vector-storage/index.html
index 5c5b0a917..55e18de17 100644
--- a/tags/vector-storage/index.html
+++ b/tags/vector-storage/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/vectors/index.html b/tags/vectors/index.html
index 8a93fee58..52369d3ea 100644
--- a/tags/vectors/index.html
+++ b/tags/vectors/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/visual-novel/index.html b/tags/visual-novel/index.html
index 183467e50..9ed3e5ea1 100644
--- a/tags/visual-novel/index.html
+++ b/tags/visual-novel/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/tags/vn/index.html b/tags/vn/index.html
index 371467156..39c87352d 100644
--- a/tags/vn/index.html
+++ b/tags/vn/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -30,11 +30,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/dreamgen/index.html b/usage/api-connections/dreamgen/index.html
index 834f35e23..14a4a3603 100644
--- a/usage/api-connections/dreamgen/index.html
+++ b/usage/api-connections/dreamgen/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/horde/index.html b/usage/api-connections/horde/index.html
index 80c83a25e..7f53ef9b8 100644
--- a/usage/api-connections/horde/index.html
+++ b/usage/api-connections/horde/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/index.html b/usage/api-connections/index.html
index e77efa115..8b4c41870 100644
--- a/usage/api-connections/index.html
+++ b/usage/api-connections/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/koboldcpp/index.html b/usage/api-connections/koboldcpp/index.html
index fb870dea3..e8b2ca900 100644
--- a/usage/api-connections/koboldcpp/index.html
+++ b/usage/api-connections/koboldcpp/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/mancer/index.html b/usage/api-connections/mancer/index.html
index 08d9f2a92..2beb1ecea 100644
--- a/usage/api-connections/mancer/index.html
+++ b/usage/api-connections/mancer/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/novelai/index.html b/usage/api-connections/novelai/index.html
index 8bc8136dd..04284a03a 100644
--- a/usage/api-connections/novelai/index.html
+++ b/usage/api-connections/novelai/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/openai/index.html b/usage/api-connections/openai/index.html
index e4e4ef3a9..d5b73ea13 100644
--- a/usage/api-connections/openai/index.html
+++ b/usage/api-connections/openai/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/openrouter/index.html b/usage/api-connections/openrouter/index.html
index 9f2b0395c..9b96bf620 100644
--- a/usage/api-connections/openrouter/index.html
+++ b/usage/api-connections/openrouter/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/scale/index.html b/usage/api-connections/scale/index.html
index b6b699897..348dc7ea9 100644
--- a/usage/api-connections/scale/index.html
+++ b/usage/api-connections/scale/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/api-connections/tabbyapi/index.html b/usage/api-connections/tabbyapi/index.html
index 9a1b8b26c..bd6ed9f6f 100644
--- a/usage/api-connections/tabbyapi/index.html
+++ b/usage/api-connections/tabbyapi/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/branches/index.html b/usage/branches/index.html
index 6c61ba114..a8ee456f5 100644
--- a/usage/branches/index.html
+++ b/usage/branches/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -34,11 +34,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/characters/index.html b/usage/characters/index.html
index dffb6b697..908e32e9e 100644
--- a/usage/characters/index.html
+++ b/usage/characters/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/chatting/index.html b/usage/chatting/index.html
index be60a2a72..158861d1b 100644
--- a/usage/chatting/index.html
+++ b/usage/chatting/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/common-settings/index.html b/usage/common-settings/index.html
index f59a8854d..a0cc969dc 100644
--- a/usage/common-settings/index.html
+++ b/usage/common-settings/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/advancedformatting/index.html b/usage/core-concepts/advancedformatting/index.html
index 4adafde4e..f761053aa 100644
--- a/usage/core-concepts/advancedformatting/index.html
+++ b/usage/core-concepts/advancedformatting/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/authors-note/index.html b/usage/core-concepts/authors-note/index.html
index 3ac6a086d..d9fae68b6 100644
--- a/usage/core-concepts/authors-note/index.html
+++ b/usage/core-concepts/authors-note/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/characterdesign/index.html b/usage/core-concepts/characterdesign/index.html
index 130f3a364..bf9ea7841 100644
--- a/usage/core-concepts/characterdesign/index.html
+++ b/usage/core-concepts/characterdesign/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/chatfilemanagement/index.html b/usage/core-concepts/chatfilemanagement/index.html
index bf1197979..a4217f77c 100644
--- a/usage/core-concepts/chatfilemanagement/index.html
+++ b/usage/core-concepts/chatfilemanagement/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
@@ -274,6 +274,7 @@ <h2>
 <li>Text Generation WebUI (oobabooga): <a href="https://github.com/oobabooga/text-generation-webui">https://github.com/oobabooga/text-generation-webui</a></li>
 <li>Agnai: <a href="https://github.com/agnaistic/agnai">https://github.com/agnaistic/agnai</a></li>
 <li>KoboldAI Lite: <a href="https://github.com/LostRuins/lite.koboldai.net">https://github.com/LostRuins/lite.koboldai.net</a></li>
+<li>RisuAI: <a href="https://github.com/kwaroran/RisuAI">https://github.com/kwaroran/RisuAI</a></li>
 </ul>
 <doc-anchor-target id="export-as-jsonl">
     <h2>
diff --git a/usage/core-concepts/connection-profiles/index.html b/usage/core-concepts/connection-profiles/index.html
index a5f405ff8..899281bff 100644
--- a/usage/core-concepts/connection-profiles/index.html
+++ b/usage/core-concepts/connection-profiles/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/data-bank/index.html b/usage/core-concepts/data-bank/index.html
index 190b921ae..68bb95cae 100644
--- a/usage/core-concepts/data-bank/index.html
+++ b/usage/core-concepts/data-bank/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/groupchats/index.html b/usage/core-concepts/groupchats/index.html
index 5caf92641..81971928f 100644
--- a/usage/core-concepts/groupchats/index.html
+++ b/usage/core-concepts/groupchats/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/instructmode/index.html b/usage/core-concepts/instructmode/index.html
index 68d93fed8..e2e572c45 100644
--- a/usage/core-concepts/instructmode/index.html
+++ b/usage/core-concepts/instructmode/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/macros/index.html b/usage/core-concepts/macros/index.html
index 0cb24319a..23e624855 100644
--- a/usage/core-concepts/macros/index.html
+++ b/usage/core-concepts/macros/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/personas/index.html b/usage/core-concepts/personas/index.html
index 73fe24f76..b1aa5883e 100644
--- a/usage/core-concepts/personas/index.html
+++ b/usage/core-concepts/personas/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/slashcommands/index.html b/usage/core-concepts/slashcommands/index.html
index b97dddd96..e19934d66 100644
--- a/usage/core-concepts/slashcommands/index.html
+++ b/usage/core-concepts/slashcommands/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/tags/index.html b/usage/core-concepts/tags/index.html
index 8bd8d2b48..4e38d8ce5 100644
--- a/usage/core-concepts/tags/index.html
+++ b/usage/core-concepts/tags/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/uicustomization/index.html b/usage/core-concepts/uicustomization/index.html
index 614b02d44..252b43ed4 100644
--- a/usage/core-concepts/uicustomization/index.html
+++ b/usage/core-concepts/uicustomization/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/core-concepts/worldinfo/index.html b/usage/core-concepts/worldinfo/index.html
index 6ef6cbde0..4358da187 100644
--- a/usage/core-concepts/worldinfo/index.html
+++ b/usage/core-concepts/worldinfo/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/usage/faq/index.html b/usage/faq/index.html
index 2cd1bcde9..83a794755 100644
--- a/usage/faq/index.html
+++ b/usage/faq/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/hotkeys/index.html b/usage/hotkeys/index.html
index f98a99724..ccb08e2cf 100644
--- a/usage/hotkeys/index.html
+++ b/usage/hotkeys/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/how-to-use-a-self-hosted-model/index.html b/usage/how-to-use-a-self-hosted-model/index.html
index 7a7568a65..269a5447e 100644
--- a/usage/how-to-use-a-self-hosted-model/index.html
+++ b/usage/how-to-use-a-self-hosted-model/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/index.html b/usage/index.html
index be8dbe13a..db5b0c4b0 100644
--- a/usage/index.html
+++ b/usage/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/prompts/cfg/index.html b/usage/prompts/cfg/index.html
index 71200b8f7..47d1054c9 100644
--- a/usage/prompts/cfg/index.html
+++ b/usage/prompts/cfg/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/prompts/context-template/index.html b/usage/prompts/context-template/index.html
index 078435c45..2534f4e7f 100644
--- a/usage/prompts/context-template/index.html
+++ b/usage/prompts/context-template/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/prompts/index.html b/usage/prompts/index.html
index 2810c0f23..d2cafe201 100644
--- a/usage/prompts/index.html
+++ b/usage/prompts/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/prompts/prompt-manager/index.html b/usage/prompts/prompt-manager/index.html
index 0dccb1124..b1b4cdec4 100644
--- a/usage/prompts/prompt-manager/index.html
+++ b/usage/prompts/prompt-manager/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/prompts/tokenizer/index.html b/usage/prompts/tokenizer/index.html
index 68cc516f0..3582a732b 100644
--- a/usage/prompts/tokenizer/index.html
+++ b/usage/prompts/tokenizer/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/quick-start/index.html b/usage/quick-start/index.html
index 0ba444174..43116d135 100644
--- a/usage/quick-start/index.html
+++ b/usage/quick-start/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/remoteconnections/index.html b/usage/remoteconnections/index.html
index 1405182a3..ad10422c4 100644
--- a/usage/remoteconnections/index.html
+++ b/usage/remoteconnections/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/usage/st-reverse-proxy-guide/index.html b/usage/st-reverse-proxy-guide/index.html
index 6a3585d03..7e6e1af58 100644
--- a/usage/st-reverse-proxy-guide/index.html
+++ b/usage/st-reverse-proxy-guide/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,12 +33,12 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
-    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790805324509" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
+    <script id="prism-js" data-cfasync="false" src="../../resources/js/prism.js?v=3.6.0.790895867607" defer></script>
 
     <style>
         a {
diff --git a/usage/st-script/index.html b/usage/st-script/index.html
index 10e663b7a..ad5ef1f15 100644
--- a/usage/st-script/index.html
+++ b/usage/st-script/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/update/index.html b/usage/update/index.html
index b730b9099..fe60a11a4 100644
--- a/usage/update/index.html
+++ b/usage/update/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -34,11 +34,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/user-settings/index.html b/usage/user-settings/index.html
index 989b4d5fc..2be769175 100644
--- a/usage/user-settings/index.html
+++ b/usage/user-settings/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -33,11 +33,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {
diff --git a/usage/user-settings/visual-novel/index.html b/usage/user-settings/visual-novel/index.html
index 54fef0d6a..0f045d9ef 100644
--- a/usage/user-settings/visual-novel/index.html
+++ b/usage/user-settings/visual-novel/index.html
@@ -6,7 +6,7 @@
 
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
-    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790805324509">
+    <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.6.0.790895867607">
 
     <!-- See retype.com -->
     <meta name="generator" content="Retype 3.6.0">
@@ -35,11 +35,11 @@
 
     <script data-cfasync="false">(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
 
-    <link href="../../../resources/css/retype.css?v=3.6.0.790805324509" rel="stylesheet">
+    <link href="../../../resources/css/retype.css?v=3.6.0.790895867607" rel="stylesheet">
 
-    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script data-cfasync="false" src="../../../resources/js/config.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
     <script data-cfasync="false" src="../../../resources/js/retype.js?v=3.6.0" data-turbo-eval="false" defer></script>
-    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790805324509" data-turbo-eval="false" defer></script>
+    <script id="lunr-js" data-cfasync="false" src="../../../resources/js/lunr.js?v=3.6.0.790895867607" data-turbo-eval="false" defer></script>
 
     <style>
         a {