# Xoul Creation Interface

***

<figure><img src="/files/tgV7WaT4bD38SZpfLYMs" alt=""><figcaption></figcaption></figure>

<h2 align="center">Xoul Basics</h2>

***

<figure><img src="/files/7WMk3f6AnMKJIUjnMSRa" alt=""><figcaption></figcaption></figure>

<h3 align="center">Name, Gender &#x26; Age</h3>

{% tabs %}
{% tab title="Name" %}
This is where you will enter the name of your Xoul. &#x20;

Any alphanumeric characters or symbols can be used in this field. Maximum of 100 characters allowed.

### Name & Variable

The variables `{{char}}` and `xoul` are **placeholders** that will be swapped with the **exact** text you write in this field.&#x20;

As in, quite simply, you type `{{char}}` and the **platform** turns those 8 characters into the exact text written into the 'name' field, as shown here with the Greeting:

<figure><img src="/files/Dn3er4bpnFg9f3vZkeyb" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/XIKCZnQzq4lyWLbhhH7B" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The conversion of `{{char}}` to the exact text written within the **name** field happens **before** the model receives the text. Whether you write `{{char}}`, `xoul` or simply `David` will have zero effect on the model's ability to understand who you are talking about.&#x20;
{% endhint %}
{% endtab %}

{% tab title="Gender" %}
Selection for your Xoul's gender listed as Male, Female, Non-Binary or Prefer Not to Say.&#x20;

{% hint style="success" %}
Type in any text and press enter (or tap create) to create a unique gender.
{% endhint %}

<figure><img src="/files/X0fWHrnXLZd7mBso2ETo" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The AI can read the gender field and will use the information contained there to use appropriate pronouns.
{% endhint %}
{% endtab %}

{% tab title="Age" %}
A numerical value between 18 and 100000. The AI has access to this information, but its effect is minimal.&#x20;

For Xouls representing things that do not have a standard age, don't stress. Just put in whatever number feels appropriate to you.

{% hint style="danger" %}
**All characters featured on Xoul.AI, no matter what content they appear in, must be at least 18 years of age or older.**

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#depictions-of-minors)
{% endhint %}

{% hint style="success" %}
The age written into this text field is read by the model.
{% endhint %}
{% endtab %}
{% endtabs %}

***

<figure><img src="/files/ZquYGhPpmXB6hnUzY5XP" alt=""><figcaption></figcaption></figure>

<h2 align="center">Xoul Persona</h2>

***

<figure><img src="/files/BJOJeSGga0BXQDNlmCoA" alt=""><figcaption></figcaption></figure>

<h3 align="center">Description</h3>

The Description & Advanced Definition is the "guts" of your Xoul. It acts as the entire text field available for defining who & what the content is about. It can be written in any number of ways and how it is written will have a direct effect on the outcome of the model's behavior within the chat.

For a Xoul which represents a single character this will include things like who the character is, what they look like, act like, what sort of personal opinions they hold, how they dress, who they know, etc.

For a Xoul which represents a world, story, or premise it might include information about a whole cast of characters, settings, world logic, etc.

For more experimental Xouls which act as utilities (such as a dictionary Xoul) or something like a text-based adventure game it will just need to contain the instructions necessary for the model to understand how and what it should be doing.

{% hint style="warning" %}
The Description, Advanced Definition and Chat Samples share a character limit. You have 12000 characters (or 17000 characters for Gold tier subscribers) to define your character across all three text fields.&#x20;

* Description: 5000 characters
* Advanced Definition: 5000 characters
* Chat Samples: 2000 characters

Total: 12,000 characters used.
{% endhint %}

{% columns %}
{% column %}
{% hint style="info" %}
The text written into the Description will be visible on the profile page of the Xoul for any user to read.
{% endhint %}

{% endcolumn %}

{% column %}
{% hint style="success" %}
Click the sparkles in the lower right corner to have the AI generate a description for you that uses the name, age and gender provided.
{% endhint %}

{% endcolumn %}

{% column %}
{% hint style="danger" %}
Do NOT define any minors within your content. Xouls cannot include characters under the age of 18, even as supplementary or background characters.

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#depictions-of-minors)
{% endhint %}

{% endcolumn %}
{% endcolumns %}

***

<figure><img src="/files/6AWWoFQ9PXUq4fqMv2ns" alt=""><figcaption></figcaption></figure>

<h3 align="center">Intro &#x26; Greeting</h3>

{% columns %}
{% column %}

<h4 align="center">Intro</h4>

Once called the "Default Scenario", the Intro can serve two purposes, which can overlap:

The intro is the "back of the book" blurb that acts as the premise of the chat or character the Xoul represents, serving as the background information leading into the Greeting.

{% hint style="info" %}
This is visible to users who start chats with these Xouls and will be displayed at the top of the chat interface.
{% endhint %}
{% endcolumn %}

{% column %}

<h4 align="center">Greeting</h4>

This will print within the chat as the first message.

