Skip to main content

Built and signed on GitHub Actions

An LLM-powered CLI tool for summarizing web pages

This package works with Deno
This package works with Deno
JSR Score
94%
Published
2 weeks ago (0.5.1)

Yoyak: An LLM-powered CLI tool for summarizing web pages

Demo session

This is a small CLI tool that uses LLM to summarize and translate web pages.

Installation

We distribute the official executables for Linux, macOS, and Windows. You can download them from the releases page.

Or if you have Deno installed on your system, you can install this program by running the following command:

deno install -gENRSW jsr:@hongminhee/yoyak/cli

Usage

At very first, you need to set the model you want to use. You can do this by running the following command (see also supported models below):

yoyak set-model gemini-2.0-flash-exp

It asks for the API key via the standard input, and stores it in configuration file.

Then you can use the yoyak summary command to summarize a web page:

yoyak summary https://github.com/dahlia/yoyak

It prints the summary of the web page to the standard output.

If you want to translate the summary to another language, you can use the -l/--language option (which takes ISO 639-1 language code):

yoyak summary -l ko https://github.com/dahlia/yoyak

It translates the summary to Korean.

Tip

You can also give a local file path or - as an argument. If - is given, the command reads the input from the standard input.

Shell completion

Yoyak provides shell completion scripts for bash, fish, and zsh.

Bash

To enable bash completion, add the following line to your ~/.bashrc or ~/.bash_profile:

source <(yoyak completions bash)

Fish

To enable fish completion, add the following line to your ~/.config/fish/config.fish:

source (yoyak completions fish | psub)

Zsh

To enable zsh completion, add the following line to your ~/.zshrc:

source <(yoyak completions zsh)

Or run the following command to use zsh fpath completions:[^1]

yoyak completions zsh > /usr/local/share/zsh/site-functions/_yoyak

[^1]: The site-functions path may vary depending on your system.

Supported models

  • chatgpt-4o-latest
  • claude-3-5-haiku-latest
  • claude-3-5-sonnet-latest
  • claude-3-opus-latest
  • deepseek-chat
  • deepseek-reasoner
  • gemini-1.5-flash
  • gemini-1.5-flash-8b
  • gemini-1.5-pro
  • gemini-2.0-flash-exp
  • gemini-2.0-flash-lite-preview-02-05
  • gemini-2.0-flash-thinking-exp-01-21
  • gemini-2.0-pro-exp-02-05
  • gpt-4o
  • gpt-4o-mini
  • o1
  • o1-mini
  • o1-preview
  • o3-mini

Etymology

Yoyak (要約) is a Sino-Korean word that means summary.

Built and signed on
GitHub Actions
View transparency log

Add Package

deno add jsr:@hongminhee/yoyak

Import symbol

import * as yoyak from "@hongminhee/yoyak";

---- OR ----

Import directly with a jsr specifier

import * as yoyak from "jsr:@hongminhee/yoyak";