Openlist-Ani

🎬 RSS 订阅 → 自动下载 → AI 重命名，一站式番剧自动化管理

从动漫番剧相关的 RSS 订阅源中自动获取番剧更新，通过 Openlist 离线下载至对应网盘，
并结合 LLM 分析资源名，将资源重命名为 Emby / Jellyfin 可解析的格式。

✨ 特点

📡 自动追番 — 自动获取 RSS 番剧更新并下载
📦 多网盘支持 — 基于OpenList实现，支持 PikPak、115 等离线下载
🤖 AI 重命名 — AI 分析资源名 + TMDB 搜索，精准获取番剧名、季度、集数
💬 智能助理 — 挂载至 Telegram Bot，通过自然语言让 AI 帮你搜索并下载资源
🔔 更新通知 — 通过 PushPlus、Telegram 等渠道推送更新

📋 准备工作

参照 Openlist 官方文档部署 Openlist，并搭建好离线下载
准备好 RSS 订阅链接（如 Mikan Project）
准备好 LLM API Key

🚀 快速开始

方式一：PIP 安装（推荐）

1. 安装

pip install openlist-ani

2. 创建配置文件

在运行目录下新建 config.toml，填入以下内容：

[rss]
urls = ["RSS订阅链接"]

[openlist]
url = "http://localhost:5244"       # Openlist 访问地址
token = ""                          # 令牌，见「设置 → 其他 → 令牌」
download_path = "/PikPak/Anime"     # 下载保存路径
offline_download_tool = "qBittorrent"  # 离线下载工具

[llm]
openai_api_key = ""                 # API Key
openai_base_url = "https://api.deepseek.com/v1"
openai_model = "deepseek-chat"

完整配置项请参考 config.toml.example 及配置说明

3. 启动

python -m openlist-ani

4.（可选）启动 AI 助理

在配置文件中补充助理配置后运行：

[assistant]
enabled = true
max_history_messages = 10

[assistant.telegram]
bot_token = ""        # 从 @BotFather 获取
allowed_users = []    # 允许的用户 ID 列表，留空则不限制

python -m openlist-ani-assistant

方式二：Docker 部署

1. 准备文件

在运行目录下创建：

config.toml — 配置文件（内容同上）
data/ — 数据目录

2. 启动容器

docker run -d \
  --network host \
  -e ENABLE_ASSISTANT=false \
  -v /path/to/config.toml:/config.toml \
  -v /path/to/data:/data \
  twosix26/openlist-ani:latest

将 /path/to/ 替换为你的实际路径。
如需启用 AI 助理，填写好配置后将 ENABLE_ASSISTANT 设为 true。

方式三：从源码编译

前置：安装 uv

Linux / macOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

更多安装方式参考 uv 官方文档

步骤

# 1. 克隆仓库
git clone https://github.com/TwooSix/Openlist-Ani.git && cd Openlist-Ani

# 2. 切换到最新版本（master 为开发分支，不保证稳定）
git checkout v***    # 替换为最新版本号

# 3. 安装依赖
uv sync --no-dev --frozen

# 4. 创建 config.toml 并填写配置（内容同上）

# 5. 启动
uv run openlist-ani

# 6.（可选）启动 AI 助理
uv run openlist-ani-assistant

📖 文档

🖼️ 效果展示

重命名结果	智能助理

Release files for openlist-ani 1.0.0.dev260314

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openlist-ani 1.0.0.dev260314
File	Size	Uploaded
openlist_ani-1.0.0.dev260314.tar.gz	92.1 kB	Mar 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openlist-ani 1.0.0.dev260314
File	Interpreter	ABI	Platform	Reset
openlist_ani-1.0.0.dev260314-py3-none-any.whl 123.7 kB Mar 13, 2026	Python 3	none	any	Details

Total release size: 215.8 kB

Release files / openlist_ani-1.0.0.dev260314.tar.gz

Download URL	openlist_ani-1.0.0.dev260314.tar.gz
Size	92.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`e7b0c76c8a2032e9ffbb49239fc93ddbe386351d5a2de5430f373cde12acd568`
BLAKE2b-256 checksum How to use checksums	`afc281f909d7c6ab3ecc44f12ad7b44c9e5827bacb0472cc40886dca33d51001`
Upload date	Mar 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / openlist_ani-1.0.0.dev260314-py3-none-any.whl

Download URL	openlist_ani-1.0.0.dev260314-py3-none-any.whl
Size	123.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0ba5ead793491f303fb2f0d2f303fe87bc672069ed0f8347c638ef1e94d34f68`
BLAKE2b-256 checksum How to use checksums	`25d45a747c836be9bd072067bb05153ed157c5cf960cb6c364fb6779bdaa84dc`
Upload date	Mar 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`