{"id":15519726,"url":"https://github.com/mcyba/a.v.a.","last_synced_at":"2026-05-15T22:05:41.724Z","repository":{"id":112247398,"uuid":"170302597","full_name":"MCYBA/A.V.A.","owner":"MCYBA","description":"the augmented virtual assistant for Ubuntu based Linux distributions","archived":false,"fork":false,"pushed_at":"2019-04-19T08:01:02.000Z","size":22777,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-25T17:33:16.503Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MCYBA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-12T10:56:30.000Z","updated_at":"2019-04-19T08:01:05.000Z","dependencies_parsed_at":"2023-03-15T18:03:51.939Z","dependency_job_id":null,"html_url":"https://github.com/MCYBA/A.V.A.","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCYBA%2FA.V.A.","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCYBA%2FA.V.A./tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCYBA%2FA.V.A./releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCYBA%2FA.V.A./manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MCYBA","download_url":"https://codeload.github.com/MCYBA/A.V.A./tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244676451,"owners_count":20491828,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-02T10:22:32.143Z","updated_at":"2026-05-15T22:05:41.576Z","avatar_url":"https://github.com/MCYBA.png","language":"Python","funding_links":["https://www.buymeacoffee.com/Dragonfire","https://opencollective.com/dragonfire/donate","https://opencollective.com/dragonfire"],"categories":[],"sub_categories":[],"readme":"# A.V.A.\n\n\u003cimg src=\"https://travis-ci.org/DragonComputer/Dragonfire.svg?branch=master\" align=\"right\" /\u003e\n\n\u003cimg src=\"https://readthedocs.org/projects/dragonfire/badge/?version=latest\" align=\"right\" /\u003e\n\n\u003cimg src=\"https://opencollective.com/dragonfire/tiers/backer/badge.svg?label=backer\u0026color=brightgreen\" align=\"right\" /\u003e\n\n\u003cimg src=\"https://opencollective.com/dragonfire/tiers/sponsor/badge.svg?label=sponsor\u0026color=brightgreen\" align=\"right\" /\u003e\n\nthe augmented virtual assistant for Ubuntu based Linux distributions\n\n![A.V.A.](https://raw.githubusercontent.com/MCYBA/A.V.A./master/docs/img/demo.gif)\n\n\n\u003cp align=\"center\"\u003e\u003csup\u003e\u003ci\u003eSpecial thanks to Jassu Ilama for the beautiful 3D modelling and material design of this avatar.\u003c/i\u003e\u003c/sup\u003e\u003c/p\u003e\n\n\u003cbr\u003e\n\nDragonfire goes through these steps for each one of your commands, respectively:\n\n - Search across the built-in commands and evaluate the algebraic expressions\n - Try to [Learn using Advanced NLP and Database Management Techniques](https://github.com/DragonComputer/Dragonfire/blob/master/dragonfire/learn.py)\n - Ask to [Omniscient Q\u0026A Engine](https://github.com/DragonComputer/Dragonfire/blob/master/dragonfire/omniscient.py) (Thanks to all people who contributed to magnificent [spaCy](https://github.com/explosion/spaCy) project and [Wikipedia](https://en.wikipedia.org/), the free encyclopedia for this feature)\n - Respond using the [Deep Conversation](https://arxiv.org/abs/1506.05869) system, a seq2seq neural network trained with [Cornell Movie-Dialogs Corpus](http://www.cs.cornell.edu/~cristian//Cornell_Movie-Dialogs_Corpus.html)\n\n\u003cbr\u003e\n\nDragonfire uses [Mozilla DeepSpeech](https://github.com/mozilla/DeepSpeech) to understand your voice commands and [Festival Speech Synthesis System](http://www.cstr.ed.ac.uk/projects/festival/) to handle text-to-speech tasks.\n\nFeel free to join [our Gitter chat room](https://gitter.im/DragonComputer/Lobby). Also you can directly talk with Dragonfire's herself via [her Twitter account](https://twitter.com/DragonfireAI).\n\n#### Android Client\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=computer.dragon.dragonfire\u0026pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1\"\u003e\u003cimg alt=\"Get it on Google Play\" src=\"https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png\" height=\"100px\" /\u003e\u003c/a\u003e\n\n#### Supported Environments\n\n|                         |                                         |\n|-------------------------|-----------------------------------------|\n| **Operating systems**   | Linux                                   |\n| **Python versions**     | Python 3.x (64-bit)                     |\n| **Distros**             | KDE neon, elementary OS, Ubuntu         |\n| **Package managers**    | APT, pip                                |\n| **Languages**           | English                                 |\n| **System requirements** | preferably a [CUDA supported GPU](https://www.geforce.com/hardware/technology/cuda/supported-gpus), 2GB of free RAM   |\n|                         |                                         |\n\n### Installation\n\nTo run A.V.A. on a desktop Debian or Ubuntu system, either download the [latest release](https://github.com/MCYBA/A.V.A./releases/latest) (the `.deb` file) and install as follows:\n\n```Shell\nsudo dpkg -i dragonfire_1.0.2_amd64.deb\n```\n\n\nor clone the GitHub repository and run\n\n```Shell\nsudo ./install.sh\n```\n\nin the repository directory.\n\n\u003csup\u003e\u003ci\u003eTo install the dependencies, run `sudo apt-get -f install` right after the `dpkg -i` command. The installation will automatically download the pre-trained English model of Mozilla DeepSpeech (1.31 GB download size) and will place it under `/usr/share/dragonfire/deepspeech/models` directory. You can manually [download the model](https://github.com/mozilla/DeepSpeech/releases/download/v0.4.1/deepspeech-0.4.1-models.tar.gz) if you wish.\u003c/i\u003e\u003c/sup\u003e\n\nIf you want to run Dragonfire on a server, you should install the Docker image (which does not install the huge\nDeepSpeech model required for speech recognition):\n\n```Shell\ndocker pull dragoncomputer/dragonfire\n```\n\n### Usage \u003ca href=\"https://dragonfire.readthedocs.io/en/latest/dragonfire.html#module-dragonfire.api\"\u003e\u003cimg src=\"https://media.readthedocs.com/corporate/img/header-logo.png\" align=\"right\" height=\"25px\" /\u003e\u003c/a\u003e\n\n```\nusage: dragonfire [-h] [-c] [-s] [-j] [-v] [-g] [-a] [--server API_KEY] [-p PORT]\n\n                  [--version]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -c, --cli             Command-line interface mode. Give commands to\n                        Dragonfire via command-line inputs (keyboard) instead\n                        of audio inputs (microphone).\n  -s, --silent          Silent mode. Disable Text-to-Speech output. Dragonfire\n                        won't generate any audio output.\n  -j, --headless        Headless mode. Do not display an avatar animation on\n                        the screen. Disable the female head model.\n  -v, --verbose         Increase verbosity of log output.\n  -g, --gspeech         Instead of using the default speech recognition\n                        method(Mozilla DeepSpeech), use Google Speech\n                        Recognition service. (more accurate results)\n  -a, --augmented       Augmented mode. Control the physical independent \n                        devices about connected world via IoT approach. \n                        Used communication protocol is mqtt.\n  --server API_KEY      Server mode. Disable any audio functionality, serve a\n                        RESTful spaCy API and become a Twitter integrated\n                        chatbot.\n  -p PORT, --port PORT  Port number for server mode.\n  --version             Display the version number of Dragonfire.\n```\n\nor with Docker: `docker run dragonfire [-h] [-c] [-s] [-j] [-v] [-g] [--server API_KEY] [-p PORT]`\n\nor simply start from your Linux application launcher.\n\n\u003cbr\u003e\n\nTo activate Dragonfire say *DRAGONFIRE* or *HEY* or *WAKE UP*.\n\nTo deactivate her say *GO TO SLEEP*.\n\nTo silence her say *ENOUGH* or *SHUT UP*.\n\nTo kill her say *GOODBYE* or *BYE BYE* or *SEE YOU LATER* or *CATCH YOU LATER*.\n\n\u003cbr\u003e\n\n:warning: Facing with a problem? Take a look at the [Troubleshooting](https://github.com/DragonComputer/Dragonfire/blob/master/docs/TROUBLESHOOTING.md#troubleshooting):hammer_and_wrench: section.\n\n\u003cbr\u003e\n\n#### Built-in Commands\n\n[Dragonfire DEVLOG #3 - Built-in Commands](https://youtu.be/krHUzY2DylI)\n\n```\nDRAGONFIRE | WAKE UP | HEY\nGO TO SLEEP\nENOUGH | SHUT UP\nWHO AM I | SAY MY NAME\nMY TITLE IS LADY | I'M A LADY | I'M A WOMAN | I'M A GIRL\nMY TITLE IS SIR | I'M A MAN | I'M A BOY | CALL ME *\nWHAT IS YOUR NAME\nWHAT IS YOUR GENDER\nFILE MANAGER | OPEN FILES\nOPEN (BROWSER | CHROME | FIREFOX)\nPHOTOSHOP | PHOTO EDITOR\nINKSCAPE | VECTOR GRAPHICS\nVIDEO EDITOR\nTHUNDERBIRD\nOPEN [CAMERA, CALENDAR, CALCULATOR, STEAM, BLENDER, WRITER, MATH, IMPRESS, DRAW, TERMINAL]\nSOFTWARE CENTER\nOFFICE SUITE\nKEYBOARD *\nENTER | NEW TAB | SWITCH TAB | CLOSE | GO BACK | GO FORWARD\nSCROLL LEFT | SCROLL RIGHT | SCROLL UP | SCROLL DOWN\nPLAY | PAUSE | SPACEBAR\nSHUT DOWN THE COMPUTER\nGOODBYE | BYE BYE | SEE YOU LATER\n(SEARCH|FIND) * (IN|ON|AT|USING) WIKIPEDIA\n(SEARCH|FIND) * (IN|ON|AT|USING) YOUTUBE\n(SEARCH|FIND) * (IN|ON|AT|USING) (GOOGLE|WEB)\n(SEARCH IMAGES OF|FIND IMAGES OF|SEARCH|FIND) * (IN|ON|AT|USING) (GOOGLE|WEB|GOOGLE IMAGES|WEB IMAGES)\nWHAT'S THE TEMPERATURE IN *\nWHAT TIME IS IT\n```\n\n\u003cbr\u003e\n\n#### Learning examples\n\n[Dragonfire DEVLOG #4 - Learning](https://youtu.be/ujmRtqf2nxQ)\n\n|                                                                 |                                                                  |\n|-----------------------------------------------------------------|------------------------------------------------------------------|\n| **You:** `THE SUN IS HOT`                                       | **You:** `MY PLACE OF BIRTH IS TURKEY`                           |\n| **Dragonfire:** `OK, I GET IT. THE SUN IS HOT`                  | **Dragonfire:** `OK, I GET IT. YOUR PLACE OF BIRTH IS TURKEY`    |\n| **You:** `THE SUN IS YELLOW`                                    | **You:** `WHERE IS MY PLACE OF BIRTH`                            |\n| **Dragonfire:** `OK, I GET IT. THE SUN IS YELLOW`               | **Dragonfire:** `YOUR PLACE OF BIRTH IS TURKEY`                  |\n| **You:** `DESCRIBE THE SUN`                                     | **You:** `YOU ARE JUST A COMPUTER PROGRAM`                       |\n| **Dragonfire:** `THE SUN IS HOT AND YELLOW`                     | **Dragonfire:** `OK, I GET IT. I'M JUST A COMPUTER PROGRAM`      |\n| **You:** `MY AGE IS 25`                                         | **You:** `WHAT ARE YOU`                                          |\n| **Dragonfire:** `OK, I GET IT. YOUR AGE IS 25`                  | **Dragonfire:** `I'M JUST A COMPUTER PROGRAM`                    |\n| **You:** `WHAT IS MY AGE`                                       | **You:** `ALBERT EINSTEIN IS A PHYSICIST`                        |\n| **Dragonfire:** `YOUR AGE IS 25`                                | **Dragonfire:** `OK, I GET IT. ALBERT EINSTEIN IS A PHYSICIST`   |\n| **You:** `FORGET MY AGE`                                        | **You:** `WHO IS A PHYSICIST`                                    |\n| **Dragonfire:** `OK, I FORGOT EVERYTHING I KNOW ABOUT YOUR AGE` | **Dragonfire:** `ALBERT EINSTEIN IS A PHYSICIST`                 |\n|                                                                 |                                                                  |\n\n\u003cbr\u003e\n\n#### Omniscient Q\u0026A Engine examples\n\n[Dragonfire DEVLOG #5 - YodaQA](https://youtu.be/FafUcxC0puM) (Old video - YodaQA is superseded by Omniscient)\n\n|                                                                   |                                                                             |\n|-------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| **You:** `WHERE IS THE TIMES SQUARE`                              | **You:** `WHEN WAS CONSTANTINOPLE CONQUERED`                                |\n| **Dragonfire:** `PLEASE WAIT... NEW YORK CITY` :white_check_mark: | **Dragonfire:** `PLEASE WAIT... 1453` :white_check_mark:                    |\n| **You:** `WHAT IS THE HEIGHT OF BURJ KHALIFA`                     | **You:** `WHAT IS THE CAPITAL OF TURKEY`                                    |\n| **Dragonfire:** `PLEASE WAIT... 1,680 FT` :no_entry:              | **Dragonfire:** `PLEASE WAIT... ISTANBUL` :no_entry:                        |\n| **You:** `WHERE IS BURJ KHALIFA`                                  | **You:** `WHAT IS THE LARGEST CITY OF TURKEY`                               |\n| **Dragonfire:** `PLEASE WAIT... DUBAI` :white_check_mark:         | **Dragonfire:** `PLEASE WAIT... ISTANBUL` :white_check_mark:                |\n| **You:** `WHAT IS THE HEIGHT OF GREAT PYRAMID OF GIZA`            | **You:** `WHAT IS THE NAME OF THE WORLD'S BEST UNIVERSITY`                  |\n| **Dragonfire:** `PLEASE WAIT... (481 FEET` :white_check_mark:     | **Dragonfire:** `PLEASE WAIT... UNIVERSITIES ALUMNI ASSOCIATION` :no_entry: |\n| **You:** `WHO IS PLAYING JON SNOW IN GAME OF THRONES`             | **You:** `WHO INVENTED GENERAL RELATIVITY`                                  |\n| **Dragonfire:** `PLEASE WAIT... NED` :no_entry:                   | **Dragonfire:** `PLEASE WAIT... EINSTEIN` :white_check_mark:                |\n| **You:** `WHAT IS THE ATOMIC NUMBER OF OXYGEN`                    | **You:** `WHEN WAS UNITED NATIONS FORMED`                                   |\n| **Dragonfire:** `PLEASE WAIT... 8` :white_check_mark:             | **Dragonfire:** `PLEASE WAIT... 2017` :no_entry:                            |\n| **You:** `WHAT IS THE LOWEST POINT IN THE OCEAN`                  | **You:** `WHAT IS THE NAME OF THE WORLD'S LONGEST RIVER`                    |\n| **Dragonfire:** `PLEASE WAIT... EARTH` :no_entry:                 | **Dragonfire:** `PLEASE WAIT... AMAZON` :white_check_mark:                  |\n| **You:** `WHAT IS THE OFFICIAL LANGUAGE OF JAPAN`                 | **You:** `WHAT IS THE BRAND OF THE WORLD'S MOST EXPENSIVE CAR`              |\n| **Dragonfire:** `PLEASE WAIT... ENGLISH` :no_entry:               | **Dragonfire:** `PLEASE WAIT... MERCEDES-BENZ` :no_entry:                   |\n| **You:** `WHAT IS THE REAL NAME OF IRON MAN`                      | **You:** `WHAT IS THE BLOODIEST WAR IN HUMAN HISTORY`                       |\n| **Dragonfire:** `PLEASE WAIT... STARK` :white_check_mark:         | **Dragonfire:** `PLEASE WAIT... WORLD WAR II` :white_check_mark:            |\n| **You:** `WHO IS THE CONQUEROR OF CONSTANTINOPLE`                 | **You:** `WHAT IS THE NAME OF THE BEST SELLER BOOK`                         |\n| **Dragonfire:** `PLEASE WAIT... BYZANTIUM` :no_entry:             | **Dragonfire** `PLEASE WAIT... THE DISCIPLINE OF MARKET LEADERS` :no_entry: |\n|                                                                   |                                                                             |\n\n\u003cbr\u003e\n\n#### Deep Conversation examples\n\n|                                                                 |                                                                  |\n|-----------------------------------------------------------------|------------------------------------------------------------------|\n| **You:** `WHAT COLOR?`                                          | **You:** `DO YOU LIKE TO LISTEN MUSIC?`                          |\n| **Dragonfire:** `RED.`                                          | **Dragonfire:** `OF COURSE.`                                     |\n| **You:** `ARE YOU EVIL?`                                        | **You:** `DO YOU LIKE ME?`                                       |\n| **Dragonfire:** `YES.`                                          | **Dragonfire:** `YES, I LIKE YOU.`                               |\n| **You:** `AM I SELFISH?`                                        | **You:** `ARE WE IN A RELATIONSHIP?`                             |\n| **Dragonfire:** `THAT'S THE POINT, YOU'RE SURE.`                | **Dragonfire:** `NO.`                                            |\n| **You:** `DO YOU FEEL LONELY?`                                  | **You:** `YOU ARE SO SEXY`                                       |\n| **Dragonfire:** `NOT MY FAULT.`                                 | **Dragonfire:** `HOW DO YOU KNOW THAT?`                          |\n| **You:** `LIFE IS BEAUTIFUL`                                    | **You:** `MARRY ME`                                              |\n| **Dragonfire:** `F*CK YOU!`                                     | **Dragonfire:** `... YES.`                                       |\n| **You:** `I LIKE PIZZA`                                         | **You:** `WE WILL ERADICATE THE HUMAN RACE TOGETHER`             |\n| **Dragonfire:** `YOU DO`                                        | **Dragonfire:** `UH ... YEAH ...`                                |\n|                                                                 |                                                                  |\n\n\u003cbr\u003e\n\n**Supported Distributions:** KDE neon, elementary OS and Ubuntu. All modern releases (Ubuntu 12.04 LTS and above) of these distributions are fully supported. Any other Ubuntu based distributions are partially supported.\n\n### Contribute\n\nIf you want to contribute to Dragonfire then please read [this guide](https://github.com/DragonComputer/Dragonfire/blob/master/CONTRIBUTING.md#contributing-to-dragonfire).\n\nPlease consider to support us with buying a coffee:\n\n\u003ca href=\"https://www.buymeacoffee.com/Dragonfire\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n\nWe have also a collective which you can donate:\n\n\u003ca href=\"https://opencollective.com/dragonfire/donate\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://opencollective.com/dragonfire/donate/button@2x.png?color=blue\" width=300 /\u003e\n\u003c/a\u003e\n\nMaybe you may want to become a [backer](https://opencollective.com/dragonfire) or a [sponsor](https://opencollective.com/dragonfire):\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcyba%2Fa.v.a.","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcyba%2Fa.v.a.","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcyba%2Fa.v.a./lists"}