guix-epistemia

emacs.scm (12521B)

---

 (define-module (epistemia packages emacs)
   #:use-module (guix packages)
   #:use-module (guix download)
   #:use-module (guix git-download)
   #:use-module (guix build-system emacs)
   #:use-module ((guix licenses) :prefix license:)
   #:use-module (gnu packages emacs-build)
   #:use-module (gnu packages emacs-xyz)
   #:use-module (gnu packages golang-crypto))
 
 (define-public emacs-kaolin-themes
   (package
     (name "emacs-kaolin-themes")
     (version "1.7.4")
     (source
      (origin
        (method git-fetch)
        (uri (git-reference
               (url "https://github.com/ogdenwebb/emacs-kaolin-themes")
               (commit (string-append "v" version))))
        (file-name (git-file-name name version))
        (sha256
         (base32 "1lbqvs2jqvs6x8gj7bali24mw2fl6gk184zln6avy6wmam7n8dqi"))))
     (build-system emacs-build-system)
     (propagated-inputs (list emacs-autothemer))
     (arguments
      '(#:include '("^[^/]*.el$" "^[^/]*.el.in$"
                    "^dir$"
                    "^[^/]*.info$"
                    "^[^/]*.texi$"
                    "^[^/]*.texinfo$"
                    "^doc/dir$"
                    "^doc/[^/]*.info$"
                    "^doc/[^/]*.texi$"
                    "^doc/[^/]*.texinfo$"
                    "^themes/[^/]*.el$")
        #:exclude '("^.dir-locals.el$" "^test.el$" "^tests.el$"
                    "^[^/]*-test.el$" "^[^/]*-tests.el$")))
     (home-page "https://github.com/ogdenwebb/emacs-kaolin-themes")
     (synopsis "A set of eye pleasing themes")
     (description
      "Kaolin is a set of eye pleasing themes for GNU Emacs With support a large number
 of modes and external packages.  Kaolin themes are based on the pallete that was
 originally inspired by Sierra.vim with adding some extra colors. ------- This
 package includes the following themes ------- * kaolin-dark - a dark jade
 variant inspired by Sierra.vim. * kaolin-light - light variant of the original
 kaolin-dark. * kaolin-aurora - Kaolin meets polar lights. * kaolin-bubblegum -
 Kaolin colorful theme with dark blue background. * kaolin-eclipse - a dark
 purple variant. * kaolin-galaxy - bright theme based on one of the Sebastian
 Andaur arts. * kaolin-mono-dark - almost monochrome dark green Kaolin theme. *
 kaolin-mono-light - light variant of monochrome theme. * kaolin-ocean - dark
 blue variant. * kaolin-shiva - theme with autumn colors and melanzane
 background. * kaolin-temple - dark brown background with syntax highlighting
 based on orange and cyan shades. * kaolin-valley-dark - colorful Kaolin theme
 with brown background. * kaolin-valley-light - light version of
 kaolin-valley-dark theme. ------- Configuration example ------- (require
 kaolin-themes) (load-theme kaolin-dark t) ;; Apply treemacs customization for
 Kaolin themes, requires the all-the-icons package. (kaolin-treemacs-theme) ;; Or
 if you have use-package installed (use-package kaolin-themes :config (load-theme
 kaolin-dark t) (kaolin-treemacs-theme)) ;; Custom theme settings ;; The
 following set to t by default (setq kaolin-themes-bold t ; If nil, disable the
 bold style.  kaolin-themes-italic t ; If nil, disable the italic style.
 kaolin-themes-underline t) ; If nil, disable the underline style. ------- Some
 extra theme features, disabled by default ------- ;; If t, use the wave
 underline style instead of regular underline. (setq kaolin-themes-underline-wave
 t) ;; When t, will display colored hl-line style (setq
 kaolin-themes-hl-line-colored t).")
     (license license:gpl3)))
 
 (define-public emacs-gptel-new
   (package
     (name "emacs-gptel-new")
     (version "20260410.711")
     (source
      (origin
        (method git-fetch)
        (uri (git-reference
              (url "https://github.com/karthink/gptel")
              (commit "8d6411b5f89d796c817ff79324973b8910e164fe")))
        (file-name (git-file-name name version))
        (sha256
         (base32 "0zl5qdp9qqh8chadsp2m3jpbpsxlywdlfkax8p97y73q1yias0q6"))))
     (build-system emacs-build-system)
     (propagated-inputs (list emacs-transient emacs-compat))
     (home-page "https://github.com/karthink/gptel")
     (synopsis "Interact with ChatGPT or other LLMs")
     (description
      "gptel is a simple Large Language Model chat client, with support for multiple
 models and backends.  It works in the spirit of Emacs, available at any time and
 in any buffer.  gptel supports: - The services @code{ChatGPT}, Azure, Gemini,
 Anthropic AI, Together.ai, Perplexity, AI/ML API, Anyscale, @code{OpenRouter},
 Groq, @code{PrivateGPT}, @code{DeepSeek}, Cerebras, Github Models, @code{GitHub}
 Copilot chat, AWS Bedrock, Novita AI, @code{xAI}, Sambanova, Mistral Le Chat and
 Kagi (@code{FastGPT} & Summarizer). - Local models via Ollama, Llama.cpp,
 Llamafiles or GPT4All Additionally, any LLM service (local or remote) that
 provides an @code{OpenAI-compatible} API is supported.  Features: - Interact
 with LLMs from anywhere in Emacs (any buffer, shell, minibuffer, wherever). -
 LLM responses are in Markdown or Org markup. - Supports conversations and
 multiple independent sessions. - Supports tool-use to equip LLMs with agentic
 capabilities. - Supports Model Context Protocol (MCP) integration using the
 mcp.el package. - Supports multi-modal models (send images, documents). -
 Supports \"reasoning\" content in LLM responses. - Save chats as regular
 Markdown/Org/Text files and resume them later. - You can go back and edit your
 previous prompts or LLM responses when continuing a conversation.  These will be
 fed back to the model. - Redirect prompts and responses easily - Rewrite,
 refactor or fill in regions in buffers. - Write your own commands for custom
 tasks with a simple API. Requirements for @code{ChatGPT}, Azure, Gemini or Kagi:
 - You need an appropriate API key.  Set the variable `gptel-api-key to the key
 or to a function of no arguments that returns the key. (It tries to use
 `auth-source by default) @code{ChatGPT} is configured out of the box.  For the
 other sources: - For Azure: define a gptel-backend with `gptel-make-azure'. -
 For Gemini: define a gptel-backend with `gptel-make-gemini'. - For Anthropic
 (Claude): define a gptel-backend with `gptel-make-anthropic'. - For AI/ML API,
 Together.ai, Anyscale, Groq, @code{OpenRouter}, @code{DeepSeek}, Cerebras or
 Github Models: define a gptel-backend with `gptel-make-openai'. - For
 @code{PrivateGPT}: define a backend with `gptel-make-privategpt'. - For
 Perplexity: define a backend with `gptel-make-perplexity'. - For Deepseek:
 define a backend with `gptel-make-deepseek'. - For Kagi: define a gptel-backend
 with `gptel-make-kagi'.  For local models using Ollama, Llama.cpp or GPT4All: -
 The model has to be running on an accessible address (or localhost) - Define a
 gptel-backend with `gptel-make-ollama or `gptel-make-gpt4all'. - Llama.cpp or
 Llamafiles: Define a gptel-backend with `gptel-make-openai'.  Consult the
 package README for examples and more help with configuring backends.  Usage:
 gptel can be used in any buffer or in a dedicated chat buffer.  The interaction
 model is simple: Type in a query and the response will be inserted below.  You
 can continue the conversation by typing below the response.  To use this in any
 buffer: - Call `gptel-send to send the buffer's text up to the cursor.  Select a
 region to send only the region. - You can select previous prompts and responses
 to continue the conversation. - Call `gptel-send with a prefix argument to
 access a menu where you can set your backend, model and other parameters, or to
 redirect the prompt/response.  To use this in a dedicated buffer: - M-x gptel:
 Start a chat session. - In the chat session: Press `C-c RET (`gptel-send') to
 send your prompt.  Use a prefix argument (`C-u C-c RET') to access a menu.  In
 this menu you can set chat parameters like the system directives, active backend
 or model, or choose to redirect the input or output elsewhere (such as to the
 kill ring or the echo area). - You can save this buffer to a file.  When opening
 this file, turn on `gptel-mode before editing it to restore the conversation
 state and continue chatting. - To include media files with your request, you can
 add them to the context (described next), or include them as links in Org or
 Markdown mode chat buffers.  Sending media is disabled by default, you can turn
 it on globally via `gptel-track-media', or locally in a chat buffer via the
 header line.  Include more context with requests: If you want to provide the LLM
 with more context, you can add arbitrary regions, buffers, files or directories
 to the query with `gptel-add'.  To add text or media files, call `gptel-add in
 Dired or use the dedicated `gptel-add-file'.  You can also add context from
 gptel's menu instead (`gptel-send with a prefix arg), as well as examine or
 modify context.  When context is available, gptel will include it with each LLM
 query.  LLM Tool use: gptel supports \"tool calling\" behavior, where LLMs can
 specify arguments with which to call provided \"tools\" (elisp functions).  The
 results of running the tools are fed back to the LLM, giving it capabilities and
 knowledge beyond what is available out of the box.  For example, tools can
 perform web searches or API lookups, modify files and directories, and so on.
 Tools can be specified via `gptel-make-tool', or obtained from other
 repositories, or from Model Context Protocol (MCP) servers using the mcp.el
 package.  See the README for details.  Tools can be included with LLM queries
 using gptel's menu, or from `gptel-tools'.  Rewrite interface In any buffer:
 with a region selected, you can rewrite prose, refactor code or fill in the
 region.  This is accessible via `gptel-rewrite', and also from the `gptel-send
 menu.  Presets Define a bundle of configuration (model, backend, system message,
 tools etc) as a \"preset\" that can be applied together, making it easy to switch
 between tasks in gptel.  Presets can be saved and applied from gptel's transient
 menu.  You can also include a cookie of the form \"@@preset-name\" in the prompt
 to send a request with a preset applied.  This feature works everywhere, but
 preset cookies are also fontified in chat buffers.  gptel in Org mode: gptel
 offers a few extra conveniences in Org mode: - You can limit the conversation
 context to an Org heading with `gptel-org-set-topic'. - You can have branching
 conversations in Org mode, where each hierarchical outline path through the
 document is a separate conversation branch.  See the variable
 `gptel-org-branching-context'. - You can declare the gptel model, backend,
 temperature, system message and other parameters as Org properties with the
 command `gptel-org-set-properties'.  gptel queries under the corresponding
 heading will always use these settings, allowing you to create mostly
 reproducible LLM chat notebooks.  Finally, gptel offers a general purpose API
 for writing LLM ineractions that suit your workflow.  See `gptel-request', and
 `gptel-fsm for more advanced usage.")
     (license license:gpl3)))
 
 (define-public emacs-kasi
   (package
     (name "emacs-kasi")
     (version "1.2")
     (source
      (origin
        (method git-fetch)
        (uri (git-reference
               (url "https://git.vineetk.net/kasi.el")
               (commit (string-append "v" version))))
        (file-name (git-file-name name version))
        (sha256
         (base32 "1fkwq6rg24f5rjbmpyq095msxphb9mkmxg8sh15vr3l50qckvdq5"))))
     (build-system emacs-build-system)
     (propagated-inputs (list age))
     (arguments
      '(#:include '("^[^/]*.el$")
        #:exclude '("^[^/]*.sh$")))
     (home-page "https://git.vineetk.net/kasi.el")
     (synopsis "cryptography-agnostic emacs secrets manager")
     (description "This package provides an easy way to manage secrets via M-x kasi.")
     (license license:gpl3)))
 
 (define-public emacs-llm-tools
   (package
    (name "emacs-llm-tools")
    (version "1.1")
    (source
     (origin
      (method git-fetch)
      (uri (git-reference
 	   (url "https://git.vineetk.net/llm-tools.el")
 	   (commit (string-append "v" version))))
      (file-name (git-file-name name version))
      (sha256
       (base32 "0zsbrq5syqr35xnlpk6wddjvhy6kcrhdzn67xnba5m3h73zydznx"))))
    (build-system emacs-build-system)
    (inputs (list emacs-gptel-new
 		 emacs-magit))
    (arguments
     '(#:include '("^[^/]*.el$")
       #:exclude '("^[^/]*.sh$")))
    (home-page "https://git.vineetk.net/kasi.el")
    (synopsis "cryptography-agnostic emacs secrets manager")
    (description "This package provides an easy way to manage secrets via M-x kasi.")
    (license license:gpl3)))