Skip to main content

Personal Assistant for Linux

Project description

# Jarvis

[![Build Status](https://travis-ci.org/sukeesh/Jarvis.svg?branch=master)](https://travis-ci.org/sukeesh/Jarvis)

A Personal Assistant for Linux

![Jarvis](http://i.imgur.com/xZ8x9ES.jpg)

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

## Getting Started

In order to start Jarvis just clone the repository and run the command: `python jarviscli`.

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

### Prerequisites

Use the command `./setup.sh` to install the requirements.

## Youtube Video

[Click here](https://www.youtube.com/watch?v=PR-nxqmG3V8)

## Contributing

- 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
- If you have time to add extra functionality to Jarvis (for example new actions like "record" etc.) you only need to add this action to the actions tuple (look on init(self) in CmdInterpreter.py) as a string if it's a one word command or as a dict if it's a two word command. Then, add **appropriate methods** (substitute `record` for the name of your command):
+ `do_record(self, s)`: implement here your command functionality. `s` is where Jarvis will pass the arguments of your command.
+ `help_record(self)`: print what your command does.
+ **(optional)** `complete_record(self)`: useful to get completions, if it's a two word command use `get_completions` method:
+ `return self.get_completions("record", text)`
- Please don't forget to comment (document) your code

**Note**: one word command examples are: `say [text that Jarvis will speak]`, `weather`. Two word command examples are: `hotspot start`, `hotspot stop`, `increase volume`, `decrease volume`.

### How to run tests:
Change into the Jarvis/Jarvis directory
```bash
cd Jarvis/jarviscli
```
Then run unittest discover
```python
python -m unittest discover
```

## Authors

**sukeesh**

See also the list of [contributors](contributors.md) who participated in this project.

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jarviscli-1.0.1.tar.gz (31.1 kB view details)

Uploaded Source

File details

Details for the file jarviscli-1.0.1.tar.gz.

File metadata

  • Download URL: jarviscli-1.0.1.tar.gz
  • Upload date:
  • Size: 31.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for jarviscli-1.0.1.tar.gz
Algorithm Hash digest
SHA256 e442d4cba2244bf86510e7aad40ca333d6e12720789208004b130592b4edf5e5
MD5 92e596e0f7e4f7c3d81936bb06ae2287
BLAKE2b-256 49e5c75763bec6b0f34dbffe72f988312647879b76505a7b2ee793ed91846fc2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page