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
If you see the issued commands in My Google Activity the library is working fine. If the commands don't have the expected outcome, don't open an issue in this repository. You should instead report the issue directly to Google here. Examples of known Google Assistant API 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
- Commands that need to verify your identity through voice match don't work
To get personal results working you need to create an OAuth client ID of Desktop app, see step by step instructions here.
Development environment
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install .
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
python -m pip install pre-commit
pre-commit install
pre-commit run --all-files
python -m pip install isort black flake8 ruff
isort . ; black . ; flake8 . ; ruff . --fix
python -m pip install pytest
pytest
python -m pip install click beautifulsoup4
python demo.py --display --audio_out
python -m pip install build
python -m build