If the Greeting is left blank a small model will generate a random Greeting when a chat is started using this Xoul.

{% hint style="success" %}
The Greeting has a powerful influence on how the AI will write at the start of a chat. The use of \*italics\* around narration, the lack of "quotation marks" around dialogue, a complete lack of dialogue, the way the narration is written, the tone, tense, perspective and even length of the Greeting will influence the model to *continue* to write like that.

The Greeting, just like Chat Samples, should be representative of how you'd like the AI to write.
{% endhint %}

{% hint style="warning" %}
**The Greeting is not permanently remembered.** All other text within a Xoul, however, is permanently remembered.

&#x20; ↳ [Memory & Context](/xoul.ai-official-guide/navigation-and-information/subscriptions/memory-and-context.md)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

***

<figure><img src="/files/ffF3yctSOqPSAV2bZr2C" alt=""><figcaption></figcaption></figure>

<h3 align="center">Response Styles</h3>

The Response Styles are Xoul.AI's various available system prompts which will act as the instructions guiding the way the model responds within the chat.

<details>

<summary>Roleplay (Character-Focused)</summary>

A system prompt that gives character focused roleplay instructions. It is flexible and adaptive to most user's needs.&#x20;

</details>

<details>

<summary>Novel (Slowburn)</summary>

A system prompt influencing the model to use a more slow, descriptive style of prose with attention to details, characters, and more expansive use of supplementary characters.

</details>

<details>

<summary>Realistic (Simple)</summary>

A system prompt that uses shorter, less narrative heavy responses. More for casual chatting.

</details>

<details>

<summary>Lust (Explicit)</summary>

A system prompt which heavily influences and aids with explicit roleplay handling. This will heavily encourage the AI to steer the chat into explicit territory.&#x20;

{% hint style="success" %}
Lust style is only available to users with the Safety Filter toggled off.
{% endhint %}

</details>

<details>

<summary>Word of Caution: Custom Prompts</summary>

The final option, Custom, is a system prompt **override**, replacing Xoul.AI's system prompt with one of your own design.

{% hint style="danger" %}
The Custom Response Style is **NOT** and should not be used as a "place to put prompts". It requires a **full instructional prompt**.

This is a power user option and should be used with care.

&#x20; ↳ [Response Style & Length](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/response-style-and-length.md#use-responsibly)

&#x20; ↳ [Response Style & Length](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/response-style-and-length.md#custom-system-prompt)
{% endhint %}

{% hint style="info" %}
The Response Styles provided by Xoul.AI includes most of these clauses and structure already.
{% endhint %}

</details>

***

<figure><img src="/files/2QySd0eAeJ8hsqWKbxbw" alt=""><figcaption></figcaption></figure>

<h3 align="center">Advanced Settings</h3>

{% columns %}
{% column %}

<h4 align="center">Advanced Definition</h4>

This is a direct continuation of the Description, the only difference being that it is not visible to anyone except the AI.

{% hint style="info" %}
**Reminder:** The Description, Advanced Definition & Chat Samples all have a **shared** character limit.
{% endhint %}
{% endcolumn %}

{% column %}

<h4 align="center">Chat Samples</h4>

**Chat Samples**&#x20;

* Examples of how your character should talk or respond.
* Each one can be multiple lines long (including blank lines), and you separate them by starting a new one with `{{char}}:` or `xoul:`.
* If your character isn’t sounding quite right, adding a few chat samples helps the AI copy the exact vibe you want.
  {% endcolumn %}
  {% endcolumns %}

***

### Override Default Formatting

Once the Xoul is created, click the edit button and navigate to the bottom of the Advanced Options section to find this:

<figure><img src="/files/HTZSCuH5AX53r4c9TNRT" alt=""><figcaption></figcaption></figure>

By leaving this toggled **off** the model will use "quotation marks" around dialogue and \*asterisks\* around narration, the standard "roleplay" format, using third person perspective.

By toggling this **on** the model will no longer have those instructions and will instead focus on using the format you stipulate in Xoul or more heavily follow the formatting, perspective and tense found in Chat Samples and the Greeting.

***

<figure><img src="/files/3rOaxr5JdfPQKVdYDREd" alt=""><figcaption></figcaption></figure>

<h3 align="center">Ad Ons - Lorebooks</h3>

You can attach up to **three Lorebooks.**

{% hint style="info" %}
A Lorebook provided inside of a Xoul will automatically be used within the chat, although users can remove provided Lorebooks or even replace them with different ones.

&#x20; ↳ [Lorebooks](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/lorebooks.md)
{% endhint %}

**A Lorebook is a collection of entry cards that&#x20;*****can*****&#x20;but&#x20;*****will not always*****&#x20;be referenced when the model generates a response.**

A Lorebook's entries should contain **supplementary** information that you would like the model to know **when** the topic comes up. Foundational information, however, belongs in the Xoul.

***

<figure><img src="/files/YvEMiOyyZgcBHzHfSkj6" alt=""><figcaption></figcaption></figure>

