https://github.com/milobella/device
Client code in device (raspberry pi3B+ for now)
https://github.com/milobella/device
frontend milobella raspberry-pi raspberry-pi-3
Last synced: 6 months ago
JSON representation
Client code in device (raspberry pi3B+ for now)
- Host: GitHub
- URL: https://github.com/milobella/device
- Owner: milobella
- Created: 2020-07-14T10:52:34.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-12-06T08:32:58.000Z (7 months ago)
- Last Synced: 2025-12-10T01:59:24.269Z (7 months ago)
- Topics: frontend, milobella, raspberry-pi, raspberry-pi-3
- Language: Python
- Homepage:
- Size: 109 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Milobella device Client
Run milobella in a device, using mic and speakers to communicate.
## Requirements
Check requirements before install
### #1 : Google cloud authentication configuration
Authentication process is detailed in this documentation https://cloud.google.com/speech-to-text/docs/quickstart-protocol.
It is using basically a ``GOOGLE_APPLICATION_CREDENTIALS`` env variable pointing to a JSON private key file.
The JSON private key is generated when you create a Service Account.
Make sure you activated both of the APIs in your Google Cloud Project, and the same JSON file will be used.
### #2 : Milobella authentication configuration
The env variable ``MILOBELLA_AUTHORIZATION_TOKEN`` should contain the JWToken generated every time you authenticate.
A script ``authenticate.sh`` is here to show you how. (You need [jq](https://stedolan.github.io/jq/download/) if you want to use it)
```
export MILOBELLA_USERNAME=myuser
export MILOBELLA_PASSWORD=mypass
source authenticate.sh
```
### #3 : Raspberry audio configuration
If you are using a Raspberry PI B+ with RASPIAUDIO Ultra +, check the
[RASPIAUDIO ultra+ configuation](docs/raspiaudio-ultra+-configuration.md) documentation.
### #4 : Make sure you have all dependencies installed
On linux :
```bash
sudo apt-get install libasound-dev portaudio19-dev libportaudio2 libportaudiocpp0
sudo apt-get install ffmpeg
sudo apt-get install libpulse-dev
sudo apt-get install python3-pyaudio
```
## Install
```bash
pip install -r requirements.txt
pip install -U --upgrade-strategy=eager -e .
```
## Run
```
$ milobella --help
usage: milobella [-h] [--verbose] [--url URL] [--keyword KEYWORD]
[--pocket-sphinx-threshold POCKET_SPHINX_THRESHOLD] [--gpio-led GPIO_LED]
[--tracing-config TRACING_CONFIG]
optional arguments:
-h, --help show this help message and exit
--verbose increase output verbosity
--url URL Milobella URL
--keyword KEYWORD Wake up word
--pocket-sphinx-threshold POCKET_SPHINX_THRESHOLD
Pocket Sphinx threshold
--gpio-led GPIO_LED GPIO Led ID
--tracing-config TRACING_CONFIG
Tracing YAML configuration file
```
## Documentation
- [Technical choices](./docs/technical-choices.md)
- [**IN PROGRESS** Wake-up-word experimentation](./docs/wake-up-word-experimentation.md)