youtube-ai-resume 0.0.5

CLI & library that extracts YouTube captions and returns an OpenAI-generated summary

youtube-ai-resume dQw4w9WgXcQ # Rick Astley demo 😄 txt = caption.fetch_caption("dQw4w9WgXcQ")

youtube-ai-resume

Generate concise AI summaries of YouTube videos from the command line.
It works in two steps:

1. Downloads the video caption (subtitles) with pytubefix.
2. Sends the caption to the OpenAI API and returns a summary in the language you choose.

---

Features

• Zero-setup CLI → youtube-ai-resume <video_id>
• Summaries in any language (default pt_BR)
• Works with models like gpt-4.1-mini (configurable)
• Rich-formatted output with colours
• Usable as a library (import youtube_ai_resume)

---

Installation

# Python ≥ 3.9
pip install youtube-ai-resume

Or, from source for development:

git clone https://github.com/fberbert/youtube-ai-resume.git
cd youtube-ai-resume
pip install -e ".[dev]"     # editable + dev tools

Quick start

Command Line Usage

export OPENAI_API_KEY="sk-..."
youtube-ai-resume dQw4w9WgXcQ     # Rick Astley demo 😄

Sample output:

Summary:

• Rick distances himself from breaking promises
• Emphasises commitment (“never gonna give you up…”) …

Library usage

from youtube_ai_resume import caption, summarizer

txt = caption.fetch_caption("dQw4w9WgXcQ")
summary = summarizer.summarize(
    transcript=txt,
    api_key="sk-…",
    model="gpt-4.1-mini",
    out_lang="en"
)
print(summary)

Configuration

Voice narration (Text-to-Speech) [Optional]

You can optionally have the summary narrated aloud using Google Cloud Text-to-Speech (TTS).

Optional Requirements (only if you want voice narration)

• A Google Cloud account with the Text-to-Speech API enabled
• A service account key (JSON) with permission to use TTS
• The dependencies google-cloud-texttospeech and playsound (already included in requirements.txt)

Optional Setup

1. Create a project in Google Cloud and enable the Text-to-Speech API.
2. Generate and download a service account credentials file (JSON).
3. Set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of your credentials file:

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account.json"

Or authenticate using the Google Cloud CLI (gcloud):

gcloud auth application-default login

Usage

• To hear the summary narration, add the --voice option to the command:

youtube-ai-resume dQw4w9WgXcQ --voice

• To enable narration by default, add to your config.json:

{
    "voice_enabled": true
}

You can customize voice, language, and speed in config.json (see code examples).

---

You can set the OpenAI API key as an environment variable or in a config file.

Environment variable:

OPENAI_API_KEY="sk-..."

Config file at ~/.config/youtube-ai-resume/config.json (auto-created on first run) lets you change the default model.

{
    "model": "gpt-4.1-mini",
    "out_lang": "en"
}

Development

Contributions are welcome!

Fork ➜ branch ➜ PR.

ruff check . and pytest must pass.

Describe your change clearly.

License

Released under the MIT License – see LICENSE.