text-generation-webui/docs/Chat-mode.md
2023-05-08 12:35:03 -03:00

2.4 KiB

Chat characters

Custom chat mode characters are defined by .yaml files inside the characters folder. An example is included: Example.yaml

The following fields may be defined:

Field Description
name or bot The character's name.
your_name or user (optional) Your name. This overwrites what you had previously written in the Your name field in the interface.
context A string that appears at the top of the prompt. It usually contains a description of the character's personality.
greeting (optional) The character's opening message when a new conversation is started.
example_dialogue (optional) A few example messages to guide the model.
turn_template (optional) Used to define where the spaces and new line characters should be in Instruct mode. See the characters in characters/instruction-following for examples.

Special tokens

  • {{char}} or <BOT>: are replaced with the character's name
  • {{user}} or <USER>: are replaced with your name

These replacements happen when the character is loaded, and they apply to the context, greeting, and example_dialogue fields.

How do I add a profile picture for my character?

Put an image with the same name as your character's yaml file into the characters folder. For example, if your bot is Character.yaml, add Character.jpg or Character.png to the folder.

Is the chat history truncated in the prompt?

Once your prompt reaches the 2048 token limit, old messages will be removed one at a time. The context string will always stay at the top of the prompt and will never get truncated.

Pygmalion format characters

These are also supported out of the box. Simply put the JSON file in the characters folder, or upload it directly from the web UI by clicking on the "Upload character" tab at the bottom.

Chat styles

Custom chat styles can be defined in the text-generation-webui/css folder. Simply create a new file with name starting in chat_style- and ending in .css and it will automatically appear in the "Chat style" dropdown menu in the interface. Examples:

chat_style-cai-chat.css
chat_style-TheEncrypted777.css
chat_style-wpp.css

You should use the same class names as in chat_style-cai-chat.css in your custom style.