{"id":22832669,"url":"https://github.com/gashu-101/mechify","last_synced_at":"2026-05-01T15:32:40.345Z","repository":{"id":250621346,"uuid":"834971972","full_name":"gashu-101/Mechify","owner":"gashu-101","description":"📚 MechIfy - Your Ultimate Mechanical Engineering Study Bot 🤖","archived":false,"fork":false,"pushed_at":"2024-11-18T20:22:46.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-06T07:21:55.028Z","etag":null,"topics":["ai","automation","bot","rag"],"latest_commit_sha":null,"homepage":"https://t.me/MechiFyLabBot","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/gashu-101.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}},"created_at":"2024-07-28T21:33:14.000Z","updated_at":"2024-11-18T20:22:49.000Z","dependencies_parsed_at":"2024-11-19T06:15:25.740Z","dependency_job_id":null,"html_url":"https://github.com/gashu-101/Mechify","commit_stats":null,"previous_names":["gashu-101/mechify"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gashu-101%2FMechify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gashu-101%2FMechify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gashu-101%2FMechify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gashu-101%2FMechify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gashu-101","download_url":"https://codeload.github.com/gashu-101/Mechify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246403892,"owners_count":20771530,"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":["ai","automation","bot","rag"],"created_at":"2024-12-12T21:08:30.293Z","updated_at":"2026-05-01T15:32:35.303Z","avatar_url":"https://github.com/gashu-101.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"📚 MechIfy - Your Ultimate Mechanical Engineering Study Bot 🤖\n\nWelcome to **MechIfy**! This bot is designed to assist Mechanical Engineering students by providing resources, study assistance, and interactive learning support. Whether you need help with a specific topic or access to resources, MechIfy is here to guide you through your academic journey.\n\n✨ Features\n\n- **Resources 📚**: Get quick access to curated study materials based on your year of study or exam category.\n- **AI Instructor 🤖**: Ask the bot any question related to Mechanical Engineering, and it will provide an informative and engaging response.\n- **About ℹ️**: Learn more about the purpose and development of MechIfy.\n- **Developers 👨‍💻**: Get to know the team behind MechIfy.\n\n🚀 Getting Started\n\n### Prerequisites\n\n- Python 3.7+\n- Telegram Bot API token\n\n### Installation\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/gashu-101/Mechify.git\n   cd Mechify\n   ```\n\n2. **Install dependencies:**\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Set up your environment variables:**\n   - Replace the placeholders in the bot script with your API keys and credentials:\n     - `BOT_TOKEN`\n     - `YOUTUBE_API_KEY`\n     - `COHERE_API_KEY`\n   - You can store these in a `.env` file for easier management.\n\n### Running the Bot\n\n1. **Start the bot:**\n\n   ```bash\n   python bot.py\n   ```\n\n2. **Interact with the bot on Telegram:**\n   - Search for your bot by name on Telegram and start a conversation.\n\n- **/start**: Start the bot and view the main menu.\n- **Handle Messages**: Send a message to the bot to ask a question or request resources.\n\n## 🛠️ Bot Functionalities\n\n### Welcome Message \u0026 Menu\n\nWhen users start the bot, they receive a welcome message along with a menu offering different options:\n\n```plaintext\n🎓Welcome to AAIT Mechanical Engineering Study Bot (Mechify)!🎓\n\nChoose an option below to get started:\n```\n\n### Resource Access\n\nUsers can select their year or exam category to access relevant study materials:\n\n```plaintext\n🌟 Click below to access your study resources and level up your learning! 📚🚀\n```\n\n### AI Instructor\n\nUsers can ask the bot about any topic, and the bot will generate a detailed response using Cohere's AI:\n\n```plaintext\nPlease mention the topic you want to learn about 📚, I'm here to help as your Ai Instructor! 🤖\n```\n\n### Developer Info\n\nInformation about the developers behind the bot:\n\n```plaintext\n👨‍💻 Developed with Passion by the AAIT Mechanical Engineering Team! 👩‍💻\n```\n\n## 🛡️ Error Handling\n\n- The bot gracefully handles API errors and informs the user if it is unable to generate a response or fetch a YouTube video.\n\n## 🙌 Acknowledgments\n\n- **Cohere API** for natural language processing.\n- **YouTube Data API** for fetching relevant video content.\n\n---\n\nHappy Studying! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgashu-101%2Fmechify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgashu-101%2Fmechify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgashu-101%2Fmechify/lists"}