xhs_ai_publisher

Overview of xhs_ai_publisher

What it is

xhs_ai_publisher is an AI-powered content creation and publishing tool designed for the Xiaohongshu (Rednote) platform. It provides a PyQt desktop UI, a FastAPI web service, login-state reuse, preview publishing, and automated browser workflows. The project is open source under the Apache-2.0 license.

Key features

• AI-generated titles, articles, and image matching based on user-provided topics or hot trends.
• Supports multiple AI backends: OpenAI-compatible APIs, Claude, Ollama, or a built-in fallback.
• Built-in hot-trend data from Weibo, Baidu, Toutiao, Bilibili, and others; one-click import to generate content.
• Cover and content image templates (including marketing posters, promotional banners, product showcases) with preview and download.
• Automated publishing with scheduled tasks (unattended), login-state persistence, and multi-account management.
• Web link import: paste a URL (e.g., WeChat public article) to extract title, body, and images.
• Local data encryption for API keys, complete operation logs, and error recovery.

Use cases

• Content creators who want to automate Xiaohongshu post generation and scheduling.
• Marketers needing to produce branded covers and promotional images quickly.
• Users managing multiple Xiaohongshu accounts who need isolated login states and data.
• Teams that want to run a headless publishing service via Docker or FastAPI.

Getting started

System requirements: Python 3.8+, latest Chrome, 4GB+ RAM, 2GB+ disk.One-click install (recommended):bash# macOS/Linuxchmod +x install.sh 启动程序.sh./install.sh./启动程序.sh# Windowsinstall.bat启动程序.batDocker deployment (headless service mode):bashdocker compose builddocker compose up -dManual install (advanced):bashpython -m venv venvsource venv/bin/activatepip install -r requirements.txtPLAYWRIGHT_BROWSERS_PATH=... python -m playwright install chromium./启动程序.shFor detailed instructions, see the repository README.

License and pricing

This project is licensed under Apache-2.0. It is open source and free to use.

Based on the project's public README and repository metadata.