Character.AI

An unofficial high level API for character.ai for Python

Warning

Since kramcat's CharacterAI has updated (v1.0.0a1) and cover a lot of this library's functions, there is no need for this library anymore. This library will be archived. Thanks for all of the support.

Introduction

The original idea was from kramcat's CharacterAI. This library aims on ease of use rather than a more functional library. You can get the token to use in this library from your Character AI account. kramcat has made a demonstration on it.

Note

This library is developing, bugs may occur occasionally. Every contribution is greatly appreciated!

Sorry for the messy coding 🤣 If you have any issues, please tell me at Github Issues.

Documentation

You can check the wiki or read my notes in the code, though it is so little.

Usage

Currently this library only supports querying with: Character, Post, User and Chat. You can make a post, comment on it, search information about characters, users, posts, or even chatting

Here is an example of getting basic information from the account:

fromCharAIimport*fromCharAI.helperimportdump# don't mind this messy, it is just for dumpping attributesdefpass_check(x):
ifisinstance(x, CAI):
returnFalsereturnTruefull_dumper=lambdax: (dict([(k, v) fork, vinvars(x).items() ifnotk.startswith('__') andpass_check(x)]) ifhasattr(x, '__dict__') elsestr(x)) ifpass_check(x) else"PASSED"client=Client("YOUR_TOKEN_HERE")
me=client.User.self()
dump(me, default=full_json_dumper)
dump(me.recent_chat(), default=full_dumper)
dump(me.recent_chat2(), default=full_dumper)
dump(me.recent_rooms(), default=full_dumper)

And here is an example of chatting:

fromCharAIimport*client=Client("YOUR_TOKEN_HERE")
chat=client.Chat.open("CHARACTER_ID_HERE")
chat.voice=True# we will turn on voicemessage=Messaging.Object(client, "hello world", img=new.File("path/to/your/image"), img_descr="YOUR_IMAGE_DESCRIPTION")
# or you can use this as well# message = client.Chat.msg("hello world", img=new.File("path/to/your/image"), img_descr="YOUR_IMAGE_DESCRIPTION")# We will try to send our messagetry:
# the reply function is used to send messageresponse=chat.reply(message)
# if you have alternatives, you can select by its uuid# response = chat.reply(message, uuid="0000-0000-0000-0000")# the reply function returns a Response object, with its attributes: `replies` and `audios`# `audios` is the list of new.MP3 object, use new.MP3.binaries() to get the binaries# `replies` containing replies from the bot# to get alternative response, use chat.next()response=chat.next()
excepterrors.ServerError:
print("Retrying...")
try:
# After you've sent the message for the first time, you can retry sending it like thisresponse=message.retry()
excepterrors.ServerError:
print("Failed!")

Bottom

Note

I built this library as a hobby, so I will not update it frequently. Stay tuned if you find something interesting.