---
id: ghome-foyer-api
version: "1.2.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# ghome-foyer-api — Generated protobuf stubs for Google Home Foyer API

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

## 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 above — 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

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

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

## Tags

google home foyer api, protobuf stubs google home, grpc google home integration, foyer api client, google home local api, google-home, protobuf-stubs, grpc

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