# youfou/wxpy **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/youfou-wxpy).** 14,270 stars · 2,374 forks · Python · MIT · archived ## Links - GitHub: https://github.com/youfou/wxpy - Homepage: http://wxpy.readthedocs.io - awesome-repositories: https://awesome-repositories.com/repository/youfou-wxpy.md ## Topics `api` `wechat` `weixin` ## Description wxpy is a Python library and bot framework that acts as an API wrapper for personal WeChat accounts. It provides a programming interface to automate account tasks, send messages, and manage contacts. The project functions as a chatbot integration engine, allowing users to connect external AI services and custom logic to automatically respond to private and group conversations. It includes a social media automation toolkit for programmatically handling friend requests and group memberships. The framework covers multimedia message broadcasting, user profile retrieval, and contact search. It also includes tools for monitoring rate limits and an interactive shell for real-time logic modification and debugging. ## Tags ### Networking & Communication - [WeChat Automation Tools](https://awesome-repositories.com/f/networking-communication/wechat-automation-tools.md) — Provides a Python interface for creating automated responses and task handlers for personal WeChat accounts. - [Account Automation Tools](https://awesome-repositories.com/f/networking-communication/account-automation-tools.md) — Provides programmatic control over personal account actions such as adding friends and managing group memberships. ([source](http://wxpy.readthedocs.io/)) - [Messaging Automation](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation.md) — Allows triggering custom logic to process and automatically reply to incoming messages based on filters. ([source](http://wxpy.readthedocs.io/)) - [Chat Protocol Bridges](https://awesome-repositories.com/f/networking-communication/cross-chain-messaging-protocols/protocol-translators/protocol-translation-bridges/chat-protocol-bridges.md) — Implements a translation layer that bridges WeChat's low-level protocol to high-level Python commands. - [Social Media Automation Clients](https://awesome-repositories.com/f/networking-communication/messaging-automation-clients/social-media-automation-clients.md) — Implements programmatic management of friend requests, group memberships, and multimedia messaging. - [Personal Social Account Automation](https://awesome-repositories.com/f/networking-communication/personal-social-account-automation.md) — Automates the process of adding friends, managing group memberships, and handling contact requests. - [Bot Frameworks](https://awesome-repositories.com/f/networking-communication/wechat-automation-tools/bot-frameworks.md) — Provides a structured developer toolkit for building bots with messaging and contact management capabilities. - [Broadcast Messaging](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/real-time-communication/broadcast-messaging.md) — Sends text and multimedia content across multiple group conversations or targeted contact lists. - [Roster Contact Request Managers](https://awesome-repositories.com/f/networking-communication/contact-management/contact-caches/roster-contact-request-managers.md) — Automatically handles the lifecycle of friend requests, including acceptance and welcome messaging. ([source](http://wxpy.readthedocs.io/)) - [User Profile Retrieval](https://awesome-repositories.com/f/networking-communication/contact-management/user-profile-retrieval.md) — Provides APIs to fetch detailed user attributes such as nicknames, gender, and geographic region. ([source](https://cdn.jsdelivr.net/gh/youfou/wxpy@master/README.md)) - [Group Chat Administration](https://awesome-repositories.com/f/networking-communication/group-chat-administration.md) — Enables programmatic creation of groups, inviting users, and removing members from conversations. ([source](https://cdn.jsdelivr.net/gh/youfou/wxpy@master/README.md)) ### Artificial Intelligence & ML - [Chatbot Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/chatbot-integrations.md) — Provides a framework for connecting third-party artificial intelligence models to WeChat for automated conversation responses. ([source](http://wxpy.readthedocs.io/zh/latest/utils.html)) ### Part of an Awesome List - [Messaging Multimedia Transmission](https://awesome-repositories.com/f/awesome-lists/media/media-and-files/messaging-multimedia-transmission.md) — Transmits various media types, including images, videos, and files, to individual contacts or groups. ([source](https://cdn.jsdelivr.net/gh/youfou/wxpy@master/README.md)) ### Business & Productivity Software - [Personal Account Chatbots](https://awesome-repositories.com/f/business-productivity-software/automated-chatbots/personal-account-chatbots.md) — Triggers custom functions to automatically reply to incoming messages based on sender or text content. ([source](https://cdn.jsdelivr.net/gh/youfou/wxpy@master/README.md)) ### Security & Cryptography - [Session State Management](https://awesome-repositories.com/f/security-cryptography/authentication-clients/client-to-server-authentication/session-state-management.md) — Maintains persistent connection states and authentication tokens to ensure continuous interaction with the WeChat account. ### Data & Databases - [Contact Search and Selection](https://awesome-repositories.com/f/data-databases/contact-management/contact-search-and-selection.md) — Provides capabilities to locate friends and groups using keywords and specific user attributes. ([source](http://wxpy.readthedocs.io/)) - [Profile Information Retrieval](https://awesome-repositories.com/f/data-databases/profile-information-retrieval.md) — Retrieves detailed user profile information and searches for contacts or groups based on specific attributes. - [Chat Message Broadcasting](https://awesome-repositories.com/f/data-databases/record-updating/live-update-subscriptions/event-stream-broadcasters/custom-event-broadcasting/chat-message-broadcasting.md) — Enables the synchronization and forwarding of text, media, and files across multiple group conversations. ([source](http://wxpy.readthedocs.io/zh/latest/utils.html)) ### Development Tools & Productivity - [Interactive Debug Consoles](https://awesome-repositories.com/f/development-tools-productivity/interactive-debug-consoles.md) — Provides an interactive console to explore objects and test functionality within the running program environment. ([source](http://wxpy.readthedocs.io/zh/latest/console.html)) ### Programming Languages & Runtimes - [Embedded Interactive Shells](https://awesome-repositories.com/f/programming-languages-runtimes/embedded-interactive-shells.md) — Embeds a live Python REPL into the running bot process for real-time state manipulation and logic modification. ### Software Engineering & Architecture - [Event Driven Messaging](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-messaging.md) — Processes incoming chat events through an asynchronous listener system that triggers specific callback functions. - [Rate Limiting](https://awesome-repositories.com/f/software-engineering-architecture/request-throttling/rate-limiting.md) — Monitors outgoing request frequency and pauses execution to prevent account bans by adhering to platform limits. ### Web Development - [Message Content Filtering](https://awesome-repositories.com/f/web-development/request-routing/message-content-filtering.md) — Matches incoming messages against defined patterns or keywords to determine the appropriate response handler.