Linux Mate

Linux Mate is your personal Linux assistant, ready to help you solve your doubts, whether you are beginner or a pro Linux User. LinuxMate leverages the power of Gemini API, made by Google to answer your questions right from your command line interface. Linuxmate is still in development (Current Version 1.0.0), and feel free to suggest any future improvements and/or bug fixes.

Installation Guide

1. Download the .deb file

   Navigate to the linuxmate_package/deb_dist/ directory and download python3-linuxmate_1.0.0-1_all.deb

2. Create Gemini API key

   Go to the Google AI studio website. Log in to Gemini if prompted to do so. On the top left corner, click the button : Get API Key. Select either Existing project or New Project and click on Create API Key. Copy this API Key. Do not share this API Key with anyone, as it can be misused if shared or stolen

3. Setup API key as an environment variable

   The program relies on the fact that you store your API key in an environment variable called "GEMINI_API_KEY". To set up this environment variable, open your shell and type in the following command to open up .bashrc file
   gedit .bashrc
   Then copy the below command and paste it in the beginning of the opened file (This is just a good practise. You can paste it anywhere in the file), and then save it. Make sure to replace {Your_API_Key} with the API Key that you got from step 2 export GEMINI_API_KEY = {Your_API_Key} To make sure the change is saved, type the following command : source .bashrc
   

4. Installing dependencies

   The LinuxMate program requires some additional files that are not pre-installed to work. These files are called dependencies. Run the following command in the shell to install the generativeai module in python
   pip install -q -U google-generativeai
   

5. Installing linuxmate

   To install linuxmate, paste the below command in your shell
   sudo dpkg -i python3-linuxmate_1.0.0-1_all.deb
   Now, LinuxMate should be installed. To test if linuxmate has been successffully installed, type linuxmate in the shell and hit Enter. If usage help of linuxmate is shown, it has been successfully installed.

Using LinuxMate

To use LinuxMate, make sure you have an internet connection. Run the below command, and make sure to replace {question} with your question, and make sure that it is enclosed within double quotes. Hit Enter, and wair for some time for the answer to load.
linuxmate "{question}"
An example screenshot is attahed below.

LinuxMate is licensed under the GNU GPL 3.0 license or later. Read LICENSE for more information. Your support and constructive criticism is always welcome. Thaank you for using linuxmate