Voice-Activated Natural Language UI
![made-with-python](https://img.shields.io/badge/Made%20with-Python-blue?style=for-the-badge&logo=Python)
![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/thevickypedia/Jarvis/badge)
Platform Supported
![Platform](https://img.shields.io/badge/Platform-Linux%7CmacOS%7CWindows-1f425f.svg)
Language Stats
![Code coverage](https://img.shields.io/github/languages/top/thevickypedia/Jarvis)
Repo Stats
![GitHub](https://img.shields.io/github/license/thevickypedia/Jarvis)
![GitHub Repo watchers](https://img.shields.io/github/watchers/thevickypedia/Jarvis)
![GitHub file count](http://jarvis.vigneshrao.com/file-count?badge=true)
![GitHub Repo pr](https://img.shields.io/github/issues-pr-raw/thevickypedia/Jarvis)
Code Stats
![Make](https://img.shields.io/github/search/thevickypedia/Jarvis/Makefile)
Deployments
![markdown](https://github.com/thevickypedia/Jarvis/actions/workflows/markdown.yml/badge.svg)
![Pypi-status](https://img.shields.io/pypi/status/jarvis-ironman)
Activity
![GitHub last release](https://img.shields.io/github/release-date/thevickypedia/Jarvis)
Development and Maintenance
![Maintainer](https://img.shields.io/badge/Maintained%20By-Vignesh%20Rao-blue.svg)
Reach Out
![askme](https://img.shields.io/badge/SELECT%20*%20FROM-questions-1abc9c.svg)
Kick off
Recommendations
Install Jarvis
python -m pip install jarvis-ironman
Install Dependencies
jarvis install
Initiate - IDE
import jarvis
if __name__ == '__main__':
jarvis.start()
Initiate - CLI
jarvis start
Use jarvis --help
for usage instructions.
Prerequisites
-
MacOS
Tested on Mojave, Catalina, Big Sur, Monterey and Ventura
System Preferences
→ Security & Privacy
→ Privacy
- Click
+
sign and add the preferred IDE
and Terminal
in the following sections in left pane.
Microphone
- Required to listen and respond.Accessibility
- Required to use key combinations for brightness and volume controls.Camera
- [Optional] Required only during face recognition/detection.Automation
- Required to control System Events
and other apps like Outlook and Calendar.Files and Folders
[OR] Full Disk Access
- Required for all FileIO
operations.
-
Linux
Tested on Ubuntu 22.04 LTS
- Store the host machine's password as the env var:
ROOT_PASSWORD
- Unlike macOS and Windows,
Ubuntu
does not have app specific permissions.
-
Windows
Tested on Windows 10
Settings
→ Privacy
Microphone
- Required to listen and respond.Camera
- [Optional] Required only during face recognition/detection.- Unlike
macOS
, Windows
pops a confirmation window to Allow or Deny access to files and folders.
- Install Anaconda or Miniconda, VisualStudio C++ BuildTools, and Git
- Make sure C++ build tools are installed completely and restart
- Add anaconda/miniconda scripts location to
PATH
in Environment Variables
Enchiridion
Handbook - GitHub Wiki
Coding Standards
Docstring format: Google
Styling conventions: PEP 8
and isort
Requirement
python -m pip install gitverse
Usage
gitverse-release reverse -f release_notes.rst -t 'Release Notes'
Linting
pre-commit
will ensure linting, run pytest, generate runbook & release notes, and validate hyperlinks in ALL
markdown files (including Wiki pages)
Requirement
python -m pip install sphinx==5.1.1 pre-commit recommonmark
Usage
pre-commit run --all-files
Pypi Package
![pypi-module](https://img.shields.io/badge/Software%20Repository-pypi-1f425f.svg)
https://pypi.org/project/jarvis-ironman/
Runbook
![made-with-sphinx-doc](https://img.shields.io/badge/Code%20Docs-Sphinx-1f425f.svg)
https://jarvis-docs.vigneshrao.com/
License & copyright
© Vignesh Rao
Licensed under the MIT License