# wechaty/wechaty

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/wechaty-wechaty).**

22,484 stars · 2,790 forks · TypeScript · apache-2.0

## Links

- GitHub: https://github.com/wechaty/wechaty
- Homepage: https://wechaty.js.org
- awesome-repositories: https://awesome-repositories.com/repository/wechaty-wechaty.md

## Topics

`bot` `chatbot` `conversational-ai` `framework` `qq` `robotics` `wechat` `wechaty` `whatsapp`

## Description

Wechaty is a cross-platform chatbot framework designed to build and manage automated messaging agents. It provides a unified programming interface that abstracts diverse instant messaging protocols, allowing developers to create bots that function consistently across multiple communication services. By utilizing a modular architecture, the framework enables the development of conversational agents capable of handling complex messaging workflows, contact management, and group room interactions.

The framework distinguishes itself through a puppet-based protocol abstraction and a language-agnostic remote procedure call system, which allows developers to build and control bots using various programming languages. It supports multi-instance session management, enabling the concurrent operation of independent bot accounts within a single process. Furthermore, the system features a pluggable middleware architecture and hot module reloading, which facilitate dynamic capability extension and runtime logic updates without requiring full process restarts.

Beyond its core messaging capabilities, the framework offers integration with external artificial intelligence services for natural language processing and voice interaction. It supports containerized deployment models to ensure consistent execution across different hosting infrastructures and provides tools for remote cloud management and automated behavior validation. The platform is designed to streamline the entire lifecycle of conversational automation, from initial development and testing to ongoing operational maintenance.

## Tags

### Networking & Communication

