characterai-telegram-bot

CharacterAI telegram chatbot. Made using Aiogram 3.

Contents

1. Install

• Prequisites
• Basic startup
• Adding characters to bot
• Systemd

Install

Prequisites

1. Python 3.11 or higher
2. Systemd (if you want to run bot as service)
3. character.ai token

Basic startup

Clone the repository and install all dependencies by:

pip install -r requirements.txt

Acessing API:

1. Login into character.ai and open DevTools in your browser (F12).
2. Go to Storage -> Local Storage -> char_token, copy value and paste it into .env CHARACTERAI_TOKEN.

Also paste your telegram bot token form @BotFather into .env and start bot:

python main.py

Adding characters

If you want to add some characters to the /characters menu, you need to get name and id and paste into keyboards.choose_character.characters. To get id simply copy it form link:

Systemd

Replace '.example' from characterai-bot.service.example so it's just characterai-bot.service. Then just copy service file to /etc/systemd/system/

sudo systemctl start characterai-bot.service