Firmware and hardwareWorksSource available
Target: PetKit devices

my-petkit

Platform
Home Assistant, Docker, iOS
Outcome
Works

Evidence at a glance

Loading source evidence…

What was done

my-petkit is a local replacement for PetKit cloud services, allowing litter boxes, feeders, and fountains to operate offline. It provides a web dashboard, iOS app, and MQTT integration for Home Assistant, utilizing a reverse-engineered protocol core.

my-petkit functions as a local alternative to PetKit cloud servers, enabling devices like litter boxes, feeders, and fountains to operate without an internet connection. The project includes a reverse-engineered protocol core ported from petkit-local, which handles device communication and user-plane API requests. The system supports deployment via Home Assistant, local Docker containers, or remote VPS setups. Features include a React-based web dashboard, an iOS application, and MQTT publishing for Home Assistant integration. The project documentation outlines protocol invariants and security rules. Development commits indicate the implementation of a BLE provisioning protocol in TypeScript and the addition of various management tabs. The author reports that proxy mode now verifies PetKit API certificates using a publicly trusted chain. Users are warned that pointing devices at my-petkit or applying firmware patchers carries risks, including potential device bricking and loss of warranty. Claude Opus 5.5 is credited as a co-author on multiple commits, contributing to API fixes, web dashboard development, and test implementation. See my-petkit for full details.

Community

Ask a question, share what worked, or follow the next milestone.

Your library