whatisgithub

What is vantasma-toolkit?

larkin0302/vantasma-toolkit — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A personal-use toolkit of Python CLI tools and Claude Code skills for reading and organizing your own WeChat and Feishu data.

Mindmap

mindmap
  root((vantasma toolkit))
    What it does
      Reads own WeChat data
      Reads own Feishu data
      Claude Code skills
    Tech stack
      Python
      SQLCipher
      Claude Code
    Use cases
      Search chat history
      Daily group summary
      Feishu automation
    Audience
      Personal use only
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

List and search your own WeChat conversations from the command line

USE CASE 2

Generate a styled HTML daily summary of a WeChat group chat

USE CASE 3

Automate building Feishu multi dimensional tables

USE CASE 4

Convert Feishu meeting notes into a client proposal document

What is it built with?

PythonSQLCipherClaude Code

How does it compare?

larkin0302/vantasma-toolkitadya84/ha-world-cup-2026afk-surf/safeclipper
Stars161616
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires unlocking your local WeChat SQLCipher database during a setup step.

So what is it?

Vantasma-toolkit is a personal-use-only collection of Python tools and Claude Code skills for querying and working with data from WeChat and Feishu, two popular Chinese communication platforms. The project is explicitly labeled for personal learning purposes only and prohibits use on other people's accounts or for commercial data collection. The main component is vchat, a command-line tool with 63 subcommands that reads and decrypts WeChat's local database (the messages stored on your own device). After running a setup step that unlocks the encrypted local database, you can list recent conversations, pull chat history from a specific group, search across all messages by keyword, view group members and their avatars, or watch a chat in real time for new messages. Output can be formatted as JSON for use by AI agents. The local database uses SQLCipher encryption, which the tool handles during setup on macOS (with a Windows equivalent). Beyond vchat, the toolkit includes six Claude Code skills, reusable AI instruction sets that extend Claude Code's capabilities. These cover generating styled HTML daily summaries of WeChat group conversations, performing Chinese astrology analysis (combining four pillars, Zi Wei Dou Shu, and Liu Ren methods) and exporting the result as an HTML scroll and image, automating Feishu multi-dimensional table construction, converting Feishu meeting notes into client proposal documents, and calling DiDi ride-hailing through Feishu. Installing a skill means copying its folder into Claude Code's skills directory and restarting the tool.

Copy-paste prompts

Prompt 1
Walk me through setting up vchat to unlock and query my local WeChat database on macOS
Prompt 2
Use vchat to search all my WeChat messages for a specific keyword
Prompt 3
Install the Claude Code skill that builds an HTML daily summary of a WeChat group chat
Prompt 4
Use the Feishu skill to turn my meeting notes into a client proposal document

Frequently asked questions

What is vantasma-toolkit?

A personal-use toolkit of Python CLI tools and Claude Code skills for reading and organizing your own WeChat and Feishu data.

What language is vantasma-toolkit written in?

Mainly Python. The stack also includes Python, SQLCipher, Claude Code.

How hard is vantasma-toolkit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vantasma-toolkit for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.