{"id":29364388,"url":"https://github.com/mscbuild/assistant_bot","last_synced_at":"2025-07-25T05:06:31.746Z","repository":{"id":302245963,"uuid":"1011750497","full_name":"mscbuild/Assistant_Bot","owner":"mscbuild","description":"🤖 Assistant Bot is a Telegram-based productivity assistant designed to streamline team communication and task tracking. It offers quick access to weekly reports, task lists, and provides an interface for users to ask questions.","archived":false,"fork":false,"pushed_at":"2025-07-02T05:21:55.000Z","size":41,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-09T10:09:15.461Z","etag":null,"topics":["bot","development","python","report","task","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mscbuild.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-07-01T09:34:07.000Z","updated_at":"2025-07-02T05:21:58.000Z","dependencies_parsed_at":"2025-07-01T10:41:33.044Z","dependency_job_id":"e882b89b-e4f6-4e3e-815e-7e97cb813b86","html_url":"https://github.com/mscbuild/Assistant_Bot","commit_stats":null,"previous_names":["mscbuild/assistant_bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mscbuild/Assistant_Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscbuild%2FAssistant_Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscbuild%2FAssistant_Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscbuild%2FAssistant_Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscbuild%2FAssistant_Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mscbuild","download_url":"https://codeload.github.com/mscbuild/Assistant_Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mscbuild%2FAssistant_Bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266959681,"owners_count":24012545,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-25T02:00:09.625Z","response_time":70,"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":["bot","development","python","report","task","telegram-bot"],"created_at":"2025-07-09T10:09:13.214Z","updated_at":"2025-07-25T05:06:31.587Z","avatar_url":"https://github.com/mscbuild.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Assistant Bot\n ![](https://komarev.com/ghpvc/?username=mscbuild) \n ![](https://img.shields.io/github/license/mscbuild/Assistant_Bot) \n ![](https://img.shields.io/badge/PRs-Welcome-green)\n ![](https://img.shields.io/github/languages/code-size/mscbuild/Assistant_Bot)\n![](https://img.shields.io/badge/code%20style-python-green)\n![](https://img.shields.io/github/stars/mscbuild)\n![](https://img.shields.io/badge/Topic-Github-lighred)\n![](https://img.shields.io/website?url=https%3A%2F%2Fgithub.com%2Fmscbuild)\n\n\n## 🧠 Project Description\n\nAssistant Bot is a Telegram-based productivity assistant designed to streamline team communication and task tracking. It offers quick access to weekly reports, task lists, and provides an interface for users to ask questions. Built with Python and the `python-telegram-bot` library, this bot simplifies team operations within Telegram, providing a menu-driven interface for intuitive interaction.\n\n# 🗺️ Project Map (Structure)\n~~~bash\nassistant-bot/\n├── bot.py                    # Main application logic\n├── README.md                 # Project description and setup guide\n├── requirements.txt          # Python dependencies\n├── .env                      # Environment variables (e.g. bot token)\n├── utils/                    # Helper functions (e.g. keyboards, messages)\n│   └── menu.py               # Main menu UI\n├── handlers/                 # Bot handlers\n│   ├── start.py              # /start command handler\n│   ├── callback.py           # Inline button callback logic\n│   └── messages.py           # Text message handler\n└── LICENSE\n~~~\n\n## ✨ Features\n\n- 📊 Weekly Report Overview\n- 📋 Task List Display\n- ❓ Q\u0026A Prompting\n- 🧠 Smart reply for common phrases (e.g., \"tasks\", \"review reports\")\n- 🧵 InlineKeyboard navigation\n\n  ### Prerequisites\n\n- Python 3.10+\n- Telegram account\n- Telegram bot token (from [@BotFather](https://t.me/BotFather))\n\n  ## 1.Clone the repo:\n\n~~~bash\ngit clone https://github.com/yourusername/Assistant_Bot.git\ncd Assistant_Bot\n~~~\n\n## 2.Create a virtual environment and activate it:\n~~~bash\npython -m venv venv\nsource venv/bin/activate  # On Windows use venv\\Scripts\\activate\n~~~\n\n## 3. Install dependencies:\n~~~bash\npip install -r requirements.txt\n~~~\n\n## 4. Set your bot token in .env:\n~~~bash\nBOT_TOKEN=your_token_here\n~~~\n\n## 5. Run the bot:\n~~~bash\npython bot.py\n~~~\n\n# 🧱 Tech Stack\n\n- Python 3.10+\n\n- python-telegram-bot\n\n- dotenv (for managing environment variables)\n\n# 📋 Checklist\n\n - ✅ Start command handler\n\n - ✅ Inline keyboard main menu\n\n - ✅ Report display\n\n - ✅ Task list generation\n\n - ✅ Question prompt handling\n\n - ✅ Basic natural language message recognition\n\n - ☐ Logging integration\n\n - ☐ Persistent storage for tasks/reports\n\n - ☐ Unit testsStart\n\n   # 📦  What is needed for deployment\n\n| File                        | Purpose                                            |\n| --------------------------- | -------------------------------------------------- |\n| `Dockerfile`                | Building a container for local/cloud running       |\n| `Procfile`                  | To start Heroku worker                             |\n| `.env`                      | Local environment variables                        |\n| `requirements.txt`          | Installing dependencies                            |\n| `bot.py` and other modules  | Bot's main code                                    |\n\n\n# 📄 License\n\n\u003e MIT License\n \n\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmscbuild%2Fassistant_bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmscbuild%2Fassistant_bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmscbuild%2Fassistant_bot/lists"}