hannah-proto
Protobuf/gRPC schema definitions for the Hannah voice assistant ecosystem (Core, satellites, WebUI, ioBroker adapter, Telegram bot, and other consumers). This repo is the single source of truth for the wire protocol shared across all of them.
The .proto files live flat at the repo root, one per functional area — satellite control, event streaming, the ioBroker agent bridge, user registry, timers, automations, and so on. Nothing here is application code, just schema.
Distribution
Three independent, tag-triggered publish targets — pick whichever matches your language. Each contains only generated gRPC stubs/types for the current tagged release.
| Language | Package | Install |
|---|---|---|
| Python | PyPI hannah-proto |
pip install hannah-proto |
| TypeScript | npm @m1kad0/hannah-proto |
npm install @m1kad0/hannah-proto |
| Go | github.com/NurPech/hannah-proto-go | go get github.com/NurPech/hannah-proto-go |
Go has no separate package registry, so that tagged GitHub repo is the package — go get resolves it directly.
Versioning: PROTO_VERSION
Alongside the semver package/tag version, every release carries a single-integer PROTO_VERSION (see the PROTO_VERSION file). Hannah Core and its clients exchange this value on every call and reject a mismatch at runtime — that's the actual compatibility gate, not the semver tag. A breaking schema change requires bumping PROTO_VERSION; CI enforces this on every merge request via buf breaking.
Compatibility checks
CI runs buf lint and buf breaking (against origin/master) on every MR. To check a local branch against a specific released version:
buf breaking --against '.git#tag=vX.Y.Z'
Changelog
See CHANGELOG.md for what changed release to release, including breaking changes and the consumers they affect.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hannah_proto-2.0.1.tar.gz.
File metadata
- Download URL: hannah_proto-2.0.1.tar.gz
- Upload date:
- Size: 26.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
53ca5427019f7e728fe8ec81043250c51a3a42bc0f3e90d43f177484caf52cb1
|
|
| MD5 |
01c1a200d5b77f3ae55ba3dc45f88fc7
|
|
| BLAKE2b-256 |
cffcfb31f1977b6eb5b9cbd335f9d8d3fe7bea42eb64bf019428a0f60dfcd1ae
|
File details
Details for the file hannah_proto-2.0.1-py3-none-any.whl.
File metadata
- Download URL: hannah_proto-2.0.1-py3-none-any.whl
- Upload date:
- Size: 46.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bdf69a47833a9ab2aa2eae5f05589fa7f5c0271948e1cf9c4b01c5b620486e54
|
|
| MD5 |
a5ff460fb86491bc0c709c1376674351
|
|
| BLAKE2b-256 |
169bd1b32c22486b3b9c3e67a3365916e679d51ea28abae0f4cb1e1d24c3c237
|
