---
id: gehomesdk
version: "2026.8.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# gehomesdk — Python SDK for GE Home Appliances

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

## What it is and what it does

gehomesdk is a Python client library for GE's SmartHQ cloud API that lets you monitor and control WiFi-enabled GE appliances (ovens, refrigerators, washers, etc.) from Python code. It handles OAuth2 authentication to GE's servers, manages websocket connections for real-time state updates, and exposes appliance objects with properties and methods for reading status and sending commands. The library is event-driven: you register callbacks for appliance discovery, state changes, and connection events, then run the client in an asyncio event loop.

The SDK is designed primarily to power Home Assistant integrations but can be used standalone for any Python automation or monitoring task. It abstracts away the complexity of GE's authentication flow (including multi-factor authentication) and the websocket protocol, leaving you to work with simple appliance and state objects. Dependencies are mainstream async libraries (aiohttp, websockets) and parsing utilities (beautifulsoup4, bidict).

Use it for:

- Integrate GE appliances into Home Assistant for unified smart-home control and automation.
- Build a monitoring dashboard that polls appliance state and displays real-time status (running, temperature, cycle progress).
- Trigger custom actions when appliances change state (e.g., send a notification when laundry is done).
- Automate appliance control based on time or external events (e.g., preheat oven at a scheduled time).
- Export appliance telemetry to a logging or analytics system for usage tracking.

## Worth the install?

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

SDK for controlling and monitoring GE WiFi-enabled (SmartHQ) appliances via websocket and REST APIs, with event-driven state tracking.

Yes, if you own GE SmartHQ appliances and need to integrate them into a Python automation or Home Assistant setup. The SDK is actively maintained, has no known vulnerabilities, uses permissive licensing, and abstracts away the complexity of GE's authentication and websocket protocol. Install friction is low. The main gotcha is that you need valid SmartHQ credentials and some accounts require MFA, which adds a one-time setup step.

## Install

pip install gehomesdk
uv add gehomesdk
poetry add gehomesdk

## Installing gehomesdk

Before you install: Low friction install with six common runtime dependencies (aiohttp, requests, websockets, beautifulsoup4, bidict, humanize). Repository is active with a recent release (12 days old) and modest but steady maintenance signal.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you retain the license notice.

Quickstart:

pip install gehomesdk

import aiohttp
import asyncio
from gehomesdk import GeWebsocketClient

loop = asyncio.get_event_loop()
client = GeWebsocketClient(username, password, region, loop)
session = aiohttp.ClientSession()
await client.async_get_credentials_and_run(session)

Requires SmartHQ account credentials (username, password, region); some accounts may require MFA verification during login.

Verify before relying:

- Exact list of supported GE appliance models and their controllable functions.
- Whether the SDK supports both websocket and REST transports equally, or if one is preferred.
- Performance characteristics under high-frequency state updates or many concurrent appliances.

## Package facts

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

## Tags

GE appliance control SDK, SmartHQ home automation, GE WiFi appliance integration, websocket appliance monitoring, home assistant GE integration, smart appliance state tracking, home-automation, iot-client, async-api

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