Skip to main content

WhatsApp channel plugin for Hiro-League (neonize / whatsmeow)

Project description

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).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hiro_channel_whatsapp-0.2.0.tar.gz (20.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hiro_channel_whatsapp-0.2.0-py3-none-any.whl (23.4 kB view details)

Uploaded Python 3

File details

Details for the file hiro_channel_whatsapp-0.2.0.tar.gz.

File metadata

  • Download URL: hiro_channel_whatsapp-0.2.0.tar.gz
  • Upload date:
  • Size: 20.6 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for hiro_channel_whatsapp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2686caec2f24337f23f7d0e53b2685ea9388674a56aeaa3cd14d47fd2e5b848a
MD5 ce14dedcf6c13bf08f06ef61ebf31e8e
BLAKE2b-256 08475916d18cdc2415f675966852569173691ebbd1909eef48bf1e8a8b434c65

See more details on using hashes here.

File details

Details for the file hiro_channel_whatsapp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: hiro_channel_whatsapp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 23.4 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for hiro_channel_whatsapp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6e88121bbc51c9776fed36124afbc7850f2c8f96afed318693d9c6f2c91bb327
MD5 fa0a7b1459329ee211557c42d85e0da9
BLAKE2b-256 3da7d9cc445fde283a29f3a0c259c351bb0ada1fa945c084ad51100455e0581f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page