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

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

• 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.

• 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.

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.

• Docker
• Docker Compose (optional)

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.

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.

You can configure Chibi using the following environment variables:

Required variables:

Provider access related variables:

Variables responsible for the basic behavior of the bot:

Proxy & data storage settings:

Setting up image generation using DALL-E:

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

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

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

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