Spaces:
Running
Running
| <a name="readme-top"></a> | |
| [English](readme.md) | [中文](readme-zh_cn.md) | [日本語](readme-ja_jp.md) | Русский | |
| ![][cover] | |
| Мобайл-френдли интерфейс, поддержка множества API (KoboldAI/CPP, Horde, NovelAI, Ooba, OpenAI, OpenRouter, Claude, Scale), ВН-образный режим Вайфу, Stable Diffusion, TTS, поддержка миров (лорбуков), кастомизируемый UI, автоперевод, тончайшая настройка промптов + возможность устанавливать расширения. | |
| Основано на форке [TavernAI](https://github.com/TavernAI/TavernAI) версии 1.2.8 | |
| ## Важные новости! | |
| 1. Чтобы помочь вам быстрее разобраться в SillyTavern, мы создали [сайт с документацией](https://docs.sillytavern.app/). Ответы на большинство вопросов можно найти там. | |
| 2. Почему пропали расширения после апдейта? Начиная с версии 1.10.6, большинство встроенных расширений были конвертированы в формат загружаемых аддонов. Их можно установить обратно через меню "Download Extensions and Assets" на панели расширений (значок с тремя кубиками сверху). | |
| 3. Не поддерживается следующая платформа: android arm LEtime-web. 32-битный Android требует внешнюю зависимость, которую нельзя установить посредством npm. Для её установки потребуется следующая команда: `pkg install esbuild`. После этого продолжайте установку по общей инструкции. | |
| ### Разрабатывается Cohee, RossAscends и всем сообществом SillyTavern | |
| ### Что такое SillyTavern и TavernAI? | |
| SillyTavern — это интерфейс, который устанавливается на ПК (и на Android), который даёт возможность общаться с генеративным ИИ и чатиться/ролеплеить с вашими собственными персонажами или персонажами других пользователей. | |
| SillyTavern — это форк версии TavernAI 1.2.8, который разрабатывается более активно и имеет множество новых функций. Сейчас уже можно сказать, что это две отдельные и абсолютно самостоятельные программы. | |
| ## Скриншоты | |
| <img width="400" alt="image" src="https://github.com/SillyTavern/SillyTavern/assets/61471128/e902c7a2-45a6-4415-97aa-c59c597669c1"> | |
| <img width="400" alt="image" src="https://github.com/SillyTavern/SillyTavern/assets/61471128/f8a79c47-4fe9-4564-9e4a-bf247ed1c961"> | |
| ### Ветки | |
| SillyTavern разрабатывается в двух ветках, чтобы всем категориям пользователей было удобно. | |
| * release -🌟 **Рекомендовано для большинства пользователей.** Самая стабильная ветка, рекомендуем именно её. Обновляется только в момент крупных релизов. Подходит для большей части пользователей. | |
| * staging - ⚠️ **Не рекомендуется для повседневного использования.** В этой ветке весь самый свежий и новый функционал, но будьте аккуратны, поскольку сломаться может в любом месте и в любое время. Только для продвинутых пользователей и энтузиастов. | |
| Если вы не умеете обращаться с git через командную строку, или не знаете, что такое ветка, то не переживайте! Наилучшим вариантом всегда остаётся ветка release. | |
| ### Что ещё нужно, кроме SillyTavern? | |
| Сама по себе SillyTavern бесполезна, ведь это просто интерфейс. Вам потребуется доступ к бэкенду с ИИ, который и будет отыгрывать выбранного вами персонажа. Поддерживаются разные виды бэкендов: OpenAPI API (GPT), KoboldAI (локально или на Google Colab), и многое другое. Больше информации в [FAQ](https://docs.sillytavern.app/usage/faq/). | |
| ### Требуется ли для SillyTavern мощный ПК? | |
| SillyTavern — это просто интерфейс, поэтому запустить его можно на любой картошке. Мощным должен быть бэкенд с ИИ. | |
| ## Есть вопросы или предложения? | |
| ### У нас появился сервер в Discord | |
| | [![][discord-shield-badge]][discord-link] | [Вступайте в наше Discord-сообщество!](https://discord.gg/sillytavern) Задавайте вопросы, делитесь любимыми персонажами и промптами. | | |
| | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- | | |
| Также можно написать разработчикам напрямую: | |
| * Discord: cohee или rossascends | |
| * Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/) или [/u/sillylossy](https://www.reddit.com/user/sillylossy/) | |
| * [Запостить issue на GitHub](https://github.com/SillyTavern/SillyTavern/issues) | |
| ## Эта версия включает | |
| * Глубоко переработанную TavernAI 1.2.8 (переписано и оптимизировано более 50% кода) | |
| * Свайпы | |
| * Групповые чаты: комнаты для нескольких ботов, где персонажи могут говорить друг с другом и с вами | |
| * Чекпоинты и ветки для чатов | |
| * Продвинутые настройки для KoboldAI / TextGen со множеством созданных сообществом пресетов | |
| * Поддержка миров (функция "Информация о мире" / WorldInfo): создавайте свой богатый лор, или экономьте токены для карточек персонажей | |
| * Соединение через [OpenRouter](https://openrouter.ai) для разных API (Claude, GPT-4/3.5 и других) | |
| * Соединение с API [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui) | |
| * Соединение с [AI Horde](https://horde.koboldai.net/) | |
| * Настройку форматирования промптов | |
| ## Расширения | |
| SillyTavern поддерживает расширения, при этом некоторые из ИИ-модулей работают через [SillyTavern Extras API](https://github.com/SillyTavern/SillyTavern-extras) | |
| * Заметки автора / Смещение характера | |
| * Эмоции для персонажей (спрайты) | |
| * Автоматический саммарайз (краткий пересказ) истории чата | |
| * Возможность отправить в чат картинку, которую ИИ сможет рассмотреть и понять | |
| * Генерация картинок в Stable Diffusion (5 пресетов для чата, плюс свободный режим) | |
| * Text-to-speech для сообщений ИИ (с помощью ElevenLabs, Silero, или родной TTS вашей ОС) | |
| Полный список расширений и инструкций к ним можно найти в [документации](https://docs.sillytavern.app/). | |
| ## Улучшения от RossAscends для UI/CSS/общего удобства | |
| * Мобильный интерфейс адаптирован для iOS, добавлена возможность сохранить ярлык на главный экран и открыть приложение в полноэкранном режиме. | |
| * Горячие клавиши | |
| * Up = Редактировать последнее сообщение в чате | |
| * Ctrl+Up = Редактировать ВАШЕ последнее сообщение в чате | |
| * Left = свайп влево | |
| * Right = свайп вправо (ОБРАТИТЕ ВНИМАНИЕ: когда в окне ввода что-то напечатано, клавиши для свайпа не работают) | |
| * Ctrl+Left = посмотреть локальные переменные (в консоли браузера) | |
| * Enter (при нахождении внутри окна ввода) = отправить ваше сообщение ИИ | |
| * Ctrl+Enter = Повторная генерация последнего ответа ИИ | |
| * Страница больше не перезагружается при смене имени пользователя или удалении персонажа | |
| * Отключаемая возможность автоматически соединяться с API при загрузке страницы. | |
| * Отключаемая возможность автоматически загружать последнего открытого персонажа при загрузке страницы. | |
| * Улучшенный счётчик токенов - работает с несохранёнными персонажами, отображает и перманентные, и временные токены | |
| * Улучшенный менеджер чатов | |
| * Файлы с новыми чатами получают читабельные названия вида "(персонаж) - (когда создано)" | |
| * Увеличен размер превью чата с 40 символов до 300. | |
| * Несколько вариантов сортировки списка персонажей (по имени, дате создания, размеру чата). | |
| * Панели настроек слева и справа автоматически скрываются, если щёлкнуть за их пределы. | |
| * При нажатии на значок замка навигационная панель будет закреплена на экране, и эта настройка сохранится между сессиями | |
| * Сам статус панели (открыта или закрыта) также сохраняется между сессиями | |
| * Кастомизируемый интерфейс чата: | |
| * Настройте звук при получении нового ответа | |
| * Переключайтесь между круглыми и прямоугольными аватарками | |
| * Увеличенное вширь окно чата для стационарных ПК | |
| * Возможность включать полупрозрачные панели, стилизованные под стекло | |
| * Настраиваемые цвета для обычного текста, курсива, цитат | |
| * Настраиваемый цвет фона и интенсивность размытия | |
| # ⌛ Установка | |
| > **Внимание!** | |
| > * НЕ УСТАНАВЛИВАЙТЕ В ПАПКИ, КОТОРЫЕ КОНТРОЛИРУЕТ WINDOWS (Program Files, System32 и т.п.). | |
| > * НЕ ЗАПУСКАЙТЕ START.BAT С ПРАВАМИ АДМИНИСТРАТОРА | |
| > * УСТАНОВКА НА WINDOWS 7 НЕВОЗМОЖНА ИЗ-ЗА ОТСУТСТВИЯ NODEJS 18.16 | |
| ## 🪟 Windows | |
| ## Установка через Git | |
| 1. Установите [NodeJS](https://nodejs.org/en) (рекомендуется последняя LTS-версия) | |
| 2. Установите [Git for Windows](https://gitforwindows.org/) | |
| 3. Откройте Проводник (`Win+E`) | |
| 4. Перейдите в папку, которую не контролирует Windows, или создайте её. (пример: C:\MySpecialFolder\) | |
| 5. Откройте командную строку. Для этого нажмите на адресную строку (сверху), введите `cmd` и нажмите Enter. | |
| 6. Когда появится чёрное окошко (командная строка), введите ОДНУ из перечисленных ниже команд: | |
| - для ветки release: `git clone https://github.com/SillyTavern/SillyTavern -b release` | |
| - для ветки staging: `git clone https://github.com/SillyTavern/SillyTavern -b staging` | |
| 7. Когда клонирование закончится, дважды щёлкните по `Start.bat`, чтобы установить зависимости для NodeJS. | |
| 8. После этого сервер запустится, и SillyTavern откроется в вашем браузере. | |
| ## Установка с помощью SillyTavern Launcher | |
| 1. Установите [Git for Windows](https://gitforwindows.org/) | |
| 2. Откройте Проводник (`Win+E`) и создайте или выберите папку, в которую будет установлен лаунчер | |
| 3. Откройте командную строку. Для этого нажмите на адресную строку (сверху), введите `cmd` и нажмите Enter. | |
| 4. Когда появится чёрное окошко, введите следующую команду: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git` | |
| 5. Дважды щёлкните по `installer.bat` и выберите, что именно хотите установить | |
| 6. После завершения установки дважды щёлкните по `launcher.bat` | |
| ## Установка с помощью GitHub Desktop | |
| (Тут речь про git **только** в рамках GitHub Desktop, если хотите использовать `git` в командной строке, вам также понадобится [Git for Windows](https://gitforwindows.org/)) | |
| 1. Установите [NodeJS](https://nodejs.org/en) (latest LTS version is recommended) | |
| 2. Установите [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32) | |
| 3. После завершения установки GitHub Desktop, нажмите `Clone a repository from the internet....` (обратите внимание: для этого шага **НЕ требуется** аккаунт на GitHub) | |
| 4. В меню перейдите на вкладку URL, введите адрес `https://github.com/SillyTavern/SillyTavern`, и нажмите Clone. В поле Local path можно изменить директорию, в которую будет загружена SillyTavern. | |
| 6. Чтобы запустить SillyTavern, откройте Проводник и перейдите в выбранную на предыдущем шаге папку. По умолчанию репозиторий будет склонирован сюда: `C:\Users\[Имя пользователя]\Documents\GitHub\SillyTavern` | |
| 7. Дважды щёлкните по файлу `start.bat`. (обратите внимание: окончание `.bat` может быть скрыто настройками вашей ОС. Таким образом, имя файла будет выглядеть как "`Start`". Дважды щёлкните по нему, чтобы запустить SillyTavern) | |
| 8. После того, как вы дважды щёлкнули по файлу, должно открыться чёрное окошко, и SillyTavern начнёт устанавливать свои зависимости. | |
| 9. Если установка прошла успешно, то в командной строке будет вот такое, а в браузере откроется вкладка с SillyTavern: | |
| 10. Подключайтесь к любому из [поддерживаемых API](https://docs.sillytavern.app/usage/api-connections/) и начинайте переписку! | |
| ## 🐧 Linux и 🍎 MacOS | |
| В MacOS и Linux всё это делается через Терминал. | |
| 1. Установите git и nodeJS (как именно - зависит от вашей ОС) | |
| 2. Клонируйте репозиторий | |
| - для ветки release: `git clone https://github.com/SillyTavern/SillyTavern -b release` | |
| - для ветки staging: `git clone https://github.com/SillyTavern/SillyTavern -b staging` | |
| 3. Перейдите в папку установки с помощью `cd SillyTavern`. | |
| 4. Запустите скрипт `start.sh` с помощью одной из команд: | |
| - `./start.sh` | |
| - `bash start.sh` | |
| ## Установка с помощью SillyTavern Launcher | |
| ### Для пользователей Linux | |
| 1. Откройте любимый терминал и установите git | |
| 2. Загрузите Sillytavern Launcher с помощью команды: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git` | |
| 3. Перейдите в SillyTavern-Launcher: `cd SillyTavern-Launcher` | |
| 4. Запустите лаунчер установки: `chmod +x install.sh && ./install.sh`, затем выберите, что конкретно хотите установить | |
| 5. После завершения установки, запустите лаунчер следующей командой: `chmod +x launcher.sh && ./launcher.sh` | |
| ### Для пользователей Mac | |
| 1. Откройте терминал и установите brew: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` | |
| 2. Затем установите git: `brew install git` | |
| 3. Загрузите Sillytavern Launcher: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git` | |
| 4. Перейдите в SillyTavern-Launcher: `cd SillyTavern-Launcher` | |
| 5. Запустите лаунчер установки: `chmod +x install.sh && ./install.sh` and choose what you wanna install | |
| 6. После завершения установки, запустите лаунчер следующей командой: `chmod +x launcher.sh && ./launcher.sh` | |
| ## 📱 Мобильные устройства - Установка при помощи termux | |
| > **ОБРАТИТЕ ВНИМАНИЕ!** | |
| > | |
| > **На Android-телефонах SillyTavern можно запускать нативно посредством Termux. Обратитесь к гайду, написанному ArroganceComplex#2659:** | |
| > | |
| > * <https://rentry.org/STAI-Termux> | |
| ## Управление ключами от API | |
| SillyTavern сохраняет ключи от ваших API в файле `secrets.json` в папке на сервере. | |
| По умолчанию, ключи не будут отображаться на фронте после их ввода и перезагрузки страницы. | |
| Чтобы включить возможность отображения ключей путём нажатия кнопки в блоке API: | |
| 1. Зайдите в файл `config.yaml` и установите `allowKeysExposure` в положение `true`. | |
| 2. Перезапустите сервер SillyTavern. | |
| ## Удалённое подключение | |
| В основном этим пользуются тогда, когда хотят использовать SillyTavern с телефона, запустив сервер SillyTavern на стационарном ПК в той же Wi-Fi-сети. | |
| Однако это позволит подключаться откуда угодно, а не только вам. | |
| **ВАЖНО: в SillyTavern не предусмотрена возможность использования программы несколькими людьми. Поэтому любой, кто подключится к вашему серверу, получит доступ ко всем вашим персонажам и чатам, а также сможет менять настройки через UI.** | |
| ### 1. Заведение "белого списка" IP-адресов | |
| * Создайте в корневой папке SillyTavern файл с названием `whitelist.txt`. | |
| * Откройте файл в текстовом редакторе и внесите список IP-адресов, с которых хотите разрешить подключение. | |
| *Принимаются как обычные IP-адреса, так и целые диапазоны, размеченные с помощью астериска. Примеры:* | |
| ```txt | |
| 192.168.0.1 | |
| 192.168.0.20 | |
| ``` | |
| или | |
| ```txt | |
| 192.168.0.* | |
| ``` | |
| (диапазон из примера сверху позволит подключаться всем устройствам в локальной сети) | |
| Также принимаются маски CIDR (вида 10.0.0.0/24). | |
| * Сохраните файл `whitelist.txt`. | |
| * Перезапустите сервер ST. | |
| После этого устройства из белого списка смогут подключаться к вашему серверу. | |
| *Обратите внимание: в файле `config.yaml` также имеется массив `whitelist`, который работает по тому же принципу. Однако если существует файл `whitelist.txt`, то этот массив игнорируется.* | |
| ### 2. Получение IP хост-машины с ST | |
| После настройки белого списка адресов, следующим шагом будет получение IP-адреса хост-машины, на которой запущена SillyTavern. | |
| Если хост-машина находится в той же Wi-Fi-сети, то можно воспользоваться её внутренним Wi-Fi-IP-адресом: | |
| * На Windows: нажмите Пуск > введите `cmd.exe` в поиске > в консоли введите команду `ipconfig` и нажмите Enter > найдите пункт `IPv4-адрес`. | |
| Если вы (или кто-то другой) хотите подключаться к хост-машине из другой сети, то вам понадобится ваш публичный IP-адрес. | |
| * Откройте [эту страницу](https://whatismyipaddress.com/) с вашей хост-машины и найдите пункт `IPv4`. На этот адрес и будет подключаться удалённое устройство. | |
| ### 3. Соединить удалённое устройство с хост-машиной ST | |
| Какой бы IP-адрес вы ни выбрали, вам нужно будет вводить его в адресной строке браузера вашего удалённого устройства. | |
| Обычный адрес хост-машины, находящейся в той же Wi-Fi-сети, выглядит примерно так: | |
| `http://192.168.0.5:8000` | |
| НЕ используйте https:// | |
| Только http:// | |
| ### Открытие доступа до ST для всех IP-адресов | |
| Мы не рекомендуем так делать, но вы можете открыть файл `config.yaml` и изменить `whitelistMode` на `false`. | |
| Обязательно нужно удалить (или переименовать) файл `whitelist.txt`, если такой файл есть в корневой директории SillyTavern. | |
| Эта практика считается небезопасной, поэтому, если вы решите так сделать, мы попросим вас установить логин и пароль. | |
| Оба этих параметра настраиваются в `config.yaml` (username и password). | |
| Останется только перезапустить сервер ST, и после этого к вам сможет подключиться любой пользователь вне зависимости от IP-адреса его устройства. Главное, чтобы он знал логин и пароль. | |
| ### Не получается соединиться? | |
| * Создайте входящее/исходящее правило в вашем фаерволле для порта, указанного в `config.yaml`. НЕ ПУТАЙТЕ этот процесс с пробросом портов на роутере. Если по ошибке перепутаете, то на ваш сервер сможет забраться посторонний человек и украсть ваши логи, этого следует избегать. | |
| * Переключите Сетевой профиль на значение "Частные". Для этого зайдите в Параметры > Сеть и Интернет > Ethernet. КРАЙНЕ важно для Windows 11, без этого не получится подключиться даже с правилом фаервола. | |
| ## Проблемы с производительностью? | |
| Попробуйте включить опцию "Отключить эффект размытия" в меню "Пользовательские настройки". | |
| ## Нравится ваш проект! Как помочь? | |
| ### ЧТО ДЕЛАТЬ | |
| 1. Присылайте пулл реквесты | |
| 2. Присылайте идеи и баг-репорты, оформленные по установленным шаблонам | |
| 3. Прежде чем задавать вопросы, прочтите readme и документацию | |
| ### ЧЕГО НЕ ДЕЛАТЬ | |
| 1. Предлагать донаты | |
| 2. Присылать баг-репорты безо всякого контекста | |
| 3. Задавать вопросы, на которые уже отвечали | |
| ## Где найти старые фоны? | |
| Мы двигаемся в сторону 100% уникальности всего используемого контента, поэтому старые фоны были убраны из репозитория. | |
| Они отправлены в архив, скачать их можно здесь: | |
| <https://files.catbox.moe/1xevnc.zip> | |
| ## Авторы и лицензии | |
| **Мы надеемся, что эта программа принесёт людям пользу, | |
| но мы не даём НИКАКИХ ГАРАНТИЙ; мы ни в коем случае не гарантируем того, | |
| что программа СООТВЕТСТВУЕТ КАКИМ-ЛИБО КРИТЕРИЯМ или ПРИГОДНА ДЛЯ КАКОЙ-ЛИБО ЦЕЛИ. | |
| Подробнее можно узнать в GNU Affero General Public License.** | |
| * Базовая TAI от Humi: Лицензия неизвестна | |
| * Модификации от Cohee и производная кодовая база: AGPL v3 | |
| * Дополнения RossAscends: AGPL v3 | |
| * Кусочки TavernAITurbo мода от CncAnon: Лицензия неизвестна | |
| * Различные коммиты и предложения от kingbri (<https://github.com/bdashore3>) | |
| * Расширения и внедрение разного рода удобств - city_unit (<https://github.com/city-unit>) | |
| * Различные коммиты и баг-репорты от StefanDanielSchwarz (<https://github.com/StefanDanielSchwarz>) | |
| * Режим Вайфу вдохновлён работой PepperTaco (<https://github.com/peppertaco/Tavern/>) | |
| * Благодарность Pygmalion University за прекрасную работу по тестированию и за все предлагаемые крутые фичи! | |
| * Благодарность oobabooga за компиляцию пресетов для TextGen | |
| * Пресеты для KoboldAI из KAI Lite: <https://lite.koboldai.net/> | |
| * Шрифт Noto Sans от Google (OFL license) | |
| * Тема Font Awesome <https://fontawesome.com> (Иконки: CC BY 4.0, Шрифты: SIL OFL 1.1, Код: MIT License) | |
| * Клиентская библиотека для AI Horde от ZeldaFan0225: <https://github.com/ZeldaFan0225/ai_horde> | |
| * Пусковой скрипт для Linux от AlpinDale | |
| * Благодарность paniphons за оформление документа с FAQ | |
| * Фон в честь 10 тысяч пользователей в Discord от @kallmeflocc | |
| * Стандартный контент (персонажи и лорбуки) предоставлен пользователями @OtisAlejandro, @RossAscends и @kallmeflocc | |
| * Корейский перевод от @doloroushyeonse | |
| * Поддержка k_euler_a для Horde от <https://github.com/Teashrock> | |
| * Китайский перевод от [@XXpE3](https://github.com/XXpE3), 中文 ISSUES 可以联系 @XXpE3 | |
| <!-- LINK GROUP --> | |
| [back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square | |
| [cover]: https://github.com/SillyTavern/SillyTavern/assets/18619528/c2be4c3f-aada-4f64-87a3-ae35a68b61a4 | |
| [discord-link]: https://discord.gg/sillytavern | |
| [discord-shield]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square | |
| [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge | |