Deploy Now

SaaS Alternative

Combot GroupHelp Shieldy

Stars

455

Forks

90

Watchers

7

Developer links

TG-Spam

Spam bots flood busy Telegram groups with crypto scams and phishing links faster than human admins can delete them; TG-Spam watches every message and removes the junk before your members see it. Each message is scored by several checks at once: similarity to known spam samples, a stop-word dictionary, emoji and link counts, and a lookup against the Combot Anti-Spam database of known spammers. For borderline cases you can add OpenAI or Gemini as an extra judge, or write your own detection rules as Lua plugins that run inside the bot. The bot learns while you moderate: when admins approve a flagged message or ban a user it missed, the samples update, so the same trick fails next time. Members can report spam with a reply, repeat offenders accumulate warnings toward an automatic ban, and an admin chat gives your team one place to review borderline calls. Turn on the built-in server and the same engine answers spam checks over HTTP for your other tools, with a web UI to test messages, manage samples and dictionaries, and control the approved-user list. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.

TG-Spam
TG-Spam
TG-Spam
TG-Spam
TG-Spam
TG-Spam

Benefits

  • Layered Spam Detection Engine
  • Similarity scoring, stop words, emoji and link analysis, CAS spammer lookups, and optional OpenAI or Gemini checks combine so one weak signal never decides alone.
  • Learns From Your Moderation
  • Every admin approval or manual ban updates the spam and ham samples, so detection adapts to the scams targeting your group without retraining marathons.
  • One Container, Any Group Size
  • A single Docker image for amd64, arm64, and armv7 runs one group or many, storing samples and users in SQLite or PostgreSQL with automatic backups.
  • API And Admin Web UI
  • The optional server on port 8080 checks messages over HTTP for other tools and serves pages to test messages, edit samples, and manage approved users.

Features

  • Combot CAS Integration
  • Senders are cross-checked against the Combot Anti-Spam System database, so accounts already banned across Telegram are stopped at their first message.
  • Optional LLM Judges
  • OpenAI GPT and Google Gemini checks can run together or separately for borderline messages, adding semantic analysis when pattern matching is not enough.
  • Lua Detection Plugins
  • Custom Lua scripts hook into the pipeline to approve or flag messages by your own patterns, without forking or modifying the bot's source code.
  • Warn-Driven Auto-Ban
  • User reports and detections add warnings to repeat offenders, and crossing your configured threshold bans them automatically, even between admin shifts.
  • Web Admin Interface
  • Behind basic auth, the UI tests messages live, manages spam and ham samples, stop phrases and ignored words, approved users, and bot behaviour settings.

Apps Similar to TG-Spam