Skip to main content

hiro-channel-whatsapp

WhatsApp channel plugin for Hiro-League, built on neonize (Python bindings over the Go whatsmeow multi-device library).

See the design and plan:

  • docs/whatsapp-channel-design.md
  • docs/whatsapp-channel-implementation.md

Status

Phase 1 — Link & receive (raw). Links a WhatsApp account via QR, persists the session, and logs inbound messages. Routing into the agent and sending replies land in later phases.

Dev install

hiro channel install whatsapp --editable       # or: hiro channel setup with a workspace dir
hiro channel setup whatsapp                     # writes the channel_plugins row
hiro stop && hiro start                          # ChannelManager spawns the plugin

On first run, an ASCII QR is written to the plugin log (<log-dir>/channel-whatsapp*.log) — scan it from WhatsApp → Linked Devices. The session persists to ~/.hiro/whatsapp/session.db (until Phase 3 pushes a workspace-scoped path), so later restarts reconnect without a new QR.

Uses an unofficial WhatsApp Web library — see the design doc for the accepted ToS/ban-risk trade-off. No backward-compatibility guarantees (initial development).

Metadata

Release files for hiro-channel-whatsapp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hiro-channel-whatsapp 0.2.0
File Size Uploaded
hiro_channel_whatsapp-0.2.0.tar.gz 20.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hiro-channel-whatsapp 0.2.0
File Interpreter ABI Platform
hiro_channel_whatsapp-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 44.0 kB

Release files / hiro_channel_whatsapp-0.2.0.tar.gz

Download URL hiro_channel_whatsapp-0.2.0.tar.gz
Size 20.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2686caec2f24337f23f7d0e53b2685ea9388674a56aeaa3cd14d47fd2e5b848a
BLAKE2b-256 checksum
How to use checksums
08475916d18cdc2415f675966852569173691ebbd1909eef48bf1e8a8b434c65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / hiro_channel_whatsapp-0.2.0-py3-none-any.whl

Download URL hiro_channel_whatsapp-0.2.0-py3-none-any.whl
Size 23.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6e88121bbc51c9776fed36124afbc7850f2c8f96afed318693d9c6f2c91bb327
BLAKE2b-256 checksum
How to use checksums
3da7d9cc445fde283a29f3a0c259c351bb0ada1fa945c084ad51100455e0581f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page