pokitoki  by nalgeon

Telegram bot for interacting with LLMs

created 2 years ago
340 stars

Top 82.2% on sourcepulse

GitHubView on GitHub
Project Summary

Pokitoki is a versatile Telegram AI assistant designed for both personal and group chats, leveraging OpenAI-compatible large language models. It offers features like external link access, custom commands, image generation, and on-the-fly configuration, aiming to provide a powerful and adaptable AI interaction experience within Telegram.

How It Works

Pokitoki integrates with various OpenAI-compatible LLM providers, including OpenAI, OpenRouter, Nebius, and Gemini. It enhances standard LLM interactions by fetching external web content (text, code) to provide contextually relevant answers, overcoming the limitations of models that cannot access live URLs. The bot supports direct questions, replies, mentions, and message editing for follow-ups, with configurable memory depth and custom prompts for tailored interactions.

Quick Start & Requirements

  • Install/Run: docker compose up --build --detach
  • Prerequisites: OpenAI API key (or compatible provider), Telegram Bot Token from @BotFather.
  • Setup: Clone repo, copy config.example.yml to config.yml, configure API keys and Telegram usernames.
  • Docs: Setup Guide

Highlighted Details

  • Supports multiple OpenAI-compatible LLM providers and models.
  • Enables access to external web content (articles, code) for LLM context.
  • Features custom shortcuts, chat-wide prompts, and image generation (DALL-E 3).
  • Allows on-the-fly configuration changes via /config command.
  • Handles Telegram message length limits by sending responses as files.

Maintenance & Community

  • Originally based on chatgpt_telegram_bot.
  • Changelog available via releases.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: Permissive license suitable for commercial use and integration with closed-source applications.

Limitations & Caveats

External link access is limited to text content; PDFs, images, and audio are not supported. Image generation is enabled by default only for configured usernames due to cost. Group chat admin privileges are required for certain commands like /prompt and /config.

Health Check
Last commit

2 months ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
1
Star History
15 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.