$ docker run -d -it --restart=always -v $PWD/pro.env:/data/code/pro.env -v $PWD/liuli_config:/data/code/liuli_config --name liuli_schedule liuliio/schedule:v0.2.4

Updatedlast year

LanguagePython

Setup difficultyModerate

Stars: 883
Port: 8765 (Flask HTTP API of the liuli_api service (feeds also served under /rss/...))
Requires: MongoDB

Docker

liuliio/schedule

What is liuli?

Liuli is a self-hosted reading pipeline that watches the sources you subscribe to (WeChat official accounts, novel sites, blogs), pulls new articles with a browser-based collector, runs them through a configurable processing stage, and delivers the result to your own channels. Dispatch targets documented are DingTalk, WeCom, Telegram, Bark and per-source RSS feeds, while finished articles can be archived back into MongoDB or pushed to a dedicated GitHub repository published with GitHub Pages. Behaviour comes from an env file plus JSON task definitions in liuli_config (collector, processor, sender, backup and schedule blocks), so scheduling times and destinations are edited rather than coded. Running it means starting the liuliio/api and liuliio/schedule containers with docker-compose alongside a MongoDB instance; the Flask API listens on port 8765. A code install with Python 3.7+ and pipenv is also documented for Windows, macOS and Linux. All documentation is Chinese-only, and the project stayed pre-1.0 (last tagged release v0.2.0), with machine-learning based ad filtering and reader-facing source management still on the roadmap.

Should you self-host liuli?

liuli scores 45/100 on selfhost.directory (how scoring works) and ranks #5 of 6 in Feed Aggregator. It has 883 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Nextcloud News (61/100, 1 012 stars). It scores higher overall, so compare the two before you pick. See liuli vs Nextcloud News side by side.

Features

Config-driven collection pipeline
Content backup
Custom processing hooksMachine-learning ad classification is listed as unfinished.
HTTP API service
Machine-learning ad classificationUnchecked item in the README feature list.
Multi-source content collection
Novel subscription tracking
Push notifications to chat apps
RSS feed output
Scheduled runs