Zozo Assistant is a Python-based voice-controlled assistant that uses natural language processing to answer questions and perform various tasks. But also you can use it if you don't have a microphone. The assistant can provide answers to pre-defined questions, play music, say weather, set alarms, tell the time and date, and engage in general conversation. This application leverages the OpenAI API for sophisticated language processing, but also includes a fallback pipeline model for situations where the API is not accessible. The code in train.py
trains a chatbot using a Linear Support Vector Machine (SVM) classifier. It reads a dataset from a file named datamain.txt
, which contains a collection of questions and corresponding answers. The chatbot learns from this dataset and creates a pipeline model using the CountVectorizer
, TfidfTransformer
, and LinearSVC
from scikit-learn. The text data is preprocessed using a custom function that removes punctuation, converts text to lowercase, and applies lemmatization to reduce words to their base or root form. This preprocessing step helps to improve the model's ability to understand and respond to a variety of inputs. Once trained, the model is saved as model2.joblib
for future use when the API is not available.
- Speech recognition: Zozo can listen to user input through a microphone and convert it into text using the SpeechRecognition library.
- Text-to-speech: Zozo can respond to users by converting text into speech using the pyttsx3 library.
- Weather: Users can ask for the current weather information for a location, and Zozo will provide the information.
- Music player: Zozo can play a collection of music files in the "music" folder. Users can control playback with voice commands or by entering options.
- Alarm: Users can set alarms by specifying the duration in seconds. Zozo will play a sound after the specified time has elapsed.
- Date and time: Users can inquire about the current date and time, and Zozo will provide the information.
- OpenAI integration: Utilize the OpenAI API for advanced language processing (API key required).
- Fallback pipeline model: If the OpenAI API is unavailable, the assistant falls back to a pre-trained pipeline model.
- Clean and minimalist UI design
- Python 3.x
- OpenAI API
- OpenWeather API
- pyaudio
- joblib
- nltk
- scikit-learn
- pygame
- tkinter
- requests
- pyttsx3
- word2number
- SpeechRecognition
- jsonlib-python3
- openai
- numpy
- pandas
- Clone the repository:
git clone https://github.com/Amirrezahmi/Zozo-Assistant.git
- Navigate to the project directory:
cd Zozo-Assistant
- Install the required dependencies by running the following command:
pip install -r requirements.txt
- As stated earlier, we are using
pyttsx3
in this program. It is essential to note that this program has been developed on a Windows-powered device, which may result in encountering errors with certain libraries on other operating systems, such as pyttsx3. pyttsx3 uses speech synthesis engines that depend on your operating system. Make sure that the corresponding speech engine is correctly installed and configured. For example, on Linux, pyttsx3 uses espeak. You might need to install it in case you are using Linux:
sudo apt-get update && sudo apt-get install espeak
- Open the
main.py
andui.py
files and locate theOPENAI_API_KEY
andapiKey
variables. Paste your OpenAI API key intoOPENAI_API_KEY
variable, and paste your OpenWeather API key intoapiKey
variable. - If you don't have a microphone or encounter any issues with the microphone-related functions, in the beginning of running
main.py
the program asks you that do you have a microphone or not and you can answer no if you don't. Inui.py
I haven't implemented a microphone button yet and you should write your input prompt or use buttons, but I'll implement a button for microphone soon! - If
model2.joblib
dosen't work, delete it and runtrain.py
again. Because sometimes the model only works on specefic version of Python that has trained before. - Run the
main.py
script (for console-based) orui.py
script (for user interface (UI)) to start the Zozo Assistant. - At the beggining say "Zozo" or "Hey Zozo" to get the Asisstant attention. (If you chossed the microphone option at the begging.)
- Interact with the chatbot by asking questions, playing music, weather, setting alarms, or requesting the current date and time or any other prompts.
- To exit the chatbot, say "bye", "goodbye" or "exit".
Zozo Assistant has undergone a transformation from a console-based project to a visually captivating user interface (UI). Although the UI remains basic, it provides a simple and intuitive way for users to interact with the assistant, enhancing their overall experience.
- Basic and minimalist UI design that focuses on functionality.
- Easy navigation through the assistant's features.
- Intuitive controls and straightforward interaction methods.
- Streamlined functionality for seamless execution of commands.
Despite its basic nature, the UI of Zozo Assistant ensures that users can effortlessly interact with the assistant's capabilities without any unnecessary complexity. The clean and minimalist design allows for a distraction-free experience, enabling users to focus on the assistant's functionality and make the most out of their interactions.
Feel free to modify the text according to your preferences and specific features of your UI.
This section includes hands-on, practical examples demonstrating how to interact with the Zozo-Assistant. Here, you will find examples for both console-based and GUI-based interactions.
Uncover different scenarios for interacting with the Zozo-Assistant using the console. This section delves into specific situations, portraying what happens when the microphone is accessible and when it isn't.
This part describes the interaction flow when the user does not grant microphone access. After the initial question from the program about microphone accessibility, if the user responds with "no", the subsequent interaction process unfolds as demonstrated in the screenshot below:
A video demonstration showcasing what happens when the user provides microphone access โ that is, when the microphone accessibility question is answered with a "yes". This video depicts how the program responds and guides on the subsequent steps the user needs to take.
vid1.4.mp4
This subsection contains a visual guide on how to navigate and interact with the Zozo-Assistant using the graphical user interface (GUI).
In the ui.py
, I will apply minor changes to make it more beautiful in the future, which may not be in this video because this is just a software test.
ggg.2.mp4
In this section, we will discuss the process of implementing the Zozo-Assistant project on a Raspberry Pi. Raspberry Pi is a small, affordable single-board computer that provides the necessary processing power for running our program. We chose to use the Raspberry Pi Model 4 with 8 GB RAM for this implementation.
To install the operating system on the Raspberry Pi, follow these steps:
- Download the desired operating system image for Raspberry Pi 4, such as Raspbian (now called Raspberry Pi OS), Ubuntu, or OSMC.
- Use software like Etcher to write the downloaded operating system image to a microSD memory card.
- Insert the memory card into the Raspberry Pi and connect the necessary cables, including the HDMI cable for monitor connection and power cable.
- Power up the Raspberry Pi.
Instead of using an HDMI cable, we used a LAN cable to connect the Raspberry Pi to the modem. We obtained the IP address using the PuTTy program and connected to it using the RealVNC viewer program.
When the Raspberry Pi boots up, follow these steps for the initial setup:
- Configure the date, language, network, and other settings as required.
- Update the operating system to get the latest updates and benefits from the facilities. Use the command line with appropriate commands to perform the system update.
To install pip and easily install libraries with pip in the terminal on Raspberry Pi, follow these steps:
- Open a terminal on your Raspberry Pi.
- Update the package list by running the following command:
sudo apt-get update
- Install the
python3-pip
package, which provides the pip command for Python 3, by running the following command:
sudo apt-get install python3-pip
- Once the installation is complete, you can use the pip command to install libraries. For example, to install a library named
library-name
, run the following command:
pip install library-name
Replace library-name
with the actual name of the library you want to install.
To run the Zozo-Assistant program on the Raspberry Pi, follow these steps:
- Prepare the Raspberry Pi operating system by installing Python. Update the Python version using the following commands:
sudo apt update
sudo apt upgrade
sudo apt install python3
- Transfer the Python program (e.g.,
main.py
) written in VSCode to the Raspberry Pi. You can use FTP, SCP, or transfer the program using a USB flash drive. - Access the Raspberry Pi terminal and navigate to the directory where the program is saved. Execute the program using the following command:
python3 main.py
This command will run the Zozo-Assistant program and display the result.
Before running the program on the Raspberry Pi, it's recommended to test and debug it in a Linux environment. Ensure that Python is installed on the board, and adjust the code if any compatibility issues arise. In our case, we encountered problems due to the difference in Python versions between our development environment (Windows) and Raspberry Pi (Linux). We had to manually downgrade our code and fix the created bugs one by one to make it work.
Additionally, make sure to install all the required libraries in the Linux environment for successful program execution.
Please note that these instructions are specific to the Zozo-Assistant project and may vary depending on the specific requirements of your project. For further guidance, refer to the documentation provided by Raspberry Pi and the Zozo-Assistant project.
That's it! This subsection provides an overview of how to implement the Zozo-Assistant project on a Raspberry Pi, including installation, setup, and running the program. Feel free to modify and expand upon this section to provide more detailed instructions or address specific issues that may arise during the implementation process.
Happy coding!
Contributions are welcome! If you'd like to contribute to this project, please follow these steps:
- Fork the repository.
- Create a new branch: git checkout -b my-new-branch.
- Make your changes and commit them: git commit -m 'Add some feature'.
- Push to the branch: git push origin my-new-branch.
- Submit a pull request.
This project is licensed under the MIT License.
- OpenAI- For providing the chatbot API.
- tkinter- For creating the user interface (UI) components.
- NLTK - Natural Language Toolkit for text processing.
- scikit-learn- Machine learning library for building the question-answering model.
- PyAudio- For audio input/output functionality.
- pygame- Library for playing music files.
- pyttsx3- Text-to-speech library for speech output.
- SpeechRecognition- Library for speech recognition functionality.
- word2number- Library for converting words to numbers.
For any questions or inquiries, please contact [email protected]