An AI companion that lives in your WeChat, via UI automation

What it does

Whale Girl is a local-first AI companion for WeChat on Windows. It replies to @-mentions and its name in group chats, remembers facts from private chats, and compresses older group history. Beyond text, it can send stickers, voice messages, read Moments, do web searches, and write one Markdown diary entry per day. Everything is controlled from a single WPF launcher — there is no browser UI; the local HTTP API on 127.0.0.1:8787 is just plumbing.

The interesting bit

The bridge talks to WeChat through UI automation (UIA) and reads the local WeChat database — no code injection, no patching, and reportedly without stealing window focus. It’s glue code in the most ambitious sense: a Node.js kernel with zero npm runtime dependencies, a Python bridge wrapping wechatauto-replica, and a .NET launcher, all bundled into one installer.

Key highlights

• Works with DeepSeek, Zhipu GLM, Qwen, SiliconFlow, Doubao, or any OpenAI-compatible endpoint — including local Ollama
• Human-like delivery: replies split into short bubbles, trailing punctuation stripped, parroted replies rewritten
• Memory system records owner facts and compresses old group conversations under a token budget
• Built-in diagnostics: logs, account checks, UIA self-test, and SHA256-verified self-updates
• Installer bundles Node.js, Python 3.12, and the .NET 10 runtime — nothing else to install

Caveats

• Windows 10/11 only, requires administrator rights, and a logged-in WeChat 4.x account (a secondary account is recommended)
• UI automation may violate WeChat’s terms of service — the README says so itself
• The local API has no login layer; exposing it would be a bad day. Builds are also unsigned, so verify checksums
• Must be installed in an ASCII-only path; Chinese characters in the path break WeChat automation

Verdict

Worth a look if you want a self-hosted AI group member with real memory and personality, and you live on Windows with WeChat. Everyone else — especially non-Windows or API-averse users — should skip it.