ghome-foyer-api

What it is and what it does

This package distributes pre-generated Protobuf stubs for Google Home's Foyer API, solving a specific problem: when multiple libraries use the same Protobuf definitions, only one version of the stubs can be loaded at runtime, even if different modules define them separately. By centralizing the stubs in a single package with pinned versions of grpcio and protobuf, it eliminates version conflicts and ensures all consumers see the same API definitions.

The package exports both the generated stubs and type hints, making it suitable for projects that need to interact with Google Home devices via the Foyer API. It is maintained actively and supports Python 3.9 and later. The stubs are regenerated from a proto file via a build script, so the package stays synchronized with the underlying API definition.

Use it for:

• Building a Google Home control or monitoring application that needs to communicate with local Foyer API endpoints.
• Integrating Google Home device discovery or management into a larger home automation system.
• Developing a library that wraps Foyer API functionality without forcing consumers to manage Protobuf version conflicts.
• Type-safe gRPC client code for Google Home devices using generated stubs and type hints.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides generated Protobuf stubs for the Google Home Foyer API, ensuring a single version of stubs is loaded across libraries to avoid Protobuf version conflicts.

Yes, if you need to interact with Google Home's Foyer API. The package solves a real Protobuf versioning problem, is actively maintained, has no known vulnerabilities, and carries a permissive MIT license. Install friction is low. The small repository size (3 stars) reflects its narrow, specialized use case rather than any quality concern.

Install

ghome-foyer-api on PyPI

pip install ghome-foyer-api

uv add ghome-foyer-api

poetry add ghome-foyer-api

Installing ghome-foyer-api

Before you install

Low friction installation with a pure-Python wheel. Actively maintained as of August 2026, with recent commits and no known vulnerabilities. Depends on grpcio and protobuf, which are standard dependencies in the gRPC ecosystem.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install ghome-foyer-api

import ghome_foyer_api
# Use generated stubs from the package

Requires Python 3.9 or later.

Verify before relying

• Whether the package is actively maintained beyond August 2026 (last commit visible as of fact sheet date).
• Specific API surface and which Foyer API methods are covered by the generated stubs.
• Whether type hints are complete enough for full IDE support and static type checking.

Package facts

Evidence: ghome_foyer_api-1.2.2-py3-none-any.whl

Keywords: Foyer API, Google Home

Tags

More Software Development packages