olares-knowledge

Manage Olares download-server tasks for URLs, torrents, and HuggingFace repositories via olares-cli.

5.2k|321|Updated Apr 29, 2024
One-click install
npx skills add https://github.com/beclab/Olares --skill olares-knowledge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: olares-knowledge
Source: https://github.com/beclab/Olares/tree/main/cli/skills/olares-knowledge
Command: npx skills add https://github.com/beclab/Olares --skill olares-knowledge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing downloads on an Olares personal cloud—whether plain URLs, yt-dlp media, aria2 transfers, torrents, or HuggingFace models—requires coordinating many CLI verbs, task states, and provider quirks. This Skill gives an AI agent the operational knowledge to create, monitor, pause, resume, and clean up download tasks correctly without misreading asynchronous states or mishandling naming, duplicates, and credentials.

Core Features & Use Cases

  • Full task lifecycle control: Create, list, inspect, wait on, pause, resume, cancel, and remove download tasks across yt-dlp, aria2, torrent, and HuggingFace providers, with correct handling of mover-phase 409s and terminal states.
  • Torrent and provider tooling: Inspect .torrent files, select files by index, view stats and peers, control seeding, probe URL providers/qualities, and manage per-app quality preferences and global aria2 settings.
  • Sync and file utilities: Track unfinished tasks, drain incremental sync cursors, pre-check URL collisions, and remove downloaded resources by path.
  • Use Case: Ask the agent to download a YouTube video at 1080p to your Wise app; it creates the task, polls info for status, and reports completion—handling cookie-gated URLs by guiding you through a cookies.txt import.

Quick Start

Ask the agent to download a URL, for example: download this video to my Wise app at 1080p and let me know when it finishes.

Frequently Asked Questions about olares-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download a YouTube video with olares-cli?

Run olares-cli knowledge download create with the video URL and your target app, optionally adding --quality 1080p. The CLI probes the URL, names the task from the inspect title, and returns a task id you poll with the info command until it reaches a terminal status.

How do I download only some files from a torrent?

First run torrent inspect on the .torrent file to get the 1-based file list, then pass --select-files with comma-separated indices to create, or use torrent files --select on an existing task. The selection replaces the full set rather than applying a delta.

Why does my download fail with a login or authorization error?

Error codes 501, 507, 511, 512 or categories like authorization_failed mean the server lacks a session for that site. Export a cookies.txt from your logged-in browser and import it with olares-cli settings integration cookie import, then retry the download.

Does creating the same URL twice reuse the existing task?

No, re-submitting a URL always creates a new task row with no duplicate detection. Check list or info first if you intend to reuse an existing task, since the CLI will not block duplicates.

Why do resume or cancel return a 409 error on my task?

A 409 means the task is in the yt-dlp mover phase (waiting_to_move or moving), so resume, cancel, and remove are temporarily rejected. Poll info until the move finishes, then retry the operation.

What Olares version is required for knowledge download commands?

All knowledge download verbs require Olares 1.12.7 or later because both the Settings download edge and provider must be present. You also need olares-cli on PATH with an active Olares profile.