Skip to main content
Help us improve Python packaging – donate today!

Vinisto - a simple-minded home butler

Project Description


Vinisto is the word for “butler” in Esperanto.

It’s based on the following main directrives:

  • It has to be easy to expand
  • Non-strict, you may do as you please
  • Support many tts/stt systems
  • Multilanguage
  • KISS

But mostly, KISS is the most important one.


This requires pyaudio. I recommend installing pyaudio from your package manager It also requires pygame, wich requires the same treatment.

IE debian:

apt-get install python-pyaudio python-pygame

After that, pip install vinisto will do the magic.

Executing vinisto

Vinisto is ready to use as a library, wich is it’s main goal, but you can try with some default plugins (time and repeat) by using the built-in “vinisto” command

usage: vinisto [-h]
               [--plugins [{vinisto.plugins.gpio,,vinisto.plugins.repeat,vinisto.plugins.time}]]
               [--stt {vinisto.stt.google_stt}]
               [--tts {vinisto.tts.google_tts}] [--keyword KEYWORD]
               [--rate RATE] [--language LANGUAGE] [--key KEY]
               [--response_phrase RESPONSE_PHRASE]

Vinisto - Your personal butler

optional arguments:
  -h, --help            show this help message and exit
  --plugins [{vinisto.plugins.gpio,,vinisto.plugins.repeat,vinisto.plugins.time}]
                        List of plugin modules
  --stt {vinisto.stt.google_stt}
                        List of stt modules
  --tts {vinisto.tts.google_tts}
                        List of tts modules
  --keyword KEYWORD     Keyword to wait for
  --rate RATE           Mic rate, defaults to raspberry pi USB (24000)
  --language LANGUAGE   Language to use in both TTS and STT
  --key KEY             Key to be passed to STT engines.
  --response_phrase RESPONSE_PHRASE
                        What to say when the keyword has been detected

wich WAS (now it handles arguments, but still…) basically

from vinisto.tts.google_tts import GoogleTTS
from vinisto.stt.google_stt import GoogleSTT
from vinisto.plugins.time import Time
from vinisto.plugins.repeat import Repeat

vinisto = Vinisto()
vinisto.stt = GoogleSTT('es-ES', {'rate': 24000},
vinisto.tts = GoogleTTS('es-ES')
while True:

Expanding vinisto

Vinisto has a simple-yet-effective structure, a main package with packages for each of the principal functionalities:

  • tts
  • stt
  • plugins

Previous usage example is perfect to illustrate how to use them. And vinisto.tts.google_tts for the tts part, vinisto.stt.google_stt for the stt part and finally vinisto.plugins.time for the plugins part

Using vinisto

Vinisto waits for a keyword “vinisto” (that can be changed on After that, it’ll receive one phrase, and will try to execute it.


vinisto keyword is localized, so, in the main translation file it’ll be up to each translator to decide the best name for vinisto in its language.

That’s because, in spanish, google was having trouble recognizing “vinisto” (esperanto) keyword. Currently, its spanish name is “Bautista”, altough that might change in a future, as google voice is female, and bautista is a male name.

Translations are in the i18n folder inside the package, and are easily portable. All plugins are translatable, and currently added to pot file.

I’m looking for translators to any possible language. PRs welcome.


Github issues welcome, PRs welcome (always following a code style similar to the one already here, and PEP8 compliant).

Join the chat at



  • First bugfix release since 1
  • Fixed TTS (but still not as good as should, it goes by a nice voice now)
  • Fixed translation problems when uppercase is used


  • Made say threaded on vinisto response
  • I18n for everything.
  • Minor bugfixes


  • Updated documentation


  • Added Infrared support as a module


  • Added support for response phrase.
  • Added support to speaking a whole phrase with the keyword on it.


  • Added parameter handling

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
vinisto-0.2.2.tar.gz (10.3 kB) Copy SHA256 hash SHA256 Source None Nov 16, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page