---
id: gassist-text
version: "0.0.14"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# gassist-text — A Python library for interacting with Google Assistant API via text

License: permissive · Maintenance: active · Downloads: 73.5K/mo

## What it is and what it does

gassist_text is a thin Python wrapper around the Google Assistant gRPC API that lets you send text queries to Google Assistant and receive responses programmatically. It handles the gRPC transport layer and credential management, reducing boilerplate for applications that need to integrate Assistant capabilities without building a full voice interface.

The library depends on google-auth, grpcio, protobuf, and requests to manage authentication and communicate with Google's servers. It requires Python 3.11 or later and a valid OAuth credentials file (obtained through Google Cloud setup). The package is actively maintained, has no known security vulnerabilities, and installs with minimal friction.

Use it for:

- Build a text-based chatbot or voice assistant interface that delegates to Google Assistant for fulfillment.
- Integrate Google Assistant capabilities into a Python application without managing raw gRPC protocol details.
- Automate routine queries (weather, news, smart home commands) via text in a headless environment.
- Create a custom control panel or dashboard that sends commands to Google Assistant and captures responses.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wraps the Google Assistant API to send text queries and receive responses via gRPC, handling authentication and session management.

Yes, if you need to send text commands to Google Assistant from a Python application and have already obtained OAuth credentials. The library is actively maintained, has low install friction, and is licensed permissively. Be aware that many Assistant features (routines, media controls, broadcast commands) have known limitations documented by Google, so verify your use case works before committing to it.

## Install

pip install gassist-text
uv add gassist-text
poetry add gassist-text

## Installing gassist-text

Before you install: Low friction install with four standard runtime dependencies. Actively maintained as of August 2026, with a recent commit history and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use, modification, and distribution with minimal restrictions.

Quickstart:

import json
import google.oauth2.credentials
from gassist_text import TextAssistant

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

with TextAssistant(credentials) as assistant:
    response = assistant.assist('tell me a joke')
    print(response[0])

Requires Python >=3.11 and a valid Google Assistant OAuth credentials.json file with appropriate scopes.

Verify before relying:

- Whether the library handles credential refresh automatically or requires manual token management
- Performance characteristics when handling concurrent requests or long-running sessions
- Exact API coverage relative to the full Google Assistant gRPC surface

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google assistant text api, text-based google assistant, google assistant grpc python, interact with google assistant, google assistant sdk text, google assistant api wrapper, google-assistant, grpc-client

[View on SkillFed](https://skillfed.io/packages/gassist-text) · [View on PyPI](https://pypi.org/project/gassist-text/)