class platypush.plugins.assistant.echo.AssistantEchoPlugin(avs_config_file: Optional[str] = None, audio_device: str = 'default', audio_player: str = 'default', **kwargs)[source]

Bases: AssistantPlugin

Amazon Echo/Alexa assistant plugin.

In order to activate the Echo service on your device follow these steps:

  1. Install avs (pip install git+

  2. Run the alexa-auth script. A local webservice will start on port 3000

  3. If a browser instance doesn’t open automatically then head to http://localhost:3000

  4. Log in to your Amazon account

  5. The required credentials will be stored to ~/.avs.json



  • avs (pip install avs)

__init__(avs_config_file: Optional[str] = None, audio_device: str = 'default', audio_player: str = 'default', **kwargs)[source]
  • avs_config_file – AVS credentials file - default: ~/.avs.json. If the file doesn’t exist then an instance of the AVS authentication service will be spawned. You can login through an Amazon account either in the spawned browser window, if available, or by opening http://your-ip:3000 in the browser on another machine.

  • audio_device – Name of the input audio device (default: ‘default’)

  • audio_player – Player to be used for audio playback (default: ‘default’). Supported values: ‘mpv’, ‘mpg123’, ‘gstreamer’


Start a conversation.


Stop a conversation.