PyCharacterAI 1.0.0

An unofficial asynchronous api wrapper for Character AI

PyCharacterAI

An unofficial asynchronous api wrapper for Character AI. For Python.

This library is based on the Character AI Unofficial Node API, made by realcoloride.

If you have any questions or problems, please contact me on Discord (xtraf) or Telegram.

Installation

pip install PyCharacterAI

Getting started

First, import and create a new instance of the Client class

from PyCharacterAI import Client

client = Client()

This library allows you to log in in two ways.

1. As a guest (Some api features are not available):

await client.authenticate_as_guest()

2. Using a token.

token = 'TOKEN'
await client.authenticate_with_token(token)

Instructions for getting a token:

1. Open the Character AI website in your browser
2. Open the developer tools F12 and go to the Application tab.
3. Go to the Storage section and click on Local Storage.
4. Look for the @@auth0spajs@@::dyD3gE281MqgISG7FuIXYhL2WEknqZzv::https://auth0.character.ai/::openid profile email offline_access key.
5. Open the body and copy the access token.

вљ пёЏ Warning! Do not share this token with anyone!

Simple example

import asyncio
from PyCharacterAI import Client

token = "TOKEN"


async def main():
    client = Client()
    await client.authenticate_with_token(token)

    username = (await client.fetch_user())['user']['user']['username']
    print(f'Authenticated as {username}')

    character_id = "iV5qb8ttzD7Ytl69U_-ONcW2tW_lrFrOVKExyKJHlJM"  # Lily (by @landon)
    chat = await client.create_or_continue_chat(character_id)

    while True:
        message = input(f'{username}: ')  # In: Hi!

        answer = await chat.send_message(message)
        print(f"Character: {answer.text}")  # Out: hello there! what kind of question you gonna ask me ? i'm here to assist you :)


asyncio.run(main())