Categories
Self-Hosted AI Agents Homelab Media Library Media Automation NAS Home Media Server Cloud Drive ManagementStars
Forks
Watchers
Developer links
Mediary Scout
Mediary Scout puts an AI agent in charge of your cloud drive media library: name a movie, series, or anime and it finds a release, transfers it into your own drive, and checks that the files really arrived. Connect Quark, UC, 115, 123, GuangYaPan, and Tianyi, mostly with a QR code scan, and the agent probes live free space on every drive before each run, hard-blocking any that is full or over quota. It prefers a single drive that can cover every missing episode and combines drives only when none can, recording which drive holds each episode in one library. Search starts with the bundled PanSou for share links, optional Haisou and Prowlarr sources add more links and magnets, and transfers land in a staging folder first, where the agent inspects real file sizes, deletes ad files and lower-bitrate duplicates, then sorts episodes into Season folders. A daily patrol fills in missing episodes of tracked shows. Foreign titles that arrive without Chinese subtitles get matching .ass or .srt files from assrt.net, renamed to match the video. Unhappy with a file? Leave a plain-language note on the title, and the agent blacklists that source on every drive and fetches a replacement. A built-in HTTP API lets Claude Code, Codex, or OpenClaw queue titles and check progress, while multi-user mode gives family members separate accounts, drives, and libraries. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. 0BSD licensed.
Benefits
- Zero Local Disk or Seeding
- Transfers execute server-side on the cloud drive's own infrastructure, with offline magnet downloads on 115, 123, and GuangYaPan, so your VPS needs no terabyte storage, torrent client, or seeding bandwidth.
- Full Drives Are Blocked Early
- Each run starts by probing every drive's remaining capacity, and full or over-quota drives are hard-blocked at the sandbox gate, so a lapsed Quark SVIP plan cannot derail a download.
- Every Transfer Is Read Back
- Files land in a staging folder first; the agent inspects actual video files and sizes, removes ads and lower-bitrate duplicates, files episodes under Season folders, then rereads the drive to confirm.
- Your Keys Stay On Your Server
- Your AI model key stays in your own instance, which is self-hosted only. An access password and optional multi-user mode keep each person's drives and library separate from everyone else's.
Features
- Six-Drive Orchestration
- Quark, UC, 115, 123, GuangYaPan, and Tianyi connect through QR login or pasted tokens, with single-drive priority and cross-drive completion tracked per episode in one library.
- Sandboxed Agent Pipeline
- A resident worker drives a write-scoped sandbox agent through any OpenAI-compatible model; deterministic, logged steps change the drive, and the real folder state is reread afterward to verify.
- Multi-Source Release Search
- Bundled PanSou plus optional Haisou and Prowlarr supply share links and magnets, while the agent ranks releases by quality and live drive space before transferring them.
- Subtitle Completion via assrt.net
- When a foreign title lands without Chinese subtitles, the agent searches assrt.net, downloads matching packages into the drive, and renames .ass or .srt files to match each video.
- Agent HTTP API
- Five Bearer-token endpoints under /api/agent (acquire, library, activity, patrol, config) let Claude Code, Codex, or OpenClaw queue titles, inspect progress, and trigger patrols.
- Docker Compose Deployment
- One docker compose command starts the Next.js web UI on port 3000 with its in-process worker, PostgreSQL 16, and a bundled PanSou; one-click updates back up the database first.