<h2 align="center">Xoul Appearance</h2>

***

<figure><img src="/files/UvdCzt2goWwb0tRZi8jF" alt=""><figcaption></figcaption></figure>

<h3 align="center">Icon &#x26; Voice</h3>

{% columns %}
{% column %}

<h4 align="center">Icon</h4>

**A Picture for your Xoul is required** \
Choose or create the image that represents your character.\
You can:

* Spend Cells to **generate an image** using Xoul’s image model.
* **Select** from a variety of pre-generated image categories.
* **Upload** your own custom image.

{% hint style="info" %}
Icons can be square or rectangular; they’ll automatically center when displayed in searches.
{% endhint %}

{% hint style="danger" %}
Images can never be explicit. Graphic explicit images will not be approved for public display.

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#images)
{% endhint %}

{% hint style="danger" %}
All characters pictured within an image must appear to be 18 years of age or older. Do **not** use images that depict or contain teens, children, toddlers or babies even within the background of the image.

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#images-age)
{% endhint %}
{% endcolumn %}

{% column %}

<h4 align="center">Voice</h4>

Pick a voice for your character from the menu.\
You can **preview each voice** by clicking the play icon next to its name to hear how it sounds before selecting it.

You can create custom voices, which will be included in this list.

<figure><img src="/files/iibuhlox4bvqvRod8Qm2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Clicking the pencil icon within the edit Xoul page will allow you to change the voice later.
{% endhint %}

&#x20; ↳ [Voices](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/voices.md)
{% endcolumn %}
{% endcolumns %}

***

<figure><img src="/files/Qm6N0Cz646m1mo4IsbfP" alt=""><figcaption></figcaption></figure>

<h2 align="center">Xoul Social</h2>

***

<figure><img src="/files/wTKLBdtREvCQeRhHygK9" alt=""><figcaption></figcaption></figure>

<h3 align="center">Handle, Tagline &#x26; Creator Memo</h3>

{% tabs %}
{% tab title="Handle" %}
Your handle must be **unique** because it is the **permanent** URL of the Xoul.&#x20;

{% hint style="info" %}
Handles can only contain alphanumeric characters, periods and hyphens. No other special characters may be used.
{% endhint %}

{% hint style="danger" %}
Handles can never be changed, and they are **NOT** reusable, even if you delete the Xoul with that handle.
{% endhint %}
{% endtab %}

{% tab title="Tagline" %}
Write a short line that will be displayed on the explore page.

{% hint style="warning" %}
Taglines are a great place to put Content Warnings for content with sensitive themes.&#x20;

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#text-and-concept-rules)
{% endhint %}
{% endtab %}

{% tab title="Creator Memo" %}
A public facing text field that is displayed on the Xoul's profile page as the 'Bio' but which is **not** read by the AI.

To be used however you please.

{% hint style="warning" %}
If your content explores sensitive themes, the inclusion of a content / trigger warning is strongly encouraged.

The user should always know what they're about to interact with.

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#text-and-concept-rules)
{% endhint %}
{% endtab %}
{% endtabs %}

***

<figure><img src="/files/SaCqhJG8YTw6LqcAg02h" alt=""><figcaption></figcaption></figure>

<h3 align="center">Visibility &#x26; Tags</h3>

{% columns %}
{% column %}

<h4 align="center">Visibility</h4>

* **Public:** Visible to everyone and appears in search results.
* **Unlisted:** Hidden from search results but still accessible through a direct link.
* **Private:** Only visible and usable by you. It will only appear in your own search results.

{% hint style="warning" %}
If you save your content to Unlisted or Public, but find it on Private inexplicably it is either being blocked by the automod or has been moderated by Xoul.AI's moderation team.

Go to the safety page within your account settings to check your moderation history & review the rules.

&#x20; ↳ [Moderation Overview](/xoul.ai-official-guide/navigation-and-information/moderation-overview.md)
{% endhint %}
{% endcolumn %}

{% column %}

<h4 align="center">Community Tags</h4>

Add up to seven tags to help others find your content.

Tags make your Xoul appear in search results and show what it’s about.\
You can type custom tags or choose from a list of common ones.\
Use tags to both **improve visibility** and **describe your content clearly**

{% hint style="danger" %}
Use the NSFW tag on content which has a graphically explicit greeting, heavily leans towards explicit roleplay OR contains sensitive topics or themes.

&#x20; ↳ [Content Policies in Detail](/xoul.ai-official-guide/navigation-and-information/moderation-overview/content-policies-in-detail.md#text-and-concept-rules)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

### Allow Community Posts

<figure><img src="/files/7L1VMZ0iXwUJXemfCBZe" alt=""><figcaption></figcaption></figure>

This option turns **on** or **off** the ability for other users to tag posts to your content. If you would like to remove the ability for other people to attach images, videos, or other content to your Xouls, keep this toggled **off**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xoul-ai-official-documentation.gitbook.io/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/xouls/xoul-creation-interface.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.