xianyu-auto-reply  by zhinianboke

Automated Xianyu customer service system

Created 1 month ago
2,002 stars

Top 22.2% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides an automated customer service system for the Xianyu platform, designed for users managing multiple Xianyu accounts. It offers intelligent auto-replies, automated order fulfillment, and comprehensive account management features, aiming to streamline operations for sellers.

How It Works

The system utilizes a WebSocket connection to interact with the Xianyu platform in real-time, processing messages and executing automated actions. It employs a FastAPI backend for its web interface and API, with SQLite for data storage, ensuring data isolation for multi-user support. Key features include keyword-based and AI-powered replies, automated order confirmation, and dynamic shipping rules, all managed through a user-friendly web interface.

Quick Start & Requirements

  • Docker Deployment (Recommended):
    # Create data directory
    mkdir -p xianyu-auto-reply
    # Start container
    docker run -d \
      -p 8080:8080 \
      -v $PWD/xianyu-auto-reply/:/app/data/ \
      --name xianyu-auto-reply \
      registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0
    
    Access at http://localhost:8080.
  • Source Code Deployment: Requires Python 3.11+, Node.js 16+, and Docker. Playwright browsers need to be installed (playwright install chromium).
  • Default Admin: Username: admin, Password: admin123.

Highlighted Details

  • Supports multi-user, multi-account management with strict data isolation.
  • Features AI-powered replies integrating OpenAI and other models.
  • Includes automated order confirmation and shipping with multi-specification support.
  • Offers real-time Xianyu item search using Playwright.

Maintenance & Community

The project is actively maintained by zhinianboke. Community support is available via QQ and WeChat groups.

Licensing & Compatibility

The project is licensed under a restrictive, non-commercial license. It explicitly prohibits commercial use, sales, or any form of profit-making. Use is permitted for personal learning and research, with requirements to retain author information and copyright notices.

Limitations & Caveats

The project is strictly for learning and research purposes and prohibits commercial use. The README contains promotional text for Cursor Pro, which is unrelated to the project's functionality.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
19
Star History
758 stars in the last 30 days

Explore Similar Projects

Starred by John Resig John Resig(Author of jQuery; Chief Software Architect at Khan Academy), Hahnbee Lee Hahnbee Lee(Cofounder of Mintlify), and
1 more.

dittofeed by dittofeed

0.3%
2k
Open-source platform for customer engagement automation
Created 3 years ago
Updated 23 hours ago
Feedback? Help us improve.