2.6 KiB
2.6 KiB
kagi.el README
Introduction
This Emacs package provides the following functionalities from the Kagi search engine:
- FastGPT
- Kagi's open source LLM offering, as a shell inspired by xenodium's chatgpt-shell.
- Universal Summarizer
- Summarizes texts, webpages, videos and more.
Setup
- Create a Kagi account if you haven't done so already. An account is free, and comes with 100 trial searches.
- In your account settings, put a balance for the API part (note that this is a separate balance than the subscription). The recommendation is to start with a one-time charge of $5. A single query ranges from 1 to 5 cents typically, depending on the amount of tokens processed.
- In the API portal, create an API token. Put the result in
kagi-api-token
.
Commands
FastGPT
The FastGPT functionality has only one command: kagi-fastgpt-shell
. This opens a shell buffer in a new window where prompts can be typed.
Universal Summarizer
-
kagi-summarize-buffer
- Summarizes the content of a buffer and displays it in a separate buffer.
-
kagi-summarize-region
- Similarly, the text inside the region is summarized and shown in a separate buffer.
-
kagi-summarize-url
- Prompts for a URL of which a summary is composed and displayed.
Installation and configuration
kagi.el is not on MELPA (yet?), so for now only Git access is possible.
Clone with:
git clone https://codeberg.org/bram85/kagi.el.git /path/to/kagi.el
Note that kagi.el has a dependency on the shell-maker package, which is available on MELPA.
You way want to load and configure the package with use-package
, for example put the following in your Emacs init file:
(use-package kagi
:commands
kagi-fastgpt-shell
kagi-summarize-buffer
kagi-summarize-region
kagi-summarize-url
:ensure nil
:load-path "/path/to/kagi.el"
:custom
(kagi-api-token "ABCDEF")
;; or use a function, e.g. with the password-store package:
(kagi-api-token (lambda () (password-store-get "Kagi/API")))
;; summarizer settings
(kagi-api-summarizer-engine "cecil")
(kagi-api-summarize-default-language "EN"))
The token can be supplied directly as a string, but you could write a lambda to retrieve the token from a more secure location (e.g. pass(1)).