🌸 Cutiepii Robot

A powerful, modular, and cute Telegram group management bot.

---

✨ What is Cutiepii?

Cutiepii Robot is a fully-featured, modular Telegram bot built for group management. It's fast, reliable, and packed with features — from bans and warnings to AI chatbot and anime search.

🚀 Major Comeback! Last publicly released ~4 years ago on python-telegram-bot v20.0a0. This version is a complete rewrite and upgrade to PTB v22.8 with async/await, full Python 3.9+ support, and many new modules.

---

⬆️ Migration Highlights

Before (4 years ago)	Now
PTB 20.0a0 (alpha)	PTB 22.8 (stable)
Sync handlers	Fully async/await
Basic admin modules	50+ modules
No AI chatbot	Gemini + OpenRouter AI chatbot
No welcome image	Dynamic Pillow welcome cards
Single language	5 languages (EN, HI, ES, JA, RU)
Redis optional	Redis + PostgreSQL required

---

📦 Core Libraries

Library	Version	Purpose
python-telegram-bot	22.8	Primary bot framework
telethon	≥ 1.42.0	MTProto client for advanced features
SQLAlchemy	1.4.x	SQL database ORM
redis	≥ 5.0	Caching & rate limiting
aiohttp	3.9.5	Async HTTP requests
Pillow	≥ 10.2	Image processing & welcome cards
APScheduler	≥ 3.10	Scheduled jobs & reminders
yt-dlp	≥ 2024.1	Media downloading

---

🚀 Features

• 🛡️ Admin Tools — Ban, kick, mute, warn, and purge
• 👋 Welcome & Goodbye — Custom messages with dynamic placeholders
• 🤖 AI Chatbot — Powered by Gemini & OpenRouter (bring your own API key)
• 📝 Filters & Notes — Save and trigger custom text or media
• ⚠️ Warnings System — Configurable warn limits with auto-action
• 🔒 Locks & Anti-Spam — Flood control, blacklists, NSFW detection
• 🎌 Anime & Fun — AniList, Jikan, wallpapers, memes, and more
• ⏰ Reminders — Set personal or group reminders
• 🌍 Multi-language — English, Hindi, Spanish, Japanese, Russian

---

⚙️ Setup

1. Clone the repo and install dependencies:

   git clone https://github.com/Awesome-RJ/CutiepiiRobot
   cd CutiepiiRobot
   pip install -r requirements.txt

2. Copy .env.example to .env and fill in your values:

   cp .env.example .env

3. Run the bot:

   python -m Cutiepii_Robot

See .env.example for all available configuration options.

---

🙏 Credits

Contributor	Role
Awesome-RJ	Creator & Lead Developer
Paul Larsen	Original Marie Bot base
python-telegram-bot team	Core bot framework
LonamiWebs	Telethon MTProto library

---

Made with ❤️ by Awesome-RJ