All plugins

hackertube

Source-backed media discovery with existing Hermes providers and a profile-local library. Disclosure — each explicit Search sends your question and candidate metadata to the Hermes auxiliary model you pick and your Hermes web-search backend (this may spend credits). It also queries hn.algolia.com, itunes.apple.com, openlibrary.org, librivox.org and, with your key, www.googleapis.com (YouTube) and api.podcastindex.org. Searches run in a Python worker subprocess that re-launches the `hermes` CLI from PATH with Hermes's environment (YOLO vars stripped). An hourly local thread purges expired records from plugin-data/hackertube/profile.db.

rcmiller01Webv0.2.2Updated 2 hours ago

About

Source-backed media discovery with existing Hermes providers and a profile-local library. Disclosure — each explicit Search sends your question and candidate metadata to the Hermes auxiliary model you pick and your Hermes web-search backend (this may spend credits). It also queries hn.algolia.com, itunes.apple.com, openlibrary.org, librivox.org and, with your key, www.googleapis.com (YouTube) and api.podcastindex.org. Searches run in a Python worker subprocess that re-launches the `hermes` CLI from PATH with Hermes's environment (YOLO vars stripped). An hourly local thread purges expired records from plugin-data/hackertube/profile.db.

HackerTube for Hermes

Discover videos, podcasts, books, and audiobooks in the Hermes web dashboard. Ask a focused question using a provider already configured in Hermes, save source-backed results in a profile-local library, and open their originals.

Andrej Karpathy created the original HackerTube and inspired this project. Read his original post and visit hackertube.org. This is an independent Hermes adaptation.

Install and configure

Requires Hermes >=0.23.0, macOS or Linux, and the Hermes CLI on the dashboard process PATH. This directory is the complete native plugin: plugin.yaml, __init__.py, dashboard, core package, and seed. Install this directory through Hermes's supported local-plugin workflow, enable HackerTube, then reload the dashboard. Validate with hermes plugins validate /absolute/path/to/hackertube --install-deps.

Choose an existing provider under Focused search → Search provider and model → Use for search, or Models → Auxiliary → HackerTube search. No separate model key or endpoint is needed. The development-only stub does not retrieve live results.

Optional YouTube and Podcast Index keys belong in Hermes's declared secret settings (YOUTUBE_API_KEY, PODCASTINDEX_API_KEY, PODCASTINDEX_API_SECRET). Enable a source only after configuring it. Never put keys in plugin files or plugin data. Open Library contact identification can be configured as the private Hermes setting OPENLIBRARY_CONTACT; it is sent only in Open Library request headers, never other providers or query URLs. Reddit remains disabled pending separate approval. The prepared catalog is small development content; it has no curated community endorsements.

Network, privacy, and storage disclosure

Only explicit Search sends the question and bounded candidate metadata to the selected Hermes model provider. Retrieval can contact Hacker News (hn.algolia.com, hacker-news.firebaseio.com), Apple/iTunes (itunes.apple.com), Open Library (openlibrary.org, covers.openlibrary.org), LibriVox (librivox.org), enabled YouTube Data API (www.googleapis.com), configured Podcast Index (api.podcastindex.org), and the user's configured Hermes web-search backend. Provider routing and retries belong to Hermes. Public source links open in the browser. Open Library cover hotlinks may load when permitted by a stored record; search does not download artwork or media. Apple artwork is not loaded.

Ordinary browsing, local ranking, and library actions make no model or search calls. Explicit Search may spend credits or source quota. Missing cost is shown as unknown. Jobs allow 12 logical dispatches, 24 results, and a 45-second local deadline, including worker startup. Deadline expiry or Cancel terminates the private worker process group and closes its local requests before confirming the terminal status. A remote provider may still process or bill a request it already accepted. Logical dispatches do not count every vendor retry. Only one Search may run per profile; job handles are scoped with random nonces. Parent death stops orphan work; unfinished jobs are recovered as interrupted on status access and are never resumed automatically.

Hermes stores model credentials. The plugin reads only its declared source secrets through Hermes secret scope. It does not read credential files, memory, or unrelated chat history. It reads its bundled seed and uses Hermes configuration and plugin services. It stores normalized source records, questions/job summaries and terminal results, interests, saves, dismissals, source settings, and open history in plugin-data/hackertube/profile.db under the active Hermes home. Only an explicit accepted Search launches a supervised Python/Hermes CLI worker plus an independent deadline watchdog. It invokes the registered hermes hackertube-worker command through fixed arguments and private inherited pipes, without an agent turn or approval-bypass flags. Provider work runs inside that group; disabling/unloading the plugin stops its owned jobs. It starts no recurring paid job, telemetry, self-updater, or media player. Data remains after disabling the plugin; remove its plugin-data directory while Hermes is stopped to erase it. YouTube catalog records and durable Search-result copies expire after 30 days and are purged when the profile store opens or its catalog/results are accessed. Search copies use the original metadata age, so a later search does not renew an older record. Usage/job summaries and library flags survive without the expired titles. Local cleanup runs when Hermes accesses the profile; it cannot run while Hermes is stopped.

Source records establish identity, not an endorsement or a guarantee of relevance. Model explanations may be wrong. Unknown duration remains unknown and is excluded from a strict duration match. Source-specific release obligations, lifecycle testing, and the broader relevance evaluation remain open. See the repository's source plan, live-search notes, and submission checklist.

When YouTube is enabled, use is subject to the YouTube Terms of Service and Google Privacy Policy.

Privacy and deletion

Before using any HackerTube feature, review and explicitly agree to the bundled privacy policy and terms. Privacy remains available on every page. A new policy version requires renewed agreement. The credit-use checkbox is separate.

Privacy → Delete HackerTube data and revoke agreement clears this profile’s plugin data after active Search is cancelled. It leaves Hermes-managed credentials and provider-held data alone. While Hermes runs, hourly local housekeeping purges expired metadata; opening/accessing a profile also purges before display. Stopped Hermes cannot delete files until it resumes. Do not retain exported profile backups beyond the source retention window. No background network refresh is scheduled.

YouTube results link to the original video and show unmodified official source branding. Relevance explanations/library controls are HackerTube features. Successful metadata hydration invalidates checked IDs in both the catalog and earlier Search responses before new data is saved; deleted/private records disappear, while independent saved flags remain. Errors do not pretend a record was deleted.

README from the reviewed commit 3e65af3; it updates when the author re-pins.