A customizable Telegram bot powered by Node.js, integrating Cloudflare AI Gateway to provide smart, context-aware conversations. It targets users seeking a flexible and easily deployable AI chatbot for Telegram groups and private chats, offering features like persistent memory and rich message formatting.

How It Works

This project leverages Node.js to create a Telegram bot that routes all AI requests through Cloudflare AI Gateway. This approach centralizes logging, analysis, and caching while protecting backend AI provider API keys. The bot maintains contextual conversation memory, allowing for fluid, multi-turn dialogues with a controllable memory length. It automatically converts AI-generated Markdown into Telegram-compatible HTML, ensuring code blocks, bold, and italic text are displayed correctly.

Quick Start & Requirements

• Primary Install/Run: Deploy on a VPS using Node.js and PM2 for persistent, auto-restarting operation.
• Prerequisites:
  • Telegram Bot Token (from @BotFather).
  • Cloudflare Account Credentials: Account ID, AI Gateway Name, API Token (with AI Gateway read/write permissions).
  • VPS (Ubuntu/Debian recommended) with Node.js v18+ (installable via nvm) and Git.
  • PM2 process manager (npm install pm2 -g).
• Links:
  • Demo Bot: https://t.me/CFAIFreeTGbot
  • Cloudflare API Tokens: https://dash.cloudflare.com/profile/api-tokens

Highlighted Details

• Cloudflare AI Gateway integration for enhanced control, logging, and security.
• Per-chat customization for distinct personas, AI models, and keyword triggers.
• Intelligent context memory management with adjustable message limits.
• Automatic Markdown-to-HTML conversion for rich message formatting in Telegram.
• Multiple activation triggers: @mention, message reply, or specific keywords.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or a public roadmap were found in the provided README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license permits commercial use and integration within closed-source projects.

Limitations & Caveats

Setup requires specific Cloudflare account configurations and API tokens. The bot's performance and operational costs are dependent on Cloudflare usage, the selected LLMs, and the configured context message limit.