seb/hermes-agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(skills): run youtube transcript helper through uv

Browse Source
This commit is contained in:
helix4u 2026-06-12 12:52:09 -06:00 committed by Teknium
parent 8905ee6b8a
commit 1899c8f507
3 changed files with 23 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
skills/media/youtube-content/SKILL.md
View File

@ -14,8 +14,11 @@ Extract transcripts from YouTube videos and convert them into useful formats.
## Setup ## Setup
Use `uv` so the dependency is installed into the same Hermes-managed environment
that runs the helper script:
```bash ```bash
pip install youtube-transcript-api uv pip install youtube-transcript-api
``` ```
## Helper Script ## Helper Script
@ -24,16 +27,16 @@ pip install youtube-transcript-api
```bash ```bash
# JSON output with metadata # JSON output with metadata
python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID" uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# Plain text (good for piping into further processing) # Plain text (good for piping into further processing)
python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# With timestamps # With timestamps
python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# Specific language with fallback chain # Specific language with fallback chain
python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
``` ```
## Output Formats ## Output Formats
@ -59,7 +62,7 @@ After fetching the transcript, format it based on what the user asks for:
## Workflow ## Workflow
1. **Fetch** the transcript using the helper script with `--text-only --timestamps`. 1. **Fetch** the transcript using the helper script with `--text-only --timestamps` via `uv run python3`.
2. **Validate**: confirm the output is non-empty and in the expected language. If empty, retry without `--language` to get any available transcript. If still empty, tell the user the video likely has transcripts disabled. 2. **Validate**: confirm the output is non-empty and in the expected language. If empty, retry without `--language` to get any available transcript. If still empty, tell the user the video likely has transcripts disabled.
3. **Chunk if needed**: if the transcript exceeds ~50K characters, split into overlapping chunks (~40K with 2K overlap) and summarize each chunk before merging. 3. **Chunk if needed**: if the transcript exceeds ~50K characters, split into overlapping chunks (~40K with 2K overlap) and summarize each chunk before merging.
4. **Transform** into the requested output format. If the user did not specify a format, default to a summary. 4. **Transform** into the requested output format. If the user did not specify a format, default to a summary.
@ -70,4 +73,4 @@ After fetching the transcript, format it based on what the user asks for:
- **Transcript disabled**: tell the user; suggest they check if subtitles are available on the video page. - **Transcript disabled**: tell the user; suggest they check if subtitles are available on the video page.
- **Private/unavailable video**: relay the error and ask the user to verify the URL. - **Private/unavailable video**: relay the error and ask the user to verify the URL.
- **No matching language**: retry without `--language` to fetch any available transcript, then note the actual language to the user. - **No matching language**: retry without `--language` to fetch any available transcript, then note the actual language to the user.
- **Dependency missing**: run `pip install youtube-transcript-api` and retry. - **Dependency missing**: run `uv pip install youtube-transcript-api` and retry.

6
skills/media/youtube-content/scripts/fetch_transcript.py
View File

@ -3,7 +3,7 @@
Fetch a YouTube video transcript and output it as structured JSON. Fetch a YouTube video transcript and output it as structured JSON.
Usage: Usage:
python fetch_transcript.py <url_or_video_id> [--language en,tr] [--timestamps] uv run python3 fetch_transcript.py <url_or_video_id> [--language en,tr] [--timestamps]
Output (JSON): Output (JSON):
{ {
@ -14,7 +14,7 @@ Output (JSON):
"timestamped_text": "00:00 first line\n00:05 second line\n..." "timestamped_text": "00:00 first line\n00:05 second line\n..."
} }
Install dependency: pip install youtube-transcript-api Install dependency: uv pip install youtube-transcript-api
""" """
import argparse import argparse
@ -56,7 +56,7 @@ def fetch_transcript(video_id: str, languages: list = None):
try: try:
from youtube_transcript_api import YouTubeTranscriptApi from youtube_transcript_api import YouTubeTranscriptApi
except ImportError: except ImportError:
print("Error: youtube-transcript-api not installed. Run: pip install youtube-transcript-api", print("Error: youtube-transcript-api not installed. Run: uv pip install youtube-transcript-api",
file=sys.stderr) file=sys.stderr)
sys.exit(1) sys.exit(1)

17
website/docs/user-guide/skills/bundled/media/media-youtube-content.md
View File

@ -34,8 +34,11 @@ Extract transcripts from YouTube videos and convert them into useful formats.
## Setup ## Setup
Use `uv` so the dependency is installed into the same Hermes-managed environment
that runs the helper script:
```bash ```bash
pip install youtube-transcript-api uv pip install youtube-transcript-api
``` ```
## Helper Script ## Helper Script
@ -44,16 +47,16 @@ pip install youtube-transcript-api
```bash ```bash
# JSON output with metadata # JSON output with metadata
python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID" uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# Plain text (good for piping into further processing) # Plain text (good for piping into further processing)
python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# With timestamps # With timestamps
python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# Specific language with fallback chain # Specific language with fallback chain
python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
``` ```
## Output Formats ## Output Formats
@ -79,7 +82,7 @@ After fetching the transcript, format it based on what the user asks for:
## Workflow ## Workflow
1. **Fetch** the transcript using the helper script with `--text-only --timestamps`. 1. **Fetch** the transcript using the helper script with `--text-only --timestamps` via `uv run python3`.
2. **Validate**: confirm the output is non-empty and in the expected language. If empty, retry without `--language` to get any available transcript. If still empty, tell the user the video likely has transcripts disabled. 2. **Validate**: confirm the output is non-empty and in the expected language. If empty, retry without `--language` to get any available transcript. If still empty, tell the user the video likely has transcripts disabled.
3. **Chunk if needed**: if the transcript exceeds ~50K characters, split into overlapping chunks (~40K with 2K overlap) and summarize each chunk before merging. 3. **Chunk if needed**: if the transcript exceeds ~50K characters, split into overlapping chunks (~40K with 2K overlap) and summarize each chunk before merging.
4. **Transform** into the requested output format. If the user did not specify a format, default to a summary. 4. **Transform** into the requested output format. If the user did not specify a format, default to a summary.
@ -90,4 +93,4 @@ After fetching the transcript, format it based on what the user asks for:
- **Transcript disabled**: tell the user; suggest they check if subtitles are available on the video page. - **Transcript disabled**: tell the user; suggest they check if subtitles are available on the video page.
- **Private/unavailable video**: relay the error and ask the user to verify the URL. - **Private/unavailable video**: relay the error and ask the user to verify the URL.
- **No matching language**: retry without `--language` to fetch any available transcript, then note the actual language to the user. - **No matching language**: retry without `--language` to fetch any available transcript, then note the actual language to the user.
- **Dependency missing**: run `pip install youtube-transcript-api` and retry. - **Dependency missing**: run `uv pip install youtube-transcript-api` and retry.