> For the complete documentation index, see [llms.txt](https://pycai.gitbook.io/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pycai.gitbook.io/welcome/api/character/create.md).

# create

<pre class="language-python"><code class="lang-python"><strong>client.character.create('NAME', 'GREETING', 'IDENTIFIER')
</strong></code></pre>

### greeting <mark style="color:green;">\[str]</mark>

What would say to start a conversation?

### identifier <mark style="color:green;">\[str]</mark>

Character `tgt`, the site generates a special value, but you can write anything there&#x20;

### name <mark style="color:green;">\[str]</mark>

This will be the name your Character uses in chat.

### avatar\_rel\_path <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

The path to the avatar image on the server. You can create this path with the `upload_image()` function

### base\_img\_prompt <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

I don't know exactly what it is, but most likely you can do a basic setup of promts for images

### categories <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Which category does the character belong to. Categories can be viewed in `character.categories()`

### copyable <mark style="color:green;">\[bool]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Most likely responsible for whether others can copy your character's settings

### definition <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Example conversations and information to define your Character. The first 15-30 messages are the most important

### description <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

In just a few words, how would test describe themselves?

### img\_gen\_enabled <mark style="color:green;">\[bool]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Characters can generate images.

### title <mark style="color:green;">\[str]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

In just a few words, how would test describe themselves?

### visibility <mark style="color:green;">\[bool]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

Who can view your post, can be `PUBLIC` or `UNLISTED` or `PRIVATE`

### token <mark style="color:green;">\[string]</mark> <mark style="color:purple;">(</mark>*<mark style="color:purple;">optional)</mark>*

You can set a specific token for the function, it will be executed from the specified token