Building an Open-Source AI Agent for Self-Hosted Media Acquisition & Multi-Drive Routing

Description and use

Mediary Scout is an open‑source AI agent that replaces brittle regex rules in home media servers, verifies content in a sandboxed staging area, routes files across multiple cloud drives, and respects user preferences, simplifying library management.

Problem

Traditional automation stacks for home media servers fail with cloud drives and public share/magnet indexers due to dead links, unstandardized episode numbering, storage fragmentation, and missing subtitles.

Outcome

Mediary Scout replaces brittle regex rules with an AI‑powered, sandboxed workflow that verifies media, routes files across multiple cloud drives, and respects user preferences, reducing manual effort and storage fragmentation.

Workflow

• 1. User submits a media request or note to the agent.
• 2. Agent performs natural‑language discovery, cross‑referencing TMDB and web search to resolve titles and episode dates.
• 3. Agent fetches candidate share/magnet links and downloads them to a sandboxed _staging directory.
• 4. Agent inspects the landed directory, verifies video file extensions, sizes, and episode presence, and removes promotional spam.
• 5. Agent renames verified files into clean Movies/, TV/, or Anime/ structures and moves them to the production library, discarding staging if verification fails.
• 6. Agent updates persistent memory with any user‑specified source replacements or subtitle preferences.
• 7. Agent routes large 4K packages to cloud drives with real‑time quota checks, using MultiDriveStorageV2 to balance space and complete ongoing shows across drives.
• 8. Agent exposes a REST API for external agents (Claude Code, Codex, OpenClaw) to query library status, trigger acquisitions, or inspect patrol status.
• 9. Users can interact with the agent via the web UI, Docker Compose, or native macOS/Windows app.
• 10. The agent continuously patrols the library, applying user preferences and maintaining clean media organization.

Evidence

Tools like Sonarr, Radarr, and MoviePilot are fantastic when your entire pipeline runs on clean private trackers or Usenet indexers with predictable scene naming.

Source

Instead of relying on static regular expressions to guess whether a candidate link matches your library, Mediary Scout gives an LLM agent a sandboxed set of storage and verification tools.

Source

It transfers the resource into an isolated _staging directory first.

Source

In our latest release (v2026.10.29), we introduced a unified MultiDriveStorageV2 architecture: 6 Native Cloud Drives... Real-Time Quota Gate... Cross-Drive Season Completion.

Source