Personal Assistant for Linux and macOS
Clone or download


Build Status Join the chat at

A Personal Assistant for Linux and MacOS


Jarvis is a simple personal assistant for Linux and MacOS which works on the terminal. He can talk to you if you enable his voice. He can tell you the weather, he can find restaurants and other places near you. He can do some great stuff for you. Stay updated about new functionalities.

Getting Started

In order to start Jarvis just clone the repository and run ./

Run Jarvis from anywhere by command jarvis

On Mac OS X don't forget to activate virtual environment before running jarvis with the command . env/bin/activate

You can start by typing help within the Jarvis command line to check what Jarvis can do for you.

Youtube Video

Click here


  • PR's are accepted!!
  • We follow PEP 8 guidelines. Before making a PR, make sure that your code is according to PEP8 standards.
  • If you have some ideas for new features and you don't have time to implement them please open an issue with the tag new_feature
  • Please don't forget to comment (document) your code

How to run tests:



How to write new commands (plugins) to extend Jarvis functionality

Create new file custom/

from plugin import plugin

def helloworld(jarvis, s):
    """Prints \"hello world!\""""
    jarvis.say("Hello World!")

def repeat(jarvis, s):
    """Repeats what you type"""

Check it out!

Jarvis' sound is by default disabled.
In order to let Jarvis talk out loud type: enable sound
Type 'help' for a list of available actions.

~> Hi, what can I do for you?
Hello World!
~> What can i do for you?
repeat Jarvis is cool!
jarvis is cool

Click here to learn more about plugins.



See also the list of contributors who participated in this project.


This project is licensed under the MIT License - see the LICENSE file for details