weismanns / character.ai-ts

Unofficial Javascript/Typescript wrapper for character.ai (https://beta.character.ai/)

Character.AI

Unofficial Javascript/Typescript Wrapper for character.ai

• Getting started

AS OF 3/14/2023 This seems to only work for Bun

Initialize a Client and Login

import  Log_in,{Client}  from 'character.ai';

let client:Client = await Log_in("token") // returns the Client

the default of the second arg of innit is false, will start a new chat if it set to true, if there is no previous history between character and client it will create one

const character = await client.init("characterId",true) // returns a Character and sets client's current character to it 
const msg :Msg = await client.sendMsg("Hello!") // returns a Message Object
const History : Array<Msg> = client.history // returns an Array of Messages

to get user info

const user = client.me // returns a User Object

lookFor returns an Array of Characters that has the same name as the first arg the second argument sorts the array by the amount of interactions the characters has, the default is "score"

const characters : Array<char> = await client.lookFor("characterName","interactions") // returns an Array of Characters

This project was created using bun init in bun v0.5.7. Bun is a fast all-in-one JavaScript runtime.

character.ai-ts's Issues

NodeJS and Deno

it seems Character.ai upgraded their security, This package still works With Bun Runtime
although, i can find workarounds, it seems highly ineffective and it will just be too slow for my liking, if you still want that support regardless, i may make a separate Repo if the demand is high enough lol.
Bun works great with this since It has support CommonJS compiles to ESM regardless, as an Illustration this is now possible
const Login = require("character.ai-ts").default

now that's out the way, that doesn't mean i'll stop looking for better solutions!