{"id":50705464,"url":"https://github.com/sudo-py-dev/lex-tg","last_synced_at":"2026-06-09T11:01:51.485Z","repository":{"id":349275707,"uuid":"1200564321","full_name":"sudo-py-dev/lex-tg","owner":"sudo-py-dev","description":"A high-performance, modular Telegram management system built with Pyrogram and SQLAlchemy 2.0. Features deep localization (20+ languages), AI integration (Gemini/OpenAI), and a custom caching layer for maximum speed and reliability.","archived":false,"fork":false,"pushed_at":"2026-06-08T12:55:34.000Z","size":17103,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-08T14:25:45.529Z","etag":null,"topics":["high-performance","mtproto","pyrogram-bot","telegram-bot-ai-assistant"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sudo-py-dev.png","metadata":{"files":{"readme":"README.he.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-03T15:05:08.000Z","updated_at":"2026-06-08T12:55:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sudo-py-dev/lex-tg","commit_stats":null,"previous_names":["sudo-py-dev/lex-python","sudo-py-dev/lex-tg"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sudo-py-dev/lex-tg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-py-dev%2Flex-tg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-py-dev%2Flex-tg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-py-dev%2Flex-tg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-py-dev%2Flex-tg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sudo-py-dev","download_url":"https://codeload.github.com/sudo-py-dev/lex-tg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sudo-py-dev%2Flex-tg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34103357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["high-performance","mtproto","pyrogram-bot","telegram-bot-ai-assistant"],"created_at":"2026-06-09T11:01:50.677Z","updated_at":"2026-06-09T11:01:51.480Z","avatar_url":"https://github.com/sudo-py-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Lex Banner](assets/lex_bot_banner.png)\n\n# 🌐 lex-tg: מנהל הקבוצות האולטימטיבי לטלגרם\n\n[English](README.md) | [עברית](README.he.md)\n\n**lex-tg** היא מערכת מודולרית מתקדמת לניהול קבוצות בטלגרם, שנבנתה במיוחד כדי לספק ביצועים מהירים ואמינות ללא פשרות. המערכת מבוססת על פרוטוקול **MTProto** ומשלבת טכנולוגיות אסינכרוניות מודרניות, מה שמאפשר שליטה מלאה בניהול הקבוצה תוך הקפדה על מהירות תגובה, תמיכה מלאה בריבוי שפות ובטיחות טיפוסים (Type Safety) מחמירה.\n\n---\n\n## ✨ יכולות מרכזיות\n\n- 🛡️ **ניהול מתוחכם (Moderation)**: שליטה מלאה על חסימות, הרחקות והשתקות עם אפשרות להגדרת זמני תפוגה גמישים.\n- 🔒 **נעילות דינמיות**: אפשרות לחסום באופן מיידי שליחת טקסט, מדיה, סטיקרים, קישורים או פקודות בוט.\n- ⚡ **עוזר AI מובנה**: אינטגרציה חלקה עם Google Gemini ו-OpenAI למתן מענה חכם והפעלה אוטומטית בתוך הקבוצה.\n- 🌊 **הגנה מהצפות ומתקפות (Flood \u0026 Raid)**: מנגנונים חכמים להגבלת קצב ושמירה על יציבות הקבוצה אל מול ספאם ומתקפות בוטים.\n- 🌍 **לוקליזציה מלאה (i18n)**: תמיכה ביותר מ-20 שפות שונות המנוהלות דרך מערכת תרגום מרכזית אחת.\n- 🎛️ **פאנל ניהול (Admin Panel) מתקדם**: ממשק משתמש אינטואיטיבי המבוסס על כפתורי תגובה (Callback) לניהול הגדרות הקבוצה בקלות.\n- 🧩 **ארכיטקטורה 'שטוחה'**: מערכת פלאגינים אופטימלית וקלה לתחזוקה, שבה כל יכולת מרוכזת בקובץ אחד (Flattened).\n\n---\n\n## 🛠️ Stack טכנולוגי\n\n| שכבה                    | טכנולוגיה                                                                                |\n| :---------------------- | :--------------------------------------------------------------------------------------- |\n| **לקוח ליבה**           | [Pyrogram](https://docs.pyrogram.org/) (Async MTProto)                                   |\n| **בסיס נתונים**         | [PostgreSQL](https://www.postgresql.org/) (דרך [asyncpg](https://github.com/MagicStack/asyncpg))                |\n| **מערכת מיגרציות**      | [Alembic](https://alembic.sqlalchemy.org/) (מעברי סכמה אסינכרוניים)                     |\n| **ניהול חבילות**        | [uv](https://astral.sh/uv/) (מהירות שיא ובידוד סביבות עבודה)                             |\n| **בטיחות טיפוסים**      | [Mypy](https://mypy-lang.org/) (אכיפת סוגים קפדנית ללא פשרות)                            |\n\n---\n\n## 🚀 צעדים ראשונים\n\n### 1. התקנת `uv`\n\nהפרויקט עושה שימוש ב-`uv` לצורך ניהול מהיר של תלויות וסביבות וירטואליות מבודדות.\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n### 2. הגדרת הסביבה\n\nשכפלו את הפרויקט וסנכרנו את התלויות:\n\n```bash\nuv sync\ncp .env.example .env\n```\n\n\u003e [!IMPORTANT]\n\u003e הקפידו למלא את המפתחות `API_ID`, `API_HASH`, ו-`BOT_TOKEN` בקובץ ה-`.env`. ניתן גם לשנות את שם הבוט הגלובלי (`BOT_NAME`) בתוך `src/config.py`.\n\n### 3. הרצת הבוט\n\n```bash\nuv run bot\n```\n\n## 🛳️ פריסה (Deployment)\n\n### אפשרות 1: Railway (מומלץ)\nהדרך הקלה ביותר להריץ את הבוט 24/7.\n1. לחצו על **New Project** בלוח הבקרה של Railway.\n2. בחרו את המאגר (Repository) שלכם.\n3. הוסיפו בסיס נתונים **PostgreSQL**.\n4. עקבו אחר המדריך ב-[RAILWAY_GUIDE.md](RAILWAY_GUIDE.md) להגדרת משתנים ו-Volumes.\n\n### אפשרות 2: Docker (עצמאי)\nודאו שמותקנים אצלכם Docker ו-Docker Compose בשרת (VPS).\n\n1. **הגדרה**:\n   ```bash\n   bash scripts/deploy_vps.sh\n   ```\n2. **ניהול**:\n   - צפייה בלוגים: `docker compose logs -f`\n   - עצירת הבוט: `docker compose down`\n   - הפעלת הבוט: `docker compose up -d`\n\n---\n\n## 🏗️ פיתוח ובקרת איכות\n\nאנו מחויבים לסטנדרטים גבוהים במיוחד של איכות קוד.\n\n### 🔍 בדיקות סטטיות (Static Analysis)\n\n```bash\nuv run lint         # בדיקות לינטינג מהירות בעזרת Ruff\nuv run fmt          # עיצוב (Formatting) קוד אוטומטי\nuv run typecheck    # בדיקת סוגים קפדנית עם MyPy\n```\n\n### 🌐 ניהול תרגומים (Localization)\n\nכלי התרגום שלנו שומר על סנכרון מלא בין כל השפות:\n\n```bash\nuv run translate    # עדכון כל קבצי השפות מתוך en.json\n```\n\n### 🧪 בדיקות יחידה (Testing)\n\n```bash\nuv run test         # הרצת סוויטת בדיקות מלאה (pytest-asyncio)\n```\n\n### 🗄️ מיגרציות בסיס נתונים\nודאו תמיד שסכמת בסיס הנתונים שלכם מעודכנת:\n```bash\nuv run migrate      # עדכון לגרסת הסכמה האחרונה (alembic)\n```\n\n---\n\n## 🏛️ מבנה הפרויקט\n\n```text\n├── src/\n│   ├── core/           # אתחול הבוט וניהול הלקוח (Client)\n│   ├── plugins/        # מערכת הפלאגינים המודולרית\n│   │   ├── admin_panel/ # מנוע ההגדרות הוויזואלי\n│   │   ├── ai_assistant/ # שכבת הבינה המלאכותית\n│   │   ├── scheduler/   # ניהול משימות מתוזמנות\n│   │   └── ...         # מעל 30 פלאגינים בפורמט 'שטוח'\n│   ├── repository/     # שכבת הנתונים (SQLAlchemy)\n│   ├── locales/        # קבצי תרגום ובינלאומיות (.json)\n│   └── utils/          # כלי עזר (הרשאות, מטמון, תרגום)\n├── scripts/            # כלי עזר לאוטומציה ותרגום\n└── tests/              # בדיקות מקיפות לכל חלקי המערכת\n```\n\n---\n\n## 💎 סטטוס הפרויקט: הקשחה ושיפור ביצועים\n\nLex הועבר באופן מלא ל**שכבת מטמון פייתון טהורה**, מה שמאפשר לנו לוותר על תלויות חיצוניות דוגמת Redis, לצמצם את זמני השהייה ולפשט את תהליך הפריסה. אנו מקפידים על **100% כיסוי סוגים** בכל רכיבי הליבה.\n\n\u003e [!NOTE]\n\u003e אנחנו תמיד שמחים לתרומות קוד! אנא ודאו שכל בקשת מיזוג (PR) עוברת בהצלחה את הבדיקות `uv run lint` ו-`uv run typecheck` לפני ההגשה.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudo-py-dev%2Flex-tg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudo-py-dev%2Flex-tg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudo-py-dev%2Flex-tg/lists"}