| <a name="readme-top"></a> | |
| ![][cover] | |
| <div align="center"> | |
| English | [German](readme-de_de.md) | [中文](readme-zh_cn.md) | [繁體中文](readme-zh_tw.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md) | [한국어](readme-ko_kr.md) | |
| [](https://github.com/SillyTavern/SillyTavern/stargazers) | |
| [](https://github.com/SillyTavern/SillyTavern/forks) | |
| [](https://github.com/SillyTavern/SillyTavern/issues) | |
| [](https://github.com/SillyTavern/SillyTavern/pulls) | |
| </div> | |
| --- | |
| SillyTavern provides a single unified interface for many LLM APIs (KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral and more), a mobile-friendly layout, Visual Novel Mode, Automatic1111 & ComfyUI API image generation integration, TTS, WorldInfo (lorebooks), customizable UI, auto-translate, more prompt options than you'd ever want or need, and endless growth potential via third-party extensions. | |
| We have a [Documentation website](https://docs.sillytavern.app/) to answer most of your questions and help you get started. | |
| ## What is SillyTavern? | |
| 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. | |
| Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 200 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists. | |
| ## Our Vision | |
| 1. We aim to empower users with as much utility and control over their LLM prompts as possible. The steep learning curve is part of the fun! | |
| 2. We do not provide any online or hosted services, nor programmatically track any user data. | |
| 3. SillyTavern is a passion project brought to you by a dedicated community of LLM enthusiasts, and will always be free and open sourced. | |
| ## Do I need a powerful PC to run SillyTavern? | |
| 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, but actual requirements may vary depending on the model and backend you choose to use. | |
| ## Questions or suggestions? | |
| ### Discord server | |
| | [![][discord-shield-badge]][discord-link] | [Join our Discord community!](https://discord.gg/sillytavern) Get support, share favorite characters and prompts. | | |
| | :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- | | |
| Or get in touch with the developers directly: | |
| * Discord: cohee, rossascends, wolfsblvt | |
| * Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/), [/u/sillylossy](https://www.reddit.com/user/sillylossy/), [u/Wolfsblvt](https://www.reddit.com/user/Wolfsblvt/) | |
| * [Post a GitHub issue](https://github.com/SillyTavern/SillyTavern/issues) | |
| ### I like your project! How do I contribute? | |
| 1. Send pull requests. Learn how to contribute: [CONTRIBUTING.md](../CONTRIBUTING.md) | |
| 2. Send feature suggestions and issue reports using the provided templates. | |
| 3. Read this entire readme file and check the documentation website first, to avoid sending duplicate issues. | |
| ## Screenshots | |
| <img width="500" alt="image" src="https://github.com/user-attachments/assets/9b5f32f0-c3b3-4102-b3f5-0e9213c0f50f"> | |
| <img width="500" alt="image" src="https://github.com/user-attachments/assets/913fdbaa-7d33-42f1-ae2c-89dca41c53d1"> | |
| ## Installation | |
| For detailed installation instructions, please visit our documentation: | |
| * **[Windows Installation Guide](https://docs.sillytavern.app/installation/windows/)** | |
| * **[MacOS/Linux Installation Guide](https://docs.sillytavern.app/installation/linuxmacos/)** | |
| * **[Android (Termux) Installation Guide](https://docs.sillytavern.app/installation/android-(termux)/)** | |
| * **[Docker Installation Guide](https://docs.sillytavern.app/installation/docker/)** | |
| ## License and credits | |
| **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.** | |
| * [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8 by Humi: MIT License | |
| * Portions of CncAnon's TavernAITurbo mod used with permission | |
| * Visual Novel Mode inspired by the work of PepperTaco (<https://github.com/peppertaco/Tavern/>) | |
| * Noto Sans font by Google (OFL license) | |
| * Lexer/Parser by Chevrotain (Apache-2.0 license) <https://github.com/chevrotain/chevrotain> | |
| * Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) | |
| * Default content by @OtisAlejandro (Seraphina character and lorebook) and @kallmeflocc (10K Discord Users Celebratory Background) | |
| * Docker guide by [@mrguymiah](https://github.com/mrguymiah) and [@Bronya-Rand](https://github.com/Bronya-Rand) | |
| * kokoro-js library by [@hexgrad](https://github.com/hexgrad) (Apache-2.0 License) | |
| ## Top Contributors | |
| [](https://github.com/SillyTavern/SillyTavern/graphs/contributors) | |
| <!-- LINK GROUP --> | |
| [cover]: https://github.com/user-attachments/assets/01a6ae9a-16aa-45f2-8bff-32b5dc587e44 | |
| [discord-link]: https://discord.gg/sillytavern | |
| [discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge | |