• Stars
    star
    396
  • Rank 108,801 (Top 3 %)
  • Language
    Emacs Lisp
  • License
    GNU General Publi...
  • Created almost 2 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

ChatGPT in Emacs

ChatGPT.el

ChatGPT in Emacs.

News

7/8/2023: Shortcut customization has been reworked, see here.

Installation

Dependency

Set your OpenAI API key. In .zshrc/bashrc,

export OPENAI_API_KEY=<API_KEY>

For Windows users, see here.

Install llm-workflow-engine:

pip install --upgrade pip
pip install setuptools
pip install git+https://github.com/llm-workflow-engine/llm-workflow-engine

If you encounter any problems, please submit an issue or refer to llm-workflow-engine (formerly chatgpt-wrapper).

Straight

(use-package chatgpt
  :straight (:host github :repo "joshcho/ChatGPT.el" :files ("dist" "*.el"))
  :bind ("C-c q" . chatgpt-query))

Quelpa

(require 'quelpa-use-package)
(use-package chatgpt
  :quelpa ((chatgpt :fetcher git :url "https://github.com/joshcho/ChatGPT.el.git") :upgrade t)
  :bind ("C-c q" . chatgpt-query))

Spacemacs

Assuming Quelpa installation:

In dotspacemacs/user-config function,

(global-set-key (kbd "C-c q") #'chatgpt-query)

In dotspacemacs/layers function for setq-default,

dotspacemacs-additional-packages
'(
  (chatgpt :location (recipe
                      :fetcher github
                      :repo "joshcho/ChatGPT.el"))
  ;; other additional packages...
  )

Doom Emacs

In packages.el ,

(package! chatgpt
  :recipe (:host github :repo "joshcho/ChatGPT.el" :files ("dist" "*.el")))

In config.el ,

(use-package! chatgpt
  :defer t
  :bind ("C-c q" . chatgpt-query))

Usage

Press C-c q to query ChatGPT. Select a code block before C-c q to query the code.

Customization

Chat

Configure default model, system message, browser backend, etc. with llm-workflow-engine.

Code Query Shortcuts

Customize chatgpt-code-query-map for your own prompt shortcuts. Note that โ€œcustomโ€ is a reserved prompt shortcut.

(setq chatgpt-code-query-map
      '(
        ;; ChatGPT.el defaults, string for each shortcut
        ("bug" . "There is a bug in the following, please help me fix it.")
        ("doc" . "Please write the documentation for the following.")
        ("improve" . "Please improve the following.")
        ("understand" . "What is the following?")
        ("refactor" . "Please refactor the following.")
        ("suggest" . "Please make suggestions for the following.")
        ;; your shortcut
        ("prompt-name" . "My custom prompt.")))

If you previously had customizations, note that we use strings now, not format strings.

Related Projects