🦙 Ollama Telegram Bot

Chat with your LLM, using Telegram bot!
Feel free to contribute!

Features

Here's features that you get out of the box:

• [x] Fully dockerized bot
• [x] Response streaming without ratelimit with SentenceBySentence method
• [x] Mention [@] bot in group to receive answer

Roadmap

• [x] Docker config & automated tags by StanleyOneG, ShrirajHegde
• [x] History and /reset by ShrirajHegde
• [ ] Add more API-related functions [System Prompt Editor, Ollama Version fetcher, etc.]
• [ ] Redis DB integration
• [ ] Update bot UI

Prerequisites

• Telegram-Bot Token

Installation (Non-Docker)

• Install latest Python

• Clone Repository

  git clone https://github.com/ruecat/ollama-telegram
  

• Install requirements from requirements.txt

  pip install -r requirements.txt
  

• Enter all values in .env.example

• Rename .env.example -> .env

• Launch bot

  python3 run.py
  

Installation (Docker Image)

The official image is available at dockerhub: ruecat/ollama-telegram

• Download .env.example file, rename it to .env and populate the variables.

• Create docker-compose.yml (optionally: uncomment GPU part of the file to enable Nvidia GPU)

  version: '3.8'
  services:
    ollama-telegram:
      image: ruecat/ollama-telegram
      container_name: ollama-telegram
      restart: on-failure
      env_file:
        - ./.env
  
    ollama-server:
      image: ollama/ollama:latest
      container_name: ollama-server
      volumes:
        - ./ollama:/root/.ollama
  
      # Uncomment to enable NVIDIA GPU
      # Otherwise runs on CPU only:
  
      # deploy:
      #   resources:
      #     reservations:
      #       devices:
      #         - driver: nvidia
      #           count: all
      #           capabilities: [gpu]
  
      restart: always
      ports:
        - '11434:11434'
  

• Start the containers

  docker compose up -d
  

Installation (Build your own Docker image)

• Clone Repository

  git clone https://github.com/ruecat/ollama-telegram
  

• Enter all values in .env.example

• Rename .env.example -> .env

• Run ONE of the following docker compose commands to start:

  1. To run ollama in docker container (optionally: uncomment GPU part of docker-compose.yml file to enable Nvidia GPU)

     docker compose up --build -d
     

  2. To run ollama from locally installed instance (mainly for MacOS, since docker image doesn't support Apple GPU acceleration yet):

     docker compose up --build -d ollama-telegram
     

Environment Configuration

Credits

• Ollama

Libraries used

• Aiogram 3.x