Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

🤖 Modya - Your Efficient Chat Assistant

Modya

A versatile and efficient assistant for Telegram chats


FeaturesInstallationUsageContributing


📖 About

Modya is a very atypical Telegram bot.
I built it after watching people put together their perfect “telegram-flood-chat” (super active group chats) from dozens of different bots — taking just one useful feature from each. Modya brings together everything you actually need in one clean, powerful package — bringing together the features moderators usually need from multiple bots into a single project.

What is a “telegram-flood-chat”? (for people who don’t live in Telegram)

A “flood chat” (Telegram slang) is basically a closed, fast-moving group chat with limited slots, where people join through a theme (like Anime, AI, gaming, etc.) but then talk freely about anything.

Key idea:

  • The “topic” is just an entry filter, not a discussion rule.
  • Members pick a role/identity slot (mostly cosmetic).
  • There are activity rules (minimum messages, inactivity limits).
  • Regular cleanups remove inactive users and free slots.
  • Inside, it works like a normal casual group chat—memes, random talk, chaos.

In short: It’s a curated, limited-size social chat with enforced activity, where structure exists only for membership—not conversation.

Why this project exists

Telegram groups can get really busy. Moderators usually spend hours every week calling people, cleaning up inactive users, tracking activity, and keeping everything fun. Modya automates all of that and even adds cool social features so people stay because they enjoy the chat.

The bot saves moderators at least 1.5 hours per week — that’s real time back in their lives.


✨ Features

  • Instant Calls/call or созвать gathers everyone in the chat in seconds (with unsubscribe option)
  • One-Click Member Onboarding — generate a temporary invite link, automatically approve the join request, assign a role, and launch the welcome call — all from a single command
  • Automatic Cleanups — removes people who don’t write enough or have been inactive (first cleanup only after one week)
  • Rests / Breaks — members can take time off without being cleaned; admins can approve them
  • Roles — assign roles that are announced when someone leaves (Telegram itself can’t do this)
  • Detailed Statistics — messages count, activity graphs, favourite words, favourite chat partners, warnings and more (кто я, топ, etc.)
  • Telegram-Aware Permissions — moderation rights are mapped to native Telegram administrator permissions instead of a separate permission system
  • Moderation Tools — ban, mute, warnings with clear reasons
  • Rewards & Gamification — awards, message quotes, marriages, family trees and custom RP commands available across all chats
  • Smart Settings — everything is customisable per chat (norms, inactivity time, auto-clean schedule, etc.)

Everything works even with Telegram’s strict limits (the bot only sees messages after it joins the chat).


🆕

Recent major improvements include:

  • 🚀 Automatic onboarding for new members through temporary invite links
  • 🌍 Global custom RP commands shared across all chats
  • 💾 Persistent member history (awards, warnings and breaks survive rejoining)
  • ⚡ Significant performance improvements for many commands
  • 🛡️ Administration permissions now follow native Telegram administrator rights

🚀 Installation

This is a showcase repository

The full source code is private (commercial product).
Here you see how the bot is built, what technologies it uses, and how clean the setup is.

Quick Start (if you just want to try the bot)

  1. Add @ModyaTheBot to your Telegram group
  2. Give it administrator rights
  3. Type /help — done!

💡 Usage

The bot runs 24/7 and works completely automatically.
All commands are simple and work right in the group chat.


🏗️ Tech Stack

  • Language: Python 3.9+
  • Architecture: Async event-driven
  • Framework: aiogram (async Telegram Bot API) && Telethon (async MTproto API)
  • Database: PostgreSQL + asyncpg
  • Deployment: Docker & Docker Compose (ready to run with one command)

🤝 Contributing

This is a personal project, but feedback is very welcome!
You can:

  • Open an issue if you find a bug
  • Suggest a new feature
  • Just say hi on Telegram

🔗 Links


Made with ❤️ by Caportabow

About

Modya — all-in-one Telegram chat moderator bot. Automates calls, cleanups, rests, roles, stats and fun gamification. Saves moderators at least 1.5 hours every week.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors