# littlecodersh/ItChat

A complete and graceful API for Wechat. 微信个人号接口、微信机器人及命令行微信，三十行即可自定义个人号机器人。

Repository: https://github.com/littlecodersh/ItChat
Canonical: https://ross.abutalabs.com/products/itchat
Homepage: http://itchat.readthedocs.io
Language: Python
License: MIT
License Family: permissive
Topics: itchat, wechat, api, robot
Last push: 2023-09-28T07:46:58+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3879, "days_push": 1070, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 26469, forks 5608 (observed 2026-08-28T04:11:46.962565+00:00)

## What it is
ItChat is a Python library providing a complete API for WeChat personal accounts, enabling bots and automation with under thirty lines of code. It supports message handling, friend search, file transfer, and QR-code login via reverse-engineered web WeChat endpoints.

## Use cases
- build a wechat personal account bot in python
- auto-reply to wechat messages
- send messages to wechat file transfer assistant
- automate wechat group chat responses
- search and message wechat friends programmatically
- download wechat images and attachments with a bot

## When to choose
- you want a simple Python API to automate a WeChat personal account
- you need message registration handlers for text, media, and friend requests
- you want command-line QR login and hot-reload session persistence

## When to avoid
- you need official, supported WeChat API access or compliance guarantees
- you target WeChat official accounts rather than personal accounts
- you need a maintained solution - the reverse-engineered web WeChat interface may break as WeChat changes

## Facets
- artifact type: library
- maturity: maintenance
- function: sdk, chatbot, workflow-automation, http-client
- domain: messaging-platforms, chatbots, apis
- platform: python, cross-platform
- tags: wechat, personal-account-api, messaging-bot, reverse-engineered-api, automation

## Member repositories
- littlecodersh/ItChat (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:46.962565+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:55:52.116580+00:00, confidence not recorded.
  - readme: https://github.com/littlecodersh/ItChat (fetched 2026-08-28T04:11:46.962565+00:00, sha 2f77a2218b48)
  - homepage: http://itchat.readthedocs.io (fetched 2026-08-29T07:52:08.767887+00:00, sha 18a8512c6d79)
  - registry_pypi: https://pypi.org/pypi/itchat/json (fetched 2026-08-29T07:52:08.771365+00:00, sha 09174e536cef)
- Data as of 2026-08-30T08:39:29.467469+00:00.