Summary

This project provides an automated customer service and management system for the Xianyu marketplace. It targets users managing multiple accounts, offering AI-powered auto-replies, automated delivery confirmations, and a web-based backend for streamlined operations and monitoring. The system aims to enhance efficiency and automate routine tasks for Xianyu sellers.

How It Works

The system employs a FastAPI backend, SQLite database, and Playwright for automation. It features a multi-user architecture with data isolation. Core components include a web UI for management, a CookieManager for account tasks, XianyuLive for message handling, and an AIReplyEngine supporting various AI models (OpenAI-compatible, Gemini, Anthropic, Azure OpenAI, etc.). Playwright/DrissionPage handles browser automation for interactions.

Quick Start & Requirements

• Primary Install: Docker Compose (docker compose up -d).
• Local Install: Clone repo, set up Python virtual environment, install dependencies (pip install -r requirements.txt), install Playwright browsers (playwright install chromium), and run python Start.py.
• Prerequisites: Python 3.11+, Playwright.
• Default Access: Web UI: http://localhost:9000 (Docker) or http://localhost:8090 (Local). API Docs: http://localhost:9000/docs.
• Docs: Links to Deployment, Configuration, Usage, and FAQ guides are available within the README.

Highlighted Details

• Supports multi-user registration, login, and permission control with data isolation.
• Manages multiple Xianyu accounts, including independent status monitoring and cookie maintenance.
• Intelligent reply engine with keyword, default, image-based, and AI-driven responses.
• Automated delivery confirmation with support for various data types and de-duplication.
• Product management features, including automatic data collection and de-duplication.
• Containerized deployment via Docker Compose and multi-architecture builds.

Maintenance & Community

The project lists several individual contributors. No specific community channels (like Discord/Slack) or official roadmap links are provided in the README. Contribution guidelines are outlined, encouraging Issues and Pull Requests.

Licensing & Compatibility

• License: GNU Affero General Public License v3.0 (AGPL-3.0).
• Restrictions: Explicitly designated for "learning and research use only." AGPL-3.0 requires source code availability for network-provided services.

Limitations & Caveats

The project is strictly intended for learning and research, with explicit prohibitions against illegal or non-compliant usage. The AGPL-3.0 license imposes significant obligations regarding source code disclosure for network-accessible services, potentially impacting commercial adoption or integration into proprietary systems.