gassist_text

A Python library for interacting with Google Assistant API via text

Credits

Uses https://pypi.org/project/google-assistant-grpc/. See instructions there how to get credentials.json.

Code is essentially a copy of https://github.com/googlesamples/assistant-sdk-python/blob/master/google-assistant-sdk/googlesamples/assistant/grpc/textinput.py wrapped in a package.

Example

import json
import google.oauth2.credentials
with open('/path/to/credentials.json', 'r') as f:
    credentials = google.oauth2.credentials.Credentials(token=None, **json.load(f))

from gassist_text import TextAssistant
with TextAssistant(credentials) as assistant:
    print(assistant.assist('tell me a joke')[0])
    print(assistant.assist('another one')[0])

Limitations/Known issues

• Broadcast commands don't work unless speakers and device that runs this library are in the same network and IPv6 is disabled in the router
• Most queries for media controls don't work
  • not working: e.g. play music on kitchen speaker, stop kitchen speaker
  • working: e.g. play news on kitchen speaker, play rain sounds on bedroom speaker
• Routines don't work
• Queries for personal results don't work

Development environment

python3 -m venv .venv
source .venv/bin/activate
# for Windows CMD:
# .venv\Scripts\activate.bat
# for Windows PowerShell:
# .venv\Scripts\Activate.ps1

# Install dependencies
python -m pip install --upgrade pip
python -m pip install .

# Generate embedded_assistant_pb2.py and embedded_assistant_pb2_grpc.py
python -m pip install grpcio-tools
python -m grpc_tools.protoc -Isrc --python_out=src --grpc_python_out=src src/google/assistant/embedded/v1alpha2/embedded_assistant.proto

# Run formatter
python -m pip install isort black
isort src/gassist_text tests demo.py browser_helpers.py
black src/gassist_text tests demo.py browser_helpers.py

# Run lint
python -m pip install flake8
flake8 src/gassist_text tests demo.py browser_helpers.py --count --select=E9,F63,F7,F82 --show-source --statistics
flake8 src/gassist_text tests demo.py browser_helpers.py --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics

# Run tests
python -m pip install pytest
pytest

# Run command line interactive tool
python -m pip install click beautifulsoup4
python demo.py --display --audio_out

# Build package
python -m pip install build
python -m build