yt-quick-insights

CLI tool designed to extract meaningful insights from YouTube videos without watching them.

MIT License

Downloads
105
Stars
2
Committers
1

YouTube Quick Insights is a CLI tool designed to extract meaningful insights from YouTube videos without watching them. Download the YouTube transcript, integrate it into a ready-to-use prompt, and use it with your favorite LLM.



About the Project

Key Features

  • Prompt Generation: Generate and download ready-to-use prompts as txt files to help you gain insights from YouTube
    video content.
  • Prompt Customization: Tailor prompts to fit various needs such as basic summaries, extracting action steps,
    summarizing podcasts, or extracting resources.

Why it's valuable?

  • Save Time: Obtain critical information from videos without spending time watching them.
  • Flexibility: Customize the prompt generation process according to your needs, ensuring that you get the insights
    that matter most to you.
  • Ease of Use & Cost-Free: CLI is easy to use and doesn't require an OpenAI API key, making it completely free with
    no additional costs.

Installation

Recommended: Create and activate a virtual environment before installing the tool.

Using pip

pip install yt-quick-insights

Using poetry

poetry add yt-quick-insights

To verify that everything works and to see all available commands

insights --help

Usage

Download the prompt in txt format in your current working directory.

insights download https://www.youtube.com/watch?v=VIDEO_ID

Customize the prompt to your needs with different tasks by using the -t flag.

To see all available tasks run: insights available-tasks

Additional you can add background information for the video by using the -b flag. Example:

insights download https://www.youtube.com/watch?v=VIDEO_ID -t podcast_summary -b "In this podcast episode 4 guests and a moderator talk about the future of AI."

Configure your own task

Create a yaml file in your home directory under ~/.insights/task_details.yml.

custom: |
  Create your own custom task here.
  You can use multiple lines to describe your task.
  
default: |
  If you add a task name 
  that already exists in the default tasks, 
  it will be overwritten.

Not sure where to create the yaml file in your system?

insights yaml-location

You can use your custom task by running the download command with the -t option

insights download https://www.youtube.com/watch?v=VIDEO_ID -t custom

To see all currently available tasks

insights available-tasks

Limitations

  • Transcript Quality: YouTube's auto-generated transcripts can contain errors.
  • AI Imperfections: LLMs are not perfect
  • Technical Requirements: Basic command-line knowledge is needed.

Roadmap

  • Publish on PyPI
  • Add option to summarize the transcript directly insight the CLI using an LLM.
  • Create a web-based interface for non-technical users.

Contact