clara/kaylee: Somewhat fancy voice command recognition software

Somewhat fancy voice command recognition software

Clara Hobbs d7fb99707f Remove the pass_words option Since Kaylee now supports Python plugins that can do arbitrary things with spoken words, the pass_words option for shell commands seems somewhat less necessary than before. I never liked it in the first place, because it was all-or-nothing: there was no non-hackish way to pass the spoken words to only specific commands. If I ever see a compelling reason for this feature to come back, it may be re-implemented in the form of a second shell plugin that passes words to its commands.		8 years ago
assets	New icons!	8 years ago
data	New icons!	8 years ago
kayleevc	Remove the pass_words option	8 years ago
systemd	Add a systemd service file for starting Kaylee	8 years ago
.gitignore	Add packaging files to .gitignore	8 years ago
COPYING	Rename license file to COPYING	8 years ago
README.rst	A bit of cleanup in the README	8 years ago
kaylee.py	Reorganize classes into a "kayleevc" package	8 years ago
options.json.tmp	Initial support for plugins	8 years ago
setup.py	Update URL in setup script	8 years ago

Kaylee
======

Kaylee is a somewhat fancy speech recognizer that runs commands and
performs other functions when a user speaks loosely preset sentences. It
is based on `Blather <https://gitlab.com/jezra/blather>`__ by
`Jezra <http://www.jezra.net/>`__, but adds a lot of features that go
beyond the original purpose of Blather.

Requirements
------------

1. Python 3 (tested with 3.5, may work with older versions)
2. pocketsphinx 5prealpha
3. gstreamer-1.0 (and what ever plugin has pocketsphinx support)
4. gstreamer-1.0 base plugins (required for ALSA)
5. python-gobject (required for GStreamer and the GTK-based UI)
6. python-requests (required for automatic language updating)

**Note:** it may also be required to install
``pocketsphinx-hmm-en-hub4wsj``

Usage
-----

1. Copy options.json.tmp to ~/.config/kaylee/options.json and fill the
   "commands" section of the file with sentences to speak and commands
   to run.
2. Run Kaylee with ``./kaylee.py``. This generates a language model and
   dictionary using the `Sphinx Knowledge Base Tool
   <http://www.speech.cs.cmu.edu/tools/lmtool.html>`__, then listens for
   commands with the system default microphone.

   -  For the GTK UI, run ``./kaylee.py -i g``.
   -  To start a UI in 'continuous' listen mode, use the ``-c`` flag.
   -  To use a microphone other than the system default, use the ``-m``
      flag.

3. Start talking!

**Note:** default values for command-line arguments may be specified in
the options.json file.

Examples
~~~~~~~~

-  To run Kaylee with the GTK UI, starting in continuous listen mode:
   ``./kaylee.py -i g -c``

-  To run Kaylee with no UI and using a USB microphone recognized as
   device 2: ``./kaylee.py -m 2``

-  To have Kaylee pass each word of the matched sentence as a separate
   argument to the executed command: ``./kaylee.py -p``

-  To run a command when a valid sentence has been detected:
   ``./kaylee.py --valid-sentence-command=/path/to/command``

-  To run a command when a invalid sentence has been detected:
   ``./kaylee.py --invalid-sentence-command=/path/to/command``

Finding the Device Number of a USB microphone
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

There are a few ways to find the device number of a USB microphone.

-  ``cat /proc/asound/cards``
-  ``arecord -l``

README.rst