{"id":50965313,"url":"https://github.com/ruslanlap/centurion-bot","last_synced_at":"2026-06-18T19:33:01.820Z","repository":{"id":354407206,"uuid":"1223452019","full_name":"ruslanlap/centurion-bot","owner":"ruslanlap","description":"A Telegram task-management bot for groups. Assign tasks, track deadlines, get daily reminders and weekly reviews — all inside your Telegram group chat.","archived":false,"fork":false,"pushed_at":"2026-04-28T11:42:05.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-28T13:32:56.582Z","etag":null,"topics":["apscheduler","pydantic","sqlalchemy","telegram","telegrambot"],"latest_commit_sha":null,"homepage":"https://ruslanlap.github.io/ruslanlap_buymeacoffe/","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/ruslanlap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-28T10:38:12.000Z","updated_at":"2026-04-28T11:43:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ruslanlap/centurion-bot","commit_stats":null,"previous_names":["ruslanlap/centurion-bot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ruslanlap/centurion-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2Fcenturion-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2Fcenturion-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2Fcenturion-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2Fcenturion-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruslanlap","download_url":"https://codeload.github.com/ruslanlap/centurion-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2Fcenturion-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34505419,"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-18T02:00:06.871Z","response_time":128,"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":["apscheduler","pydantic","sqlalchemy","telegram","telegrambot"],"created_at":"2026-06-18T19:33:00.427Z","updated_at":"2026-06-18T19:33:01.805Z","avatar_url":"https://github.com/ruslanlap.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Centurion Bot\n\nA Telegram task-management bot for groups. Assign tasks, track deadlines, get daily reminders and weekly reviews — all inside your Telegram group chat.\n\n\u003e built with **aiogram 3**, **SQLAlchemy 2**, **Pydantic Settings**, and **APScheduler**.\n\n## Features\n\n- **Task management** — create, assign, complete, and track tasks with due dates\n- **Group \u0026 private chat** — assign tasks in groups or via private conversation with the bot\n- **Inline calendar** — pick due dates with an interactive calendar widget\n- **Daily reminders** — automatic daily digest of overdue and upcoming tasks\n- **Weekly review** — weekly summary of created/completed tasks, user rankings\n- **Due date editing** — request due date changes with accept/deny workflow\n- **Auto-registration** — when added to a group, the bot automatically registers all admins (no need for each user to write a message first)\n- **User tracking** — automatically registers users who send messages or join the group\n- **Feedback system** — users can send feedback; admin can view, reply, and close\n- **Announcements** — admin can broadcast messages to all users\n- **Statistics** — personal and group task statistics\n- **Privacy** — user data is cleaned up when they leave a group\n- **Recurring tasks** — create tasks that auto-generate on a schedule (daily/weekly/monthly)\n- **Task priorities** — set priority (🔴 high / 🟡 medium / 🟢 low) with `!high` or `!low` flags\n- **Escalation** — overdue high-priority tasks trigger automatic alerts to the group and admin\n- **Team check-ins** — daily status reports (done/plan/blockers) with streak tracking\n- **Check-in reports** — admin can see who checked in and who hasn't\n\n## Tech Stack\n\n| Component     | Technology                       |\n| ------------- | -------------------------------- |\n| Bot framework | aiogram 3.x (async)              |\n| Database      | SQLAlchemy 2.0 + aiosqlite       |\n| Config        | Pydantic Settings                |\n| Scheduler     | APScheduler                      |\n| Logging       | structlog                        |\n| Linter        | Ruff                             |\n| Type checker  | mypy                             |\n| Tests         | pytest + pytest-asyncio          |\n| Container     | Docker + Docker Compose          |\n\n## Quick Start\n\n```bash\n# Clone\ngit clone https://github.com/ruslanlap/centurion-bot.git\ncd centurion-bot\n\n# Setup\ncp .env.example .env\n# Edit .env with your TELEGRAM_BOT_TOKEN and ADMIN_ID\n\n# Install \u0026 run\nmake install\nmake run\n```\n\nSee [DEPLOYMENT.md](DEPLOYMENT.md) for full deployment instructions.\n\n## Commands\n\n### User Commands\n\n| Command | Description |\n| ------- | ----------- |\n| `/start` | Start the bot and show help |\n| `/help` | Show available commands |\n| `/do \u003ctitle\u003e` | Create a task (private: select group \u0026 assignee) |\n| `/do \u003ctitle\u003e @user in N days` | Create a task in group chat |\n| `/do \u003ctitle\u003e !high` | Create a high-priority task |\n| `/tasks` | Show your tasks (private) or group tasks |\n| `/stats` | Show your or group statistics |\n| `/due` | Trigger daily task overview |\n| `/weekly` | Trigger weekly review |\n| `/repeat \u003ctitle\u003e daily\\|weekly\\|monthly` | Create a recurring task |\n| `/repeats` | List active recurring tasks |\n| `/checkin` | Submit daily check-in report |\n| `/checkin_report` | View today's check-in reports |\n| `/feedback \u003ctext\u003e` | Send feedback to the admin |\n\n### Admin Commands\n\n| Command | Description |\n| ------- | ----------- |\n| `/admin_stats` | Show bot-wide statistics |\n| `/admin_announce \u003ctext\u003e` | Broadcast message to all users |\n| `/admin_feedback_show` | List unresolved feedback |\n| `/admin_feedback_reply \u003cid\u003e \u003ctext\u003e` | Reply to feedback |\n| `/admin_feedback_close \u003cid\u003e` | Mark feedback as resolved |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruslanlap%2Fcenturion-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruslanlap%2Fcenturion-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruslanlap%2Fcenturion-bot/lists"}