# respeaker_python_library

**Repository Path**: wadas/respeaker_python_library

## Basic Information

- **Project Name**: respeaker_python_library
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-26
- **Last Updated**: 2021-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

ReSpeaker Python Library
========================

[![Build Status](https://travis-ci.org/respeaker/respeaker_python_library.svg?branch=master)](https://travis-ci.org/respeaker/respeaker_python_library)

[ReSpeaker](http://respeaker.io) is an open project to create voice enabled objects.
ReSpeaker python library is an open source python library to provide basic functions of voice interaction.

It uses [PocketSphinx](https://github.com/cmusphinx/pocketsphinx) for keyword spotting and uses [webrtcvad](https://github.com/wiseman/py-webrtcvad) for voice activity detecting.


### Installation (Not for ReSpeaker Core)

>Note: This library is already installed on ReSpeaker Core by default. Please skip the installation step and don't re-install it


`python` and `pip` are required.

1. Install pocketsphinx, webrtcvad

  On windows, we can use pre-compiled python wheel packages of pocketsphinx and pyaudio from [speech_recognition](https://github.com/Uberi/speech_recognition/tree/master/third-party). For python 2.7, run:
  ```
  pip install https://github.com/respeaker/respeaker_python_library/releases/download/v0.4.1/pocketsphinx-0.0.9-cp27-cp27m-win32.whl
  pip install https://github.com/respeaker/respeaker_python_library/releases/download/v0.4.1/webrtcvad-2.0.9.dev0-cp27-cp27m-win32.whl
  ```

  On Linux
  ```
  pip install pocketsphinx webrtcvad
  ```


2. `pip install pyaudio respeaker --upgrade`


3. Install hidapi (optional)

    
MacOSX install ReSpeaker Python Library

0.(brew install python2)

1.pip2 install pocketsphinx webrtcvad

2.(Since pyAudio has portAudio as a dependency, you first have to install portaudio: **brew install portaudio**) pip install pyaudio respeaker --upgrade
3.Install hidapi (optional)


### stdio.h file not found error on macOS Mojave
For anyone discovering this later on who may not be familiar with the command line, here's how to install the macOS_SDK_headers_for_macOS_10.14.pkg package as explained in @yicongli's response above:

In Terminal.app or any shell app like iTerm:

cd /Library/Developer/CommandLineTools/Packages/
open macOS_SDK_headers_for_macOS_10.14.pkg

Make sure you go through the whole thing and try to install the gem that failed to install again or run bundle install again if this was something you encountered while trying to install from a Gemfile.




### Getting started

```
import logging
import time
from threading import Thread, Event

from respeaker import Microphone


def task(quit_event):
    mic = Microphone(quit_event=quit_event)

    while not quit_event.is_set():
        if mic.wakeup('respeaker'):
            print('Wake up')
            data = mic.listen()
            text = mic.recognize(data)
            if text:
                print('Recognized %s' % text)


def main():
    logging.basicConfig(level=logging.DEBUG)

    quit_event = Event()
    thread = Thread(target=task, args=(quit_event,))
    thread.daemon = True
    thread.start()
    while True:
        try:
            time.sleep(1)
        except KeyboardInterrupt:
            print('Quit')
            quit_event.set()
            break
    time.sleep(1)

if __name__ == '__main__':
    main()
```