What is wechat-chatgpt?

fuergaosi233/wechat-chatgpt — explained in plain English

Analysis updated 2026-06-24

★ 13,242TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((repo))
    What It Does
      ChatGPT in WeChat
      Message forwarding
      Custom AI persona
    Features
      Text chat
      Image generation
      Audio transcription
    Deployment
      Docker Compose
      Railway free tier
      Fly.io free tier
    Status
      Archived project
      No active maintenance

mindmap root((repo)) What It Does ChatGPT in WeChat Message forwarding Custom AI persona Features Text chat Image generation Audio transcription Deployment Docker Compose Railway free tier Fly.io free tier Status Archived project No active maintenance

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Study how to connect a messaging platform to a third-party AI API as a reference architecture.

USE CASE 2

Fork the archived code as a starting point for a similar WeChat or messaging-app bot project.

USE CASE 3

Use the Docker Compose setup as a template for deploying a Node.js bot with environment variable configuration.

What is it built with?

TypeScriptNode.jsDocker

How does it compare?

	fuergaosi233/wechat-chatgpt	schickling/chromeless	google-labs-code/design.md
Stars	13,242	13,230	13,224
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	moderate	moderate	easy
Complexity	3/5	3/5	2/5
Audience	developer	developer	vibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Archived, no longer maintained. Requires a paid OpenAI API key and scanning a WeChat QR code to log in.

ISC, a permissive license, use freely for any purpose, including commercial, with minimal restrictions.

So what is it?

wechat-chatgpt is a tool that connects OpenAI's ChatGPT to WeChat, the widely used Chinese messaging app, so that you can chat with the AI through your WeChat account. The first thing the README makes clear is that the project has been archived, meaning its author has stopped actively working on it and is no longer adding features or fixes. Anyone considering it should keep that in mind. The way it works is that the program logs into WeChat on your behalf using a library called wechaty, then forwards messages to ChatGPT through OpenAI's official interface and sends the replies back. To run it you need your own OpenAI API key, which is a paid credential from OpenAI, and you choose which model to use. Beyond plain text chat, the README says it can also work with DALL-E for image generation and Whisper for audio, let you set a custom prompt that shapes the AI's personality, and respond to a few typed commands such as showing help, setting a prompt, or clearing past conversation. Most of the README is a set of deployment guides aimed at people who are comfortable with some setup. It offers several options: free hosting platforms Railway and Fly.io, self-hosting with Docker or Docker Compose, and running it directly with Node.js. In each case you log into WeChat by scanning a QR code that appears in the program's logs. There is also a reference table of configuration settings you can adjust through environment variables, such as the model, the response randomness, keywords that trigger replies in private or group chats, and lists of blocked words. The README additionally points to a companion project for routing requests through a custom API endpoint. The code is released under the ISC license, a permissive open-source license.

Copy-paste prompts

Prompt 1

I'm studying the wechat-chatgpt codebase. Explain how wechaty intercepts WeChat messages and forwards them to the OpenAI API.

Prompt 2

Using wechat-chatgpt as a reference, help me build a similar bot that connects a Telegram group to the OpenAI API.

Prompt 3

I want to fork wechat-chatgpt and update it to use the latest OpenAI models. Show me which files and config values to change.

Prompt 4

Help me set up wechat-chatgpt locally using Docker Compose, what environment variables do I need and how do I scan the WeChat QR code?

Frequently asked questions