Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/the-ethan-hunt/b.e.n.j.i.

B.E.N.J.I.- The Impossible Missions Force's digital assistant
https://github.com/the-ethan-hunt/b.e.n.j.i.

digital-assistant python3 speech-recognition speech-to-text

Last synced: about 15 hours ago
JSON representation

B.E.N.J.I.- The Impossible Missions Force's digital assistant

Host: GitHub
URL: https://github.com/the-ethan-hunt/b.e.n.j.i.
Owner: the-ethan-hunt
License: mit
Created: 2017-06-14T16:31:43.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2023-04-21T15:42:47.000Z (over 1 year ago)
Last Synced: 2024-10-19T00:20:42.773Z (3 months ago)
Topics: digital-assistant, python3, speech-recognition, speech-to-text
Language: Python
Size: 30.2 MB
Stars: 91
Watchers: 19
Forks: 94
Open Issues: 22
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: Code-of_conduct.md

Awesome Lists containing this project

README

        # B.E.N.J.I.

[![Built with ❤](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com/#)

[![works on Windows](https://img.shields.io/badge/works%20on-Windows-blue.svg)](http://shields.io/#your-badge)

[![works on Linux](https://img.shields.io/badge/works%20on-Linux-green.svg)](http://shields.io/#your-badge)

[![Works on Max](https://img.shields.io/badge/works%20on-Mac-yellow.svg)](http://shields.io/#your-badge)

[![made with &hearts in Python](https://img.shields.io/badge/made%20with%20%E2%9D%A4%20in-Python-red.svg)](http://shields.io/#your-badge)

[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/B-E-N-J-I/Lobby)



	

	


	




A digital assistant for your device that uses speech-recognition to obey your commands

NOTE #1: B.E.N.J.I. has participated in the following Open-Source Programs: Kharagpur Winter of Code 2017, GirlScript Summer Of Code 2018, NJACK Winter of Code 2018 and Kharagpur Winter of Code 2018 :tada:

NOTE #2: I was invited to talk about B.E.N.J.I at the Open-Source Summit held at IIT Kharagpur on the 21st of January 2018. You can view the slides [here](https://github.com/the-ethan-hunt/B.E.N.J.I./blob/master/OSS_IIT_KGP_Dhruv_Apte.pdf). The video session is available to watch [here](https://www.youtube.com/watch?v=dydyiqR49KE&list=PLzumvJj1-3nDRq6Le2bFSmbtz0g7CppKb&index=11) :tada:

Maintainers : [Dhruv Apte](https://github.com/the-ethan-hunt), [Abhimanyu Thakre](https://github.com/abhimanyuthakre)

### List of contents

- [Declassified debrief](#declassified-debrief)

- [Installation](#installation)

- [Contributing](#contributing)

- [FAQs](#faqs)

- [License](#license)

### Declassified debrief

[(Back to top)](#list-of-contents)

Impossible Missions Force's debrief issued to the POTUS dated 30th May 2017:


    "On properly documented analysis and Congressional finding, the Impossible Missions Force(IMF) therefore, declassifies it's junior level digital assistant titled B.E.N.J.I.,short for Brilliant and Efficient non-Javascript enabled Intelligence Systems for civilian use. It might be noted that, this is only for peaceful purposes and the IMF does not hold any responsibility on its misuse. The Force however,has full right to control the activities of the system both,legally and illegally. The Force also submits that any covert action taken due to the system is not questionable to any Congressional hearing. Finally the Force asserts that its agents,operatives or analysts neither accept nor deny details of any operation regarding B.E.N.J.I. to any hearing without the Secretary's approval."



### Installation

[(Back to top)](#list-of-contents)

You can install B.E.N.J.I. on your laptop by cloning this repository as of first:

1. `git clone http://github.com/the-ethan-hunt/B.E.N.J.I.`

2. Open your `IPython notebook` to `%run benji.py`. For `Command Prompt` try `python benji.py`. 



Note:If a module is not found, then install each module by: pip install modulename


P.S. B.E.N.J.I. now works for Windows, Linux and Mac OS :tada:

#### Mac Installation Troubleshooting

````

    creating build/temp.macosx-10.12-x86_64-3.6/src

    clang -Wno-unused-result -Wsign-compare -Wunreachable-code -fno-common -dynamic -DNDEBUG -g -fwrapv -O3 -Wall -Wstrict-prototypes -DMACOSX=1 -I/usr/local/include -I/usr/local/opt/openssl/include -I/usr/local/opt/sqlite/include -I/usr/local/Cellar/python3/3.6.4/Frameworks/Python.framework/Versions/3.6/include/python3.6m -c src/_portaudiomodule.c -o build/temp.macosx-10.12-x86_64-3.6/src/_portaudiomodule.o

    src/_portaudiomodule.c:29:10: fatal error: 'portaudio.h' file not found

    #include "portaudio.h"

             ^~~~~~~~~~~~~

    1 error generated.

    error: command 'clang' failed with exit status 1

    ----------------------------------------

Command "/usr/local/opt/python3/bin/python3.6 -u -c "import setuptools, tokenize;__file__='/private/var/folders/fv/cy3_1czs31q64478bzxd7_m5vdlrd8/T/pip-build-z73z9sim/PyAudio/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" install --record /var/folders/fv/cy3_1czs31q64478bzxd7_m5vdlrd8/T/pip-wh091sp7-record/install-record.txt --single-version-externally-managed --compile" failed with error code 1 in /private/var/folders/fv/cy3_1czs31q64478bzxd7_m5vdlrd8/T/pip-build-z73z9sim/PyAudio/

You are using pip version 9.0.1, however version 10.0.1 is available.

You should consider upgrading via the 'pip install --upgrade pip' command.

````

Command to solve the above: ```brew install portaudio && pip3 install pyaudio```

```

Traceback (most recent call last):

  File "MacOS/benji.py", line 3, in 

    from PIL import ImageTk

ModuleNotFoundError: No module named 'PIL'

```

Command to solve the above: ```pip3 install Pillow```

```

Traceback (most recent call last):

  File "MacOS/benji.py", line 10, in 

    import wikipedia

ModuleNotFoundError: No module named 'wikipedia'

```

Command to solve the above: ```pip3 install wikipedia```

```

Traceback (most recent call last):

  File "MacOS/benji.py", line 21, in 

    import speech_recognition as sr

ModuleNotFoundError: No module named 'speech_recognition'

```

Command to solve the above: ```pip3 install SpeechRecognition```

```

Traceback (most recent call last):

  File "MacOS/benji.py", line 23, in 

    import pyttsx3

ModuleNotFoundError: No module named 'pyttsx3'

```

Command to solve the above: ```pip3 install pyttsx3```

Change the pip version above according to what you have installed on your mac.

### B.E.N.J.I working in Linux

![Working in Linux](working-benjion-linux.gif)

### B.E.N.J.I working on Windows

![Working on Windows](working-benji-windows.gif)

### B.E.N.J.I working on Mac

![Working on Windows](working-benji-mac.gif)

### Contributing

[(Back to top)](#list-of-contents)

Contributions are welcomed heartily; any new `feature` or a `bug fix` is great! :smile: 


### FAQs

[(Back to top)](#list-of-contents)

1. How to use B.E.N.J.I. to open a website/webpage?

* Say "facebook.com" and B.E.N.J.I. will open the requested page. Here, it's important to specify the top-level domain i.e. ".com".

2. How to use the news feature?

* Say "news the hindu" and B.E.N.J.I. will open list of latest "news" by requested news agency.

3. How to use the recording feature? (Windows)

* "UScreenCapture" and "ffmpeg" needed to run this feature.   

### License

[(Back to top)](#list-of-contents)

The MIT License 2017 - [Dhruv Apte](http://github.com/the-ethan-hunt/).