MoviePilot README

The project's README from github.com/jxxghp/MoviePilot. As one markdown file: README.md.

MoviePilot

简体中文 | English

GitHub Repo stars GitHub forks GitHub contributors GitHub repo size GitHub issues Docker Pulls Docker Pulls V2 Docker Pulls V3 Platform

基于 NAStool 部分代码重新设计,聚焦自动化核心需求,减少问题同时更易于扩展和维护。

仅用于学习交流使用,请勿在任何国内平台宣传该项目!

发布频道:https://t.me/moviepilot_channel

主要特性

安装使用

推荐优先使用 Docker 部署。V3 使用独立镜像 jxxghp/moviepilot-v3,V2 和旧版镜像保持原命名。Compose 示例、环境变量、目录映射和升级方式以官方 Wiki 为准:

也可以使用本地 CLI 以源码模式安装和管理 MoviePilot:

curl -fsSL https://raw.githubusercontent.com/jxxghp/MoviePilot/v3/scripts/bootstrap-local.sh | bash

安装完成后使用 moviepilot 命令完成初始化、启动、停止、更新和配置查看。完整命令见 docs/cli.md。

Agent

  1. MoviePilot 自带智能体能力,可在完成模型配置后,通过自然语言调用系统工具,辅助完成搜索、订阅、下载、整理、排障等管理任务。

  2. 其它智能体可以导入本仓库的 skills/ 目录以获得 MoviePilot 操作能力;支持 skills CLI 的环境可使用:

    npx skills add https://github.com/jxxghp/MoviePilot
    

    内置 Skills 列表见 skills/,自定义 Skill 可参考 skills/create-moviepilot-skill/SKILL.md。

  3. 其它 MCP 客户端可以通过 MoviePilot 的 MCP 端点 /api/v1/mcp 调用工具,认证方式、客户端配置和工具 API 见 docs/mcp-api.md。

参与开发

开发前请先阅读仓库规则和本地环境说明,保持变更聚焦,通过测试后再提交 PR。常用入口:

相关项目

免责申明

贡献者

MoviePilot (jxxghp/MoviePilot)

Searching Database…

Что это такое?MoviePilot — это самостоятельно размещаемый инструмент автоматизации для управления медиатекой на NAS. Он охватывает весь процесс работы с фильмами и сериалами: подписки, поиск, загрузку, сортировку, получение метаданных, обновление медиасерверов и отправку уведомлений.
Это настольное приложение или веб-сервис, который я запускаю на своём NAS?Это самостоятельно размещаемое веб-приложение с разделённой архитектурой: бэкенд на FastAPI и фронтенд на Vue 3. Оно предназначено для постоянной работы на NAS или сервере, а не для локальной настольной программы.
Как установить и запустить MoviePilot?Рекомендуемый способ — Docker: для V3 используется собственный образ jxxghp/moviepilot-v3 (старая V2 сохраняет прежнее название образа), примеры Compose и переменные окружения описаны в официальной Wiki. Также можно установить из исходников и управлять через локальную утилиту `moviepilot` (команды init, start, stop, update, config).
Нужно ли заранее настроить клиент загрузки или медиасервер?Да. MoviePilot — это центр, который подключается к внешним загрузчикам, медиасерверам, источникам метаданных и каналам уведомлений, а также к необязательным плагинам, воркфлоу и ИИ-агенту. Чтобы он действительно работал с вашей медиатекой, эти сервисы нужно настроить.
Есть ли ограничения на использование, о которых стоит знать?Проект явно предназначен только для обучения и изучения: коммерческое и незаконное использование запрещены, а автор просит не продвигать его на китайских внутренних платформах. Также при распространении изменённых копий не рекомендуется обходить или менять встроенную систему аутентификации; ответственность за это лежит на том, кто вносит такие изменения.
Что делает встроенный Agent/ИИ?После настройки модели встроенным ИИ-агентом MoviePilot можно управлять на естественном языке: искать, подписываться, загружать, сортировать медиатеку и разбираться с неполадками. Другие агенты могут импортировать каталог skills/, а внешние MCP-клиенты могут подключаться через эндпоинт /api/v1/mcp.
Где находятся плагины и связанные инструменты?Плагины поставляются в отдельном репозитории MoviePilot-Plugins. Рядом есть сопутствующие проекты: фронтенд (MoviePilot-Frontend), общие ресурсы (MoviePilot-Resources), серверный вариант (MoviePilot-Server) и переписанная на Rust версия (MoviePilot-Rust).
Можно ли использовать PostgreSQL вместо базы данных по умолчанию?Да, PostgreSQL поддерживается как бэкенд. Шаги настройки описаны отдельно в файле docs/postgresql-setup.md.
Creator
jxxghp
Size
86.9 MB
Stars
11.9K
Age
3y
Commits · 90 Days