前置：安装 uv

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

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

# 推荐切换到最新 Release tag；master 为开发分支，不保证稳定
# Release 版本以 tag 为准
git fetch --tags
git checkout tags/v***    # 将 v*** 替换为 Release 页面中的版本号

uv sync --no-dev --frozen

2. 创建配置文件

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

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

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

[metadata_parser]
provider = "llm"                    # 推荐 llm + tmdb；未配置 LLM 时默认 regex + tmdb

[metadata_validator]
provider = "tmdb"

[llm]
openai_api_key = ""                 # LLM API Key；启用 AI 助理时也必填
openai_base_url = "https://api.deepseek.com/v1"
openai_model = "deepseek-chat"

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

3. 启动

uv run openlist-ani

4.（可选）启动 AI 助理

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

[assistant]
enabled = true

[assistant.telegram]
enabled = true
bot_token = ""        # 从 @BotFather 获取
allowed_users = []    # 允许的用户 ID 列表（留空则允许所有人，建议设置具体 ID）

uv run openlist-ani-assistant

内置 skills 会随程序包加载并自动更新；./skills 只用于新增自定义 skill，或放置同名 skill 来覆盖内置版本。

1. 准备文件

在运行目录下创建：

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

2. 启动容器

docker run -d \
  --name openlist-ani \
  --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。
详细说明见 Docker 部署指南。

pip install openlist-ani
openlist-ani

# 可选：启动 AI 助理
openlist-ani-assistant