Chibi is a Python-based Telegram chatbot that allows users to interact with the powerful ChatGPT and DALL-E neural networks. The bot is asynchronous, providing fast response times and serving multiple users simultaneously without blocking each other's requests. Chibi supports session management, enabling ChatGPT to remember the user's conversation history. The conversation history is stored for a configurable duration and is preserved even if the bot is restarted.

Docker Hub

Supported platforms

• linux/amd64
• linux/arm64
• linux/arm/v7 (Yeah! Your Raspberry Pi is supported!)

Features

• Optional "Public Mode", when no master OPENAI_API_KEY is required, but every user will be asked to provide one own while interacting with the bot.
• Switch between GPT models (including GPT-4) at any time.
• Session management for ChatGPT (by storing data locally or using Redis).
• Request DALL-E to create an image from the same chat.
• User and group whitelists.
• Asynchronous code for quick and non-blocking performance.
• Extensive configuration options through environment variables.
• Docker image for easy deployment.
• Cross-platform support (amd64, arm64, armv7).
• MIT License.

Try it!

• You can try a DEMO version of the Chibi bot by using @ChibiDemoBot. An OpenAI API Key is not required, but there are only 4 free requests available.
• You can also use a public version of the Chibi bot by using @ChibiPublicBot. An OpenAI Key is required.

System Requirements

The application is not resource-demanding at all. It works perfectly on both Raspberry Pi 3A with 512MB RAM and the cheapest AWS EC2 Instance t4g.nano (2 arm64 cores, 512MB RAM), while being able to serve many people simultaneously. I would say that if your machine belongs to a supported architecture and can run Docker, the application will work.

Prerequisites

• Docker
• Docker Compose (optional)

Getting Started

Using Docker Run

1. Pull the Chibi Docker image:

   docker pull pysergio/chibi:latest

2. Run the Docker container with the necessary environment variables:

   docker run -d \
     -e TELEGRAM_BOT_TOKEN=<your_telegram_token> \
     -e OPENAI_API_KEY=<your_chatgpt_api_key> \
     -v <path_to_local_data_directory>:/app/data \
     --name chibi \
     pysergio/chibi:latest

   Replace <your_telegram_token>, <your_chatgpt_api_key>, and <path_to_local_data_directory> with appropriate values.

Using Docker Compose

1. Create a docker-compose.yml file with the following contents:

      version: '3'
   
      services:
        chibi:
         restart: unless-stopped
         image: pysergio/chibi:latest
         environment:
           OPENAI_API_KEY: <your_chatgpt_api_key>
           TELEGRAM_BOT_TOKEN: <your_telegram_token>
         volumes:
           - chibi_data:/app/data
      
      volumes:
        chibi_data:

   Replace <your_telegram_token> and <your_chatgpt_api_key> with appropriate values.

2. Run the Docker container:

   docker-compose up -d

Please, visit the examples directory of the current repository for more examples.

Configuration

You can configure Chibi using the following environment variables:

Required variables:

Variable	Description	Default Value
TELEGRAM_BOT_TOKEN	Your Telegram bot token

Provider access related variables:

Variable	Description	Default Value
PUBLIC_MODE	If true, every user will be asked to provide ones own API key to interact with provider(s). Otherwise the API keys set via the variables below will be used	false
ANTHROPIC_API_KEY	Anthropic (Claude-3) API key. If not provided, the user will be asked to provide it while interacting with the bot.
MISTRALAI_API_KEY	MistralAI API key. If not provided, the user will be asked to provide it while interacting with the bot.
OPENAI_API_KEY	OpenAI API key. If not provided, the user will be asked to provide it while interacting with the bot.

Variables responsible for the basic behavior of the bot:

Variable	Description	Default Value
ALLOW_BOTS	Allow other bots to interact with Chibi	false
ANSWER_DIRECT_MESSAGES_ONLY	If True, the bot in group chats will respond only to messages containing its name (see the BOT_NAME setting)	true
ASSISTANT_PROMPT	Initial assistant prompt for OpenAI Client	You're a helpful and friendly assistant. Your name is <BOT_NAME>
BOT_NAME	Name of the bot	Chibi
LOG_PROMPT_DATA	Log user's prompts and GPT answers for debug purposes	false
MESSAGE_FOR_DISALLOWED_USERS	Message to show disallowed users	You're not allowed to interact with me, sorry. Please contact my owner first.
MODELS_WHITELIST	Comma-separated list of allowed models, e.g., "gpt-4,gpt-3.5-turbo"
MODEL_DEFAULT	Default OpenAI model to use	gpt-3.5-turbo
USERS_WHITELIST	Comma-separated list of whitelisted usernames, e.g., "@YourName,@YourFriendName,@YourCatName"
HIDE_MODELS	Hide "models" option from bot menu	false
HIDE_IMAGINE	Hide "imagine" option from bot menu	false

Proxy & data storage settings:

Variable	Description	Default Value
PROXY	Proxy setting for your application
REDIS	Redis connection string, e.g., redis://localhost or redis://:my-secret-password@127.0.0.1:6379/1
REDIS_PASSWORD	DEPRECATED! Please use REDIS instead. Redis password (optional)

Setting up image generation using DALL-E:

Variable	Description	Default Value
DALL_E_MODEL	DALL-E model. Available values: dall-e-2, dall-e-3	dall-e-3
IMAGE_GENERATIONS_LIMIT	The number of images that a typical non-whitelisted user can generate per month. 0 - no limits.	0
IMAGE_GENERATIONS_WHITELIST	Comma-separated list of user IDs (not usernames) for whom the image generation limit does not apply
IMAGE_QUALITY	Quality of the image generated by DALL-E. Available values: standard, hd	standard
IMAGE_SIZE	Size of the image generated by DALL-E. Available values: 256x256, 512x512, 1024x1024, 1792x1024, 1024x1792	1024x1024

Fine-tuning response generation. Already preconfigured and tested. You probably won't want to touch it:

Variable	Description	Default Value
FREQUENCY_PENALTY	OpenAI frequency penalty	0
GROUPS_WHITELIST	Comma-separated list of whitelisted group IDs, e.g., "-799999999,-788888888"
MAX_CONVERSATION_AGE_MINUTES	Maximum age of conversations (in minutes)	60
MAX_HISTORY_TOKENS	Maximum number of tokens in conversation history	1800
MAX_TOKENS	Maximum tokens for the OpenAI Client	1000
OPENAI_IMAGE_N_CHOICES	Number of choices for image generation in DALL-E	4
PRESENCE_PENALTY	OpenAI presence penalty	0
TEMPERATURE	OpenAI temperature for response generation	0.5
TIMEOUT	Timeout (in seconds) for processing requests	120

Please, visit the examples directory for the example of .env-file.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.