# @juzi/wechaty-puppet-service > Puppet Service for Wechaty Latest version **1.0.129** (published 2026-09-02) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @juzi/wechaty-puppet-service pnpm add @juzi/wechaty-puppet-service yarn add @juzi/wechaty-puppet-service bun add @juzi/wechaty-puppet-service ``` ## Health **Score 75/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 1.0.129 | | Published | 2026-09-02 | | First published | 2022-06-16 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM | | Node | >=16 | | Dependencies | 13 | | Unpacked size | 1.9 MB | | Known vulnerabilities | 0 (+1 in 1 direct dependencies) | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 2 | | Author | Huan LI | | Maintainers | juzi-admin, binsee | | Keywords | chatie, wechaty, chatbot, bot, grpc, wechat, sdk | ## Links - npm: https://www.npmjs.com/package/@juzi/wechaty-puppet-service - Repository: https://github.com/juzibot/wechaty-puppet-service - Homepage: https://github.com/juzibot/wechaty-puppet-service#readme - Issues: https://github.com/juzibot/wechaty-puppet-service/issues - npm.io page: https://npm.io/package/@juzi/wechaty-puppet-service ## Dependencies (13) - [rxjs](https://npm.io/package/rxjs.md) ^7.5.5 - [uuid](https://npm.io/package/uuid.md) ^8.3.2 - [ducks](https://npm.io/package/ducks.md) ^1.0.2 - [gerror](https://npm.io/package/gerror.md) ^1.0.16 - [semver](https://npm.io/package/semver.md) ^7.3.5 - [file-box](https://npm.io/package/file-box.md) ^1.5.5 - [clone-class](https://npm.io/package/clone-class.md) ^1.1.1 - [flash-store](https://npm.io/package/flash-store.md) ^1.3.4 - [state-switch](https://npm.io/package/state-switch.md) ^1.7.1 - [wechaty-token](https://npm.io/package/wechaty-token.md) ^1.0.6 - [redux-observable](https://npm.io/package/redux-observable.md) ^2.0.0 - [@juzi/wechaty-grpc](https://npm.io/package/@juzi/wechaty-grpc.md) ^1.0.108 - [stronger-typed-streams](https://npm.io/package/stronger-typed-streams.md) ^0.2.0 ## Recent versions - 1.0.129 (latest) — 2026-09-02 - 1.0.128 — 2026-08-26 - 1.0.127 — 2026-08-24 - 1.0.126 — 2026-07-10 - 1.0.125 — 2026-07-09 - 1.0.124 — 2026-07-01 - 1.0.123 — 2026-07-01 - 1.0.122 — 2026-06-30 - 1.0.121 — 2026-06-30 - 1.0.120 — 2026-06-29 - 1.0.119 — 2026-06-26 - 1.0.118 — 2026-06-25 - 1.0.117 — 2026-06-22 - 1.0.116 — 2026-06-22 - 1.0.115 — 2026-06-13 - … 115 more at https://npm.io/package/@juzi/wechaty-puppet-service/versions ## README # wechaty-puppet-service [![NPM Version](https://badge.fury.io/js/wechaty-puppet-service.svg)](https://www.npmjs.com/package/wechaty-puppet-service) [![NPM](https://github.com/wechaty/wechaty-puppet-service/workflows/NPM/badge.svg)](https://github.com/wechaty/wechaty-puppet-service/actions?query=workflow%3ANPM) [![ES Modules](https://img.shields.io/badge/ES-Modules-brightgreen)](https://github.com/Chatie/tsconfig/issues/16) ![Wechaty Service](https://wechaty.github.io/wechaty-puppet-service/images/hostie.png) Wechaty Puppet Service is gRPC for Wechaty Puppet Provider. For example, we can cloudify the Wechaty Puppet Provider wechaty-puppet-padlocal to a Wechaty Puppet Service by running our Wechaty Puppet Service Token Gateway. If you want to learn more about what is Wechaty Puppet and Wechaty Puppet Service, we have a blog post to explain them in details at [![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-brightgreen.svg)](https://github.com/Wechaty/wechaty) ## Features 1. Consume Wechaty Puppet Service 1. Provide Wechaty Puppet Service ## Usage ```ts import { WechatyBuilder } from 'wechaty' const wechaty = WechatyBuilder.build({ puppet: 'wechaty-puppet-service', puppetOptions: { token: `${TOKEN}` } }) wechaty.start() ``` Learn more about Wechaty Puppet Token from our official website: ## Environment Variables ### 1 `WECHATY_PUPPET_SERVICE_TOKEN` The token set to this environment variable will become the default value of `puppetOptions.token` ```sh WECHATY_PUPPET_SERVICE_TOKEN=${WECHATY_PUPPET_SERVCIE_TOKEN} node bot.js ``` ## gRPC Health Checking Protocol From version 0.37, Wechaty Puppet Service start supporting the [GRPC Health Checking Protocol](https://github.com/grpc/grpc/blob/master/doc/health-checking.md). ```sh $ npm install --global wechaty-token $ go install github.com/grpc-ecosystem/grpc-health-probe@latest $ wechaty-token discovery uuid_12345678-1234-1234-1234-567812345678 {"host": 1.2.3.4, "port": 5678} $ grpc-health-probe -tls -tls-no-verify -addr 1.2.3.4 status: SERVING ``` See: - [Add health checking API wechaty/grpc#151](https://github.com/wechaty/grpc/issues/151) ## Resources ### Authentication 1. [Authentication and Security in gRPC Microservices - Jan Tattermusch, Google](https://youtu.be/_y-lzjdVEf0) 1. [[gRPC #15] Implement gRPC interceptor + JWT authentication in Go](https://youtu.be/kVpB-uH6X-s) ## History ### master v0.31 1. ES Modules supported. 1. gRPC Health Checking Protocol support ### v0.30 (Aug 25, 2021) 1. Implemented TLS and server-side token authorization. 1. Refactor the gRPC client code. 1. Add local payload cache to reduce the cost of RPC. #### New environment variables 1. `WECHATY_PUPPET_SERVICE_TLS_CA_CERT`: can be overwrite by `options.tlsRootCert`. Set Root CA Cert to verify the server or client. For Puppet Server: | Environment Variable | Options | Description | | -------------------- | ------- | ----------- | | `WECHATY_PUPPET_SERVICE_TLS_SERVER_CERT` | `options.tls.serverCert` | Server CA Cert (string data) | | `WECHATY_PUPPET_SERVICE_TLS_SERVER_KEY` | `options.tls.serverKey` | Server CA Key (string data) | | `WECHATY_PUPPET_SERVICE_NO_TLS_INSECURE_SERVER` | `options.tls.disable` | Set `true` to disable server TLS | For Puppet Client: | Environment Variable | Options | Description | | -------------------- | ------- | ----------- | | `WECHATY_PUPPET_SERVICE_AUTHORITY` | `options.authority` | Service discovery host, default: `api.chatie.io` | | `WECHATY_PUPPET_SERVICE_TLS_CA_CERT` | `options.caCert` | Certification Authority Root Cert, default is using Wechaty Community root cert | | `WECHATY_PUPPET_SERVICE_TLS_SERVER_NAME` | `options.serverName` | Server Name (mast match for SNI) | | `WECHATY_PUPPET_SERVICE_NO_TLS_INSECURE_CLIENT` | `options.tls.disable` | Set `true` to disable client TLS | ## Changelog ### main v1.0 (Oct 29, 2021) Release v1.0 of Wechaty Puppet Service. 1. use [wechaty-token](https://github.com/wechaty/token) for gRPC service discovery with `wechaty` schema (xDS like) 1. deprecated `WECHATY_SERVICE_DISCOVERY_ENDPOINT`, replaced by `WECHATY_PUPPET_SERVICE_AUTHORITY`. (See [#156](https://github.com/wechaty/wechaty-puppet-service/issues/156)) 1. enable TLS & Token Auth (See [#124](https://github.com/wechaty/wechaty-puppet-service/issues/124)) ### v0.14 (Jan 2021) Rename from ~~wechaty-puppet-hostie~~ to [wechaty-puppet-service](https://www.npmjs.com/package/wechaty-puppet-service) (Issue [#118](https://github.com/wechaty/wechaty-puppet-service/issues/118)) ### v0.10.4 (Oct 2020) 1. Add 'grpc.default_authority' to gRPC client option. > See: [Issue #78: gRPC server can use the authority to identify current user](https://github.com/wechaty/wechaty-puppet-hostie/pull/78) ### v0.6 (Apr 2020) Beta Version 1. Reconnect to Hostie Server with RxSJ Observables ### v0.3 (Feb 2020) 1. Publish the NPM module [wechaty-puppet-hostie](https://www.npmjs.com/package/wechaty-puppet-hostie) 1. Implemented basic hostie features with gRPC module: [@chatie/grpc](https://github.com/Chatie/grpc) ### v0.0.1 (Jun 2018) Designing the puppet hostie with the following protocols: 1. [gRPC](https://grpc.io/) 1. [JSON RPC](https://www.jsonrpc.org/) 1. [OpenAPI/Swagger](https://swagger.io/docs/specification/about/) ## Maintainers - [@huan](https://github.com/huan) Huan - [@windmemory](https://github.com/windmemory) Yuan ## Copyright & License - Code & Docs © 2018-now Huan LI \ - Code released under the Apache-2.0 License - Docs released under Creative Commons --- _Source: https://npm.io/package/@juzi/wechaty-puppet-service · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._