https://github.com/ahammadshawki8/bhai-the-assistant
A simple AI assistant that can help you to accomplish daily goals 🧠
https://github.com/ahammadshawki8/bhai-the-assistant
ai-assistant automation bot home-assistant
Last synced: 10 days ago
JSON representation
A simple AI assistant that can help you to accomplish daily goals 🧠
- Host: GitHub
- URL: https://github.com/ahammadshawki8/bhai-the-assistant
- Owner: ahammadshawki8
- License: mit
- Created: 2021-01-30T14:20:12.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-04-28T06:51:16.000Z (almost 3 years ago)
- Last Synced: 2025-03-26T06:34:37.660Z (28 days ago)
- Topics: ai-assistant, automation, bot, home-assistant
- Language: Python
- Homepage:
- Size: 809 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](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](bhai.py) file and divided the file into some specific code blocks.
- Imports
- Initializations
- Functions
- Main Loop
## How to use
- [Download](https://github.com/ahammadshawki8/BHAI-the-assistant/archive/refs/heads/main.zip) the repository and extract the zip file.
- Install [python3](https://www.youtube.com/watch?v=bCY4D9n3Pew&ab_channel=ProgrammingKnowledge) 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](requirements.txt) file
- `pip install -r requirements.txt`
- Run the [bhai.py](bhai.py) script and enjoy :3
- `python bhai.py`
- If you face any bugs, create an issue [here](https://github.com/ahammadshawki8/BHAI-the-assistant/issues/new/choose) 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](https://github.com/ahammadshawki8/BHAI-the-assistant/issues/new/choose) and let me know.
- If you want to enhance the assistants capabilities and add new features, first create an issue [here](https://github.com/ahammadshawki8/BHAI-the-assistant/issues/new/choose) and let me know.
- [Fork](https://github.com/ahammadshawki8/BHAI-the-assistant/fork) the repository and after the development create a [Pull Request](https://github.com/ahammadshawki8/BHAI-the-assistant/pulls)
- 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](LICENSE) file.