- [Messaging Bot Frameworks](https://awesome-repositories.com/f/networking-communication/messaging-bot-frameworks.md) — Provides a unified framework for building intelligent, cross-platform chatbots and messaging agents. ([source](https://wechaty.js.org/docs/showcases/))
- [Protocol Translators](https://awesome-repositories.com/f/networking-communication/cross-chain-messaging-protocols/protocol-translators.md) — Uses puppet-based protocol translators to abstract diverse messaging platforms into a unified interface.
- [Room Management](https://awesome-repositories.com/f/networking-communication/communication-protocols-architectures/communication-paradigms/group-membership-management/room-management.md) — Enables management of group conversations, participant roles, and room topics through automated room management tools. ([source](https://wechaty.github.io/wechaty/))
- [Remote Procedure Call Interfaces](https://awesome-repositories.com/f/networking-communication/remote-procedure-call-interfaces.md) — Exposes bot functionality through language-agnostic remote procedure call interfaces for cross-language control.
- [WhatsApp Messaging Integrations](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/whatsapp-messaging-integrations.md) — Provides native support for WhatsApp, enabling automated two-way communication and real-time notification delivery for business applications. ([source](https://wechaty.js.org/docs/puppet-providers/whatsapp))
- [Messaging Automation](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation.md) — Provides a toolkit for programmatically managing contacts, group rooms, and multimedia message exchanges across diverse communication services.
- [Protocol Abstraction Layers](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-protocols/protocol-abstraction-layers.md) — Standardizes diverse instant messaging protocols into a consistent interface to simplify multi-platform communication tool maintenance.
- [Protocol Abstraction Layers](https://awesome-repositories.com/f/networking-communication/protocol-abstraction-layers.md) — Uses pluggable drivers to support multiple messaging protocols, allowing bots to operate across different platforms without changing core logic. ([source](https://cdn.jsdelivr.net/gh/wechaty/wechaty@main/README.md))
- [Messaging Interfaces](https://awesome-repositories.com/f/networking-communication/messaging-interfaces.md) — Abstracts diverse messaging protocols into a single interface for sending and receiving text, media, and file attachments across platforms. ([source](https://wechaty.js.org/docs/wechaty))
- [Messaging Systems](https://awesome-repositories.com/f/networking-communication/messaging-systems.md) — Supports parsing, forwarding, and responding to incoming messages, including advanced features like mentions and media extraction. ([source](https://wechaty.github.io/wechaty/))
- [Contact Management](https://awesome-repositories.com/f/networking-communication/contact-management.md) — Enables programmatic interaction with user contact lists, including searching, profile retrieval, and relationship management. ([source](https://wechaty.js.org/docs/polyglot/scala/))
- [Group Messaging Systems](https://awesome-repositories.com/f/networking-communication/group-messaging-systems.md) — Facilitates the transmission of rich media, including images, audio, video, and contact cards, to individual or group chats. ([source](https://wechaty.github.io/wechaty/))

### Artificial Intelligence & ML

- [Chatbot Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/chatbot-frameworks.md) — Provides a unified programming interface for building and deploying conversational agents across multiple instant messaging platforms.
- [Conversational AI Assistants](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-ai-assistants.md) — Integrates external natural language processing engines to enable intelligent, context-aware conversational interactions within messaging agents.
- [Conversational AI Platforms](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-ai-platforms.md) — Offers a modular architecture for connecting messaging bots to natural language processing engines and external business logic services.
- [Speech-to-Text Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/speech-to-text-integrations.md) — Connects messaging agents to external speech-to-text models for intelligent voice processing and transcription. ([source](https://wechaty.js.org/docs/tutorials/))

### Business & Productivity Software

- [Business Workflow Automation](https://awesome-repositories.com/f/business-productivity-software/business-workflow-automation.md) — Orchestrates automated conversational workflows to handle business processes without manual intervention.
- [Contact Management Systems](https://awesome-repositories.com/f/business-productivity-software/contact-management-systems.md) — Provides tools for managing contact relationships, including searching, friend requests, and profile retrieval. ([source](https://wechaty.js.org/docs/wechaty))
- [Workflow Automation](https://awesome-repositories.com/f/business-productivity-software/workflow-automation.md) — Orchestrates complex conversational workflows for sales, lead acquisition, and customer support. ([source](https://wechaty.js.org/docs/tutorials/))
- [Multi-Instance Managers](https://awesome-repositories.com/f/business-productivity-software/multi-instance-managers.md) — Facilitates concurrent operation of multiple bot instances to handle different accounts simultaneously. ([source](https://wechaty.js.org/docs/tutorials/))
- [Business Process Automation Tools](https://awesome-repositories.com/f/business-productivity-software/task-workflow-automation/business-process-automation-tools.md) — Automates repetitive business processes and user interactions across multiple messaging platforms. ([source](https://wechaty.js.org/docs/main-concepts-in-wechaty))

### Web Development

- [Event-Driven Messaging Systems](https://awesome-repositories.com/f/web-development/event-driven-messaging-systems.md) — Implements an event-driven architecture to trigger bot logic in response to real-time messaging events.

### Software Engineering & Architecture

- [Plugin Architectures](https://awesome-repositories.com/f/software-engineering-architecture/plugin-architectures.md) — Supports a modular plugin architecture to extend conversational agent capabilities without modifying core code. ([source](https://cdn.jsdelivr.net/gh/wechaty/wechaty@main/README.md))
- [Middleware Systems](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/reactive-messaging/pipeline-processing-architectures/middleware-systems.md) — Provides a pluggable middleware system to dynamically extend bot capabilities within the message processing pipeline.
- [Event Driven Messaging](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-messaging.md) — Provides a callback system for real-time messaging events, including incoming messages, friend requests, and room status updates. ([source](https://cdn.jsdelivr.net/gh/wechaty/wechaty@main/README.md))

### DevOps & Infrastructure

- [Cross-Platform Deployment Strategies](https://awesome-repositories.com/f/devops-infrastructure/cross-platform-deployment-strategies.md) — Enables cross-platform bot deployment using modular adapters to maintain consistent interfaces across services. ([source](https://wechaty.js.org/docs/howto/))
- [Application Module Configuration](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/application-settings-management/application-module-configuration.md) — Allows switching between platform-specific automation modules via configuration tokens without code changes. ([source](https://wechaty.github.io/wechaty/))
- [Containerized Deployments](https://awesome-repositories.com/f/devops-infrastructure/containerized-deployments.md) — Provides pre-configured container images to ensure consistent deployment of automation logic. ([source](https://wechaty.js.org/docs/tutorials/docker))
- [Container-Native Infrastructure](https://awesome-repositories.com/f/devops-infrastructure/container-native-infrastructure.md) — Provides standardized container-native environments for consistent bot execution and scaling.

### Security & Cryptography

- [Multi-Account Session Management](https://awesome-repositories.com/f/security-cryptography/multi-account-session-management.md) — Supports multi-instance session management to run independent bot accounts concurrently within a single process.

### Programming Languages & Runtimes

- [Language Bindings](https://awesome-repositories.com/f/programming-languages-runtimes/language-interoperability/language-bindings.md) — Exposes core functionality through language-specific bindings to support development in JavaScript, Python, Go, and Java.

### System Administration & Monitoring

- [Cloud-Connected Management Planes](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/remote-access-interface-tools/administrative-interfaces/management-interfaces/cloud-connected-management-planes.md) — Enables remote oversight and configuration of local bot instances via a centralized cloud management plane. ([source](https://wechaty.js.org/docs/tutorials/docker))

### Development Tools & Productivity

- [Hot Reloading](https://awesome-repositories.com/f/development-tools-productivity/hot-reloading.md) — Supports hot module reloading to update bot logic dynamically at runtime without process restarts. ([source](https://wechaty.js.org/docs/tutorials/))
