Skip to main content

An unofficial API for character.ai for Python

Project description

💬 CharacterAI

Tag Downloads

An unofficial API for Character AI for Python using Playwright

Discord Server

If you have any questions/problems/suggestions or you just want to talk about AI and CharacterAI - welcome to my new Discord server

discord.gg/CZdQWzMV

💻 Installation

pip install characterai

If you don't have Playwright installed, it will install automatically. But installing Playwright via pip is not enough, you need to install browsers

python -m playwright install

Also, if you have Linux, you will need to install additional packages

python -m playwright install-deps

📚 Documentation

The library has documentation! It says everything about this library

🔑 Get Token

DO NOT SHARE IT The token is needed for authorization and operation of requests from your account

  1. Open DevTools in your browser
  2. Go to Storage -> Local Storage -> char_token
  3. Copy value

📙 Example

from characterai import PyCAI

client = PyCAI('TOKEN')
client.start()

char = input('Enter CHAR: ')

chat = client.chat.get_chat(char)

participants = chat['participants']

if not participants[0]['is_human']:
    tgt = participants[0]['user']['username']
else:
    tgt = participants[1]['user']['username']

while True:
    message = input('You: ')

    data = client.chat.send_message(
        chat['external_id'], tgt, message
    )

    name = data['src_char']['participant']['name']
    text = data['replies'][0]['text']

    print(f"{name}: {text}")

⚠️ Issues

First, you should add headless=False in client.start() and describe what happens in the browser and take screenshot of the browser Also, you should have a screenshot of your error and code Describe how to cause an error, when the error is called, how often, whether it was before, etc. You can write about the error in Github Issues, and you can also write to Discord server

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

characterai-0.7.1.tar.gz (8.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page