{"id":23196702,"url":"https://github.com/dmytro-varich/perfect-bot","last_synced_at":"2025-07-18T06:33:06.374Z","repository":{"id":246025663,"uuid":"819882290","full_name":"dmytro-varich/Perfect-bot","owner":"dmytro-varich","description":"Perfect Bot is your personal assistant for tracking nutrition and achieving healthy lifestyle goals. It is designed for those who want to easily manage their diet, monitor their intake of calories, proteins, fats, and carbohydrates, and achieve their fitness goals.","archived":false,"fork":false,"pushed_at":"2025-05-18T13:04:08.000Z","size":255,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-18T14:23:32.921Z","etag":null,"topics":["aiogram3","python","sqlite","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/your_perfect_bot","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/dmytro-varich.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}},"created_at":"2024-06-25T11:14:43.000Z","updated_at":"2025-05-18T13:04:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"02d7d157-b76e-428c-a0d7-10f4d02d5be4","html_url":"https://github.com/dmytro-varich/Perfect-bot","commit_stats":null,"previous_names":["dmytro-varich/perfect-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dmytro-varich/Perfect-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytro-varich%2FPerfect-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytro-varich%2FPerfect-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytro-varich%2FPerfect-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytro-varich%2FPerfect-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmytro-varich","download_url":"https://codeload.github.com/dmytro-varich/Perfect-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytro-varich%2FPerfect-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265710560,"owners_count":23815379,"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","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":["aiogram3","python","sqlite","telegram","telegram-bot"],"created_at":"2024-12-18T14:20:14.438Z","updated_at":"2025-07-18T06:33:06.366Z","avatar_url":"https://github.com/dmytro-varich.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🅿️ Perfect Bot\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/🅿️.gif\" alt=\"Perfect Logo\" /\u003e\n\u003c/p\u003e\n\n[Perfect Bot](https://t.me/your_perfect_bot) is your personal assistant for tracking nutrition and achieving healthy lifestyle goals in [Telegram](https://web.telegram.org/). It is designed for those who want to easily manage their diet, monitor their intake of calories, proteins, fats, and carbohydrates, and achieve their fitness goals.\n\n## 🛠️ Technologies\n\u003cp align=\"center\"\u003e \u003cimg src=\"https://img.shields.io/badge/Python-3.11-blue?style=for-the-badge\u0026logo=python\u0026logoColor=white\" alt=\"Python\" /\u003e \u003cimg src=\"https://img.shields.io/badge/aiogram-3.7.0-009688?style=for-the-badge\u0026logo=telegram\u0026logoColor=white\" alt=\"Aiogram\" /\u003e \u003cimg src=\"https://img.shields.io/badge/asyncio-asynchronous-yellow?style=for-the-badge\" alt=\"asyncio\" /\u003e \u003cimg src=\"https://img.shields.io/badge/SQLite-07405E?style=for-the-badge\u0026logo=sqlite\u0026logoColor=white\" alt=\"SQLite\" /\u003e \u003cimg src=\"https://img.shields.io/badge/Telegram-Bot-2CA5E0?style=for-the-badge\u0026logo=telegram\u0026logoColor=white\" alt=\"Telegram Bot\" /\u003e \u003cimg src=\"https://img.shields.io/badge/Ubuntu-22.04-E95420?style=for-the-badge\u0026logo=ubuntu\u0026logoColor=white\" alt=\"Ubuntu Server\" /\u003e \u003c/p\u003e\n\n## 🚀 Futures\n\n- **🧾 Create a Personal Profile**\n\n    On the first launch, the bot prompts the user to fill out a short profile: gender, age, height, weight, physical activity level, and goal (lose weight, maintain, or gain mass). Based on this information, it calculates a personalized daily intake of calories, proteins, fats, and carbohydrates.\n\n  \u003cp align=\"center\"\u003e\n      \u003cimg src=\"assets/creating_profile.png\" alt=\"Creating Profile\" /\u003e\n  \u003c/p\u003e\n\n\n- 🍱 **User-Defined Product Menu**\n\n    Users can create a list of their own food items by specifying the calories, proteins, fats, and carbohydrates per 100 grams. These items can then be quickly added to the daily log — just enter the consumed amount, and the bot will automatically calculate the daily and weekly nutrition stats.\n\n  \u003cp align=\"center\"\u003e\n      \u003cimg src=\"assets/product_menu.png\" alt=\"Product Menu\" /\u003e\n  \u003c/p\u003e\n\n\n- 👤 **Profile and Daily Stats**\n\n    The bot displays the user's profile along with the current nutrition progress for the day.\n\n    \u003cp align=\"center\"\u003e\n      \u003cimg src=\"assets/personal_profile.png\" alt=\"Personal Profile\" /\u003e\n\n- ⏱ **Quick Food Entry**\n\n    Users can instantly log a meal by entering the calories, proteins, fats, and carbs per 100g and the amount consumed — without needing to add the product to the menu first.\n\n- 🌐 **Multilingual Support**\n    \n    The interface is available in both English and Ukrainian.\n\n- 🧩 **Aiogram Bot Template**\n\n    This repository can serve as a solid foundation for building other Telegram bots using the `aiogram` framework.\n\n## ⚙️ Install\n\n1. **Clone the repository:**\n\n```bash\ngit clone https://github.com/dmytro-varich/Perfect-bot.git\ncd Perfect-bot\n```\n\n2. **Create a virtual environment and install dependencies:**\n\n```bash\npython -m venv venv\nsource venv/bin/activate  # For Linux/macOS\n# OR\nvenv\\Scripts\\activate     # For Windows\n\npip install -r requirements.txt\n```\n\n3. **Create a `.env` file** in the project root with the following content:\n\n```env\nTOKEN='your-telegram-bot-token'\n```\n\n4. **Run the bot:**\n\n```bash\npython main.py\n```\n\n## 🟢 Project Status\nThe project is **not under active development**, but it is running on a [server](https://cloud.tuke.sk/) and remains available for use for an indefinite period\n\nFurther development and new features may be added in the future depending on user interest and feedback.\n\n## 🤝 Contributing\nI will be glad to pull-requests, suggestions and bugreports!\nTo contribute:\n\n1. Fork the repository\n2. Create a new branch (`git checkout -b feature/your-feature`)\n3. Make your changes\n4. Submit a pull request\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eFeature Ideas\u003c/strong\u003e\u003c/summary\u003e\n\n  \u003cbr\u003e\n\n  | Name                          | Description                                                                                                                                                                                                        |\n  | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n  | **Meal Notifications**        | Add a feature that allows users to set specific times for meal reminders. The bot would send a notification at those times to help users stay on track with their nutrition plan.                                  |\n  | **AI-based Meal Suggestions** | Implement a system using AI or rule-based logic to suggest food items that can help the user reach their daily macronutrient goals. Based on the current intake, the bot would recommend what and how much to eat. |\n\n\u003c/details\u003e\n\n## 🧑🏻 Author\nDmytro Varich is the creator of this telegram bot. You can learn more about his projects on his personal [Telegram channel](https://t.me/varich_channel), as well as connect with him via [LinkedIn](https://www.linkedin.com/in/dmytro-varich/) and [Email](\u003cvarich.it@gmail.com\u003e).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmytro-varich%2Fperfect-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmytro-varich%2Fperfect-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmytro-varich%2Fperfect-bot/lists"}