BHAI-the-assistant

A simple AI assistant that can help you to accomplish daily goals 🧠

Created with 🐍 and 💚 by @ahammadshawki8

Show some care by giving the repository a ⭐

Functionalities

• Continue basic conversation
• Provide system report, weather report, and speedtest network report
• Tell the current time and today's date
• Perform dynamic news searching using Google News API
• Open Web Browser, Visual Studio Code, Calculator, and Office Softwares like Word, Powerpoint, and Excel
• Open Google, YouTube, Facebook, LinkedIn and Gmail
• Search on Google, YouTube and Wikipedia
• Capture your selfie or a screenshot.
• Tell you random jokes (maybe Dad jokes :3)
• Send messages to your Facebook friends
• Compose and send emails
• play a music or start a movie for you
• Pause or resume the current track or move to next/previous track
• Increase or decrease system output volume
• Do basic calculation
• sleep

Repository description

This entire project repository only contains one single file bhai.py. Other files are auxiliary. I have ignored the modularity principle in this project. But considering the benefits of collaborators, I have added sufficient documentation (doc strings) in the bhai.py file and divided the file into some specific code blocks.

• Imports
• Initializations
• Functions
• Main Loop

How to use

• Download the repository and extract the zip file.
• Install python3 on your device
• Start a virtual environment. In console write-
  • pip install virtualenv
  • virtualenv venv
  • venv/Scripts/activate
• Install all dependencies from the requirements.txt file
  • pip install -r requirements.txt
• Run the bhai.py script and enjoy :3
  • python bhai.py
• If you face any bugs, create an issue here and let me know.

How to contribute

Thanks a lot if you have thought about contribution. Since this is an assistant software, here sky is the limit meaning lots of functionalities can be added to this software. Heres what you can do

• First of all use the software and test every functions.
• Make sure you understand the code properly. Doc strings might help you.
• If you find any bugs, create an issue here and let me know.
• If you want to enhance the assistants capabilities and add new features, first create an issue here and let me know.
• Fork the repository and after the development create a Pull Request
• I will check the PR, recommend any changes if needed and then merge it to the main branch.

License

MIT License
Copyright (c) 2022 Ahammad Shawki

Details can be found in the LICENSE file.