gitwtfhub

wtf is xianyupilo?

dameng2026/xianyupilo — explained in plain English

Analysis updated 2026-05-18

36PythonAudience · developerComplexity · 4/5Setup · moderate

TL;DR

An automated back office for Xianyu marketplace sellers that handles listings, orders, chat, automatic digital delivery, and AI replies in one dashboard.

Mindmap

mindmap
  root((XianYuPilo))
    What it does
      Account and listing management
      Order syncing
      Automatic digital delivery
      AI powered chat replies
    Tech stack
      FastAPI backend
      Vue 3 frontend
      Playwright crawler
      MySQL and Redis
    Use cases
      Multi listing management
      Real time buyer chat
      Instant digital delivery
      Scheduled operations
    Audience
      Xianyu marketplace sellers
      Small e-commerce operators
      Python 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

Why would anyone build with this?

REASON 1

Manage multiple Xianyu seller accounts, listings, and orders from one dashboard.

REASON 2

Automatically deliver digital goods like redemption codes the moment an order comes in.

REASON 3

Chat with buyers in real time and let an AI reply using a searchable knowledge base.

REASON 4

Run scheduled tasks and review an audit log of every action taken on the account.

What's in the stack?

PythonFastAPIVue.jsNode.jsPlaywrightMySQLRedisDocker

How it stacks up

dameng2026/xianyupiloakmessi/vexdinosn/wp2shell-lab
Stars363636
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity4/53/54/5
Audiencedevelopervibe coderresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs Docker and Docker Compose v2, and at least 2GB of memory, the setup script generates all secrets automatically.

Wtf does this do

XianYuPilo, also called the Xianyu Assistant, is an automated back office management system for sellers on Xianyu, a popular Chinese secondhand goods marketplace app. It bundles together account management, listing products and taking them down, batch editing, order syncing and tracking, real time chat with buyers over WebSocket, automatic delivery of digital goods such as redemption codes, AI powered replies backed by a searchable knowledge base, scheduled tasks, and an activity log for auditing changes. The system is built with a Python FastAPI backend, a Vue 3 frontend, a Node.js service using Playwright to solve login puzzles, MySQL for the database, and Redis for caching, all wired together with Docker Compose so the whole stack starts with a single script. Running the one click setup script generates random secret keys, a hashed admin password, and the environment configuration file automatically, then pulls prebuilt container images and starts seven services: MySQL, Redis, a migration step, the crawler, the API, a background worker, and the web frontend.\n\nOnce running, you open a web address in your browser and log in with a default admin account, which the setup prints to the terminal and which you are told to change right away. The README documents common problems and fixes, such as changing the port if it is already in use, recovering a forgotten admin password, and updating to the newest version. It also gives guidance for exposing the service to the public internet safely, including binding it to localhost behind a TLS reverse proxy rather than leaving it open on all network interfaces.\n\nThis is described as the open source, single user edition of the project. A separate paid commercial edition exists with additional features like multi account management, business opportunity discovery, workflow automation, and dedicated support, running independently alongside the open source version without conflict.

Yoink these prompts

Prompt 1
Help me run start.sh to deploy XianYuPilo with Docker Compose on my Linux server.
Prompt 2
Explain how the automatic delivery feature works for digital redemption codes in this project.
Prompt 3
Show me how to expose this Xianyu assistant safely behind a TLS reverse proxy.
Prompt 4
Walk me through changing the default admin password after first login.

Frequently asked questions

wtf is xianyupilo?

An automated back office for Xianyu marketplace sellers that handles listings, orders, chat, automatic digital delivery, and AI replies in one dashboard.

What language is xianyupilo written in?

Mainly Python. The stack also includes Python, FastAPI, Vue.js.

How hard is xianyupilo to set up?

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

Who is xianyupilo for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.