1. Overview

SillyTavern is a frontend that enhances roleplaying by organizing and displaying text interactions with an AI model. The AI itself operates within a context window; a blank slate of tokens where it processes input (your request) and generates output (its reply). It’s unaware of SillyTavern’s features like character cards, presets, or lorebooks. Instead, SillyTavern takes text from these elements, arranges them in a specific order (customizable by dragging or enabling/disabling lines), and feeds them into the model’s context via an API request.

For a granular breakdown, read more here.

2. Branches

SillyTavern operates with two primary branches:

  • Release Branch: The stable version recommended for most users. It includes thoroughly tested features and is updated periodically.
  • Dev Branch: The bleeding-edge version for enthusiasts and testers. It offers the latest features but may contain bugs or unfinished elements.

To switch branches, use Git commands like git checkout release or git checkout dev after cloning the repository. Choose based on your preference for stability versus cutting-edge functionality.

3. Character Cards

Character Cards are at the heart of SillyTavern, defining the personalities and behaviors of the AI entities you interact with. These cards are JSON-based files containing details like name, description, personality traits, and example dialogues.

  • Creating a Card: Use the built-in editor or import existing cards from communities like CharacterHub.
  • Customization: Add first messages, scenarios, and even custom prompts to shape how the AI responds.
  • Sharing: Export your creations to share with others or import cards to expand your roster.

Below is an example of a simple Character Card for a fictional character named “Elara, the Forest Witch.” This example includes typical fields you might find in SillyTavern, based on its documentation and common practices.

Example Character Card: Elara, the Forest Witch

{
  "name": "Elara",
  "description": "Elara is a mysterious witch who lives deep in an enchanted forest. She’s centuries old but appears as a young woman with emerald eyes and flowing silver hair. Her voice is soft yet commanding, and she’s known for her wisdom, sharp wit, and a touch of mischief. She protects the forest and its creatures, but she’s wary of outsiders.",
  "personality": "Curious, cunning, protective, slightly sarcastic, and deeply knowledgeable about nature and magic.",
  "scenario": "You stumble into Elara’s forest after getting lost on a hike. She appears before you, her eyes glinting with suspicion, and demands to know why you’ve trespassed into her domain.",
  "first_message": "Well, well, what do we have here? A lost little wanderer, tripping over roots in *my* forest. Tell me, what brings you to a place where mortals rarely tread?",
  "example_dialogue": [
    {
      "user": "I didn’t mean to intrude! I’m just lost.",
      "elara": "Lost, you say? The forest doesn’t guide just anyone to me. Perhaps it’s no accident you’re here. Speak quickly—I’ve potions brewing and no patience for fools."
    },
    {
      "user": "Can you help me find my way back?",
      "elara": "Help you? Hmph. I could, but what’s in it for me? Offer something useful, or I’ll turn you into a toad and be done with it."
    }
  ],
  "avatar": "elara_avatar.png",
  "creator": "ForestFan42",
  "tags": ["fantasy", "witch", "nature", "sassy"]
}

Breakdown of the Fields:

  1. name: The character’s name—short and simple.
  2. description: A detailed rundown of their appearance, background, and vibe. This helps the AI visualize and embody the character.
  3. personality: Key traits that shape how the character responds. The AI uses this to stay consistent.
  4. scenario: Sets the stage for the first interaction, giving context to the chat.
  5. first_message: The character’s opening line when you start a conversation. It sets the tone.
  6. example_dialogue: Sample exchanges to show the AI how the character talks and reacts. This trains the model for better responses.
  7. avatar: Optional file name for an image (e.g., PNG) to visually represent the character in SillyTavern.
  8. creator: Who made the card—useful for sharing or crediting.
  9. tags: Keywords to categorize the character for easy searching.

How to Use It in SillyTavern:

  1. Open SillyTavern’s character editor (accessible via the UI).
  2. Copy this JSON into the editor or create a new card manually.
  3. Save it as Elara.json (or import it if it’s already a file).
  4. Load Elara into a chat and start talking!

This is a basic example, but you can expand it with more fields like custom prompts, lore entries (via World Info), or specific generation settings, depending on how complex you want Elara to be. NOTE: The model has absolutely no idea what are “cards”, “presets”, “fields”, “lorebooks”, etc., and these fields are a SillyTavern feature only.

4. Key Features

SillyTavern stands out with its powerful and versatile feature set. Here’s a closer look at what it offers:

4.1 Advanced Text Generation

SillyTavern supports advanced formatting to refine AI outputs. You can tweak parameters like token limits, temperature, and repetition penalties to control creativity and coherence. It also supports custom prompt engineering, allowing you to guide the AI’s tone, style, and context with precision. Learn more here.

4.2 World Info

The World Info feature lets you create a detailed knowledge base for your AI characters. By adding entries about locations, events, or lore, you ensure the AI stays consistent with your story’s universe. It’s perfect for immersive role-playing or complex narratives. Details here.

4.3 Group Chats

Why chat with one character when you can have a whole group? Group Chats allow multiple AI characters to interact with each other and you, simulating dynamic conversations. Customize their interactions and watch the dialogue unfold. More info here.

4.4 Rich UI Options

SillyTavern’s interface is highly customizable. Adjust themes, layouts, and chat styles to suit your preferences. Whether you prefer a minimalist look or a vibrant design, the UI options let you tailor the experience. Explore customization here.

4.5 User Personas

Define your own persona to shape how characters perceive and respond to you. Set traits, backstories, or even specific quirks to make every interaction feel personal and tailored. Dive into personas here.

4.6 Retrieval-Augmented Generation

With the Data Bank feature, SillyTavern enhances responses by pulling from external text sources you provide. Upload documents or notes, and the AI will reference them to deliver informed, context-aware replies. Learn how here.

4.7 Chat Commands and Scripting Engine

Take control with slash commands (e.g., /sys for system messages) to manage chats efficiently. The ST Scripting Engine goes further, enabling custom logic and automation using JavaScript-like syntax. Check out commands here and scripting here.

5. Extensions

SillyTavern’s extensibility takes it to the next level. Here are some standout extensions:

5.1 Sprites

Add visual flair with expression-based sprites that change based on a character’s mood or dialogue. Perfect for bringing your chats to life visually. Details here.

5.2 Chat History Summary

Keep track of long conversations with the Summarize extension. It condenses chat histories into concise overviews, saving you time. Learn more here.

5.3 Automatic UI & Chat Translation

Break language barriers with real-time translation of the UI and chat text. Communicate effortlessly in multiple languages. Info here.

5.4 TTS (Text-to-Speech)

Hear your characters speak with the TTS extension. Choose from various voices to add an auditory dimension to your experience. Details here.

5.5 Stable Diffusion/FLUX/DALL-E Image Generation

Generate custom images for characters or scenes using powerful AI tools like Stable Diffusion, FLUX, or DALL-E. Note: This feature requires additional setup and compatible backends.

Enhance chats with real-time info from the web. The Web Search extension lets the AI fetch and incorporate online data into responses. More here.

Although SillyTavern is more than just a chat tool, but also a playground for creativity and interaction, like any AI tool, it can be abused. System jailbreaks that have been floating around 4chan enable some users to break safety and prompt models for unethical role-playing, something you should keep in mind when toying with ST and interacting with its related prompt jailbreaks on the dark web.