GNU ELPA - ellama

Ask Ellama about something by entering a prompt in an interactive buffer and continue conversation. If called with universal argument (C-u) will start new session with llm model interactive selection.

This command allows you to generate text using an LLM. When called interactively, it prompts for an instruction that is then used to generate text based on the context. If a region is active, the selected text is added to the context before generating the response.

Send last user message extracted from current ellama chat buffer.

Ask Ellama about a selected region or the current buffer.

Send selected region or current buffer to ellama chat.

Send current line to ellama chat.

Complete text in current buffer with ellama.

Ask Ellama to translate a selected region or word at the point.

Translate current buffer.

Find the definition of the current word using Ellama.

Summarize a selected region or the current buffer using Ellama.

Summarize text from the kill ring.

Review code in a selected region or the current buffer using Ellama.

Change text in a selected region or the current buffer according to a provided change.

Create a markdown list from the active region or the current buffer using Ellama.

Create a markdown table from the active region or the current buffer using Ellama.

Summarize a webpage fetched from a URL using Ellama.

Select ellama provider.

Complete selected code or code in the current buffer according to a provided change using Ellama.

Generate and insert new code based on description. This function prompts the user to describe the code they want to generate. If a region is active, it includes the selected text as context for code generation.

Change selected code or code in the current buffer according to a provided change using Ellama.

Change selected code or code in the current buffer according to a provided change using Ellama.

Generate commit message based on diff.

Proofread selected text.

Enhance the wording in the currently selected region or buffer using Ellama.

Enhance the grammar and spelling in the currently selected region or buffer using Ellama.

Make the text of the currently selected region or buffer concise and simple using Ellama.

Render the currently selected text or the text in the current buffer as a specified format using Ellama.

Load ellama session from file.

Delete ellama session.

Change current active session.

Select and kill one of active sessions.

Rename current ellama session.

Add file to context.

Add all files in directory to the context.

Add buffer to context.

Add selected region to context.

Add info node to context.

Clear global context.

Manage the global context. Inside context management buffer you can see ellama context elements. Availible actions with key bindings:

• n: Move to the next line.
• p: Move to the previous line.
• q: Quit the window.
• g: Update context management buffer.
• a: Open the transient context menu for adding new elements.
• d: Remove the context element at the current point.
• RET: Preview the context element at the current point.

Preview ellama context element at point. Works inside ellama context management buffer.

Remove ellama context element at point from global context. Works inside ellama context management buffer.

Chat translation enable.

Chat translation disable.

Solve reasoning problem with Abstraction of Thought technique. It uses a chain of multiple messages to LLM and help it to provide much better answers on reasoning problems. Even small LLMs like phi3-mini provides much better results on reasoning tasks using AoT.

Solve domain specific problem with simple chain. It makes LLMs act like a professional and adds a planning step.

Select a prompt from the community prompt collection. The user is prompted to choose a role, and then a corresponding prompt is inserted into a blueprint buffer.

Prompt user for values of variables found in current buffer and update them.

Description: Toggle the Ellama Context header line mode. This minor mode updates the header line to display context-specific information.

Usage: To enable or disable ellama-context-header-line-mode, use the command:

M-x ellama-context-header-line-mode

When enabled, this mode adds a hook to window-state-change-hook to update the header line whenever the window state changes. It also calls ellama-context-update-header-line to initialize the header line with context-specific information.

When disabled, it removes the evaluation of (:eval (ellama-context-line)) from header-line-format.

Description: Globalized version of ellama-context-header-line-mode. This mode ensures that ellama-context-header-line-mode is enabled in all buffers.

Usage: To enable or disable ellama-context-header-line-global-mode, use the command:

M-x ellama-context-header-line-global-mode

This globalized minor mode provides a convenient way to ensure that context-specific header line information is always available, regardless of the buffer being edited.

Description: Toggle the Ellama Context mode line mode. This minor mode updates the mode line to display context-specific information.

Usage: To enable or disable ellama-context-mode-line-mode, use the command:

M-x ellama-context-mode-line-mode

When enabled, this mode adds a hook to window-state-change-hook to update the mode line whenever the window state changes. It also calls ellama-context-update-mode-line to initialize the mode line with context-specific information.

When disabled, it removes the evaluation of (:eval (ellama-context-line)) from mode-line-format.

Description: Globalized version of ellama-context-mode-line-mode. This mode ensures that ellama-context-mode-line-mode is enabled in all buffers.

Usage: To enable or disable ellama-context-mode-line-global-mode, use the command:

M-x ellama-context-mode-line-global-mode

This globalized minor mode provides a convenient way to ensure that context-specific mode line information is always available, regardless of the buffer being edited.

1. Act: This is the primary identifier for a blueprint, representing the

action or purpose of the blueprint.

1. Prompt: The content that will be used to initiate the chat session. This

can include instructions, context, or any other relevant information needed to guide the conversation.

1. For Developers: A flag indicating whether the blueprint is intended for

developers.

Ellama provides several functions to create, select, and manage blueprints:

• ellama-blueprint-create: This function allows users to create a new blueprint from the current buffer. It prompts for a name and whether the blueprint is for developers, then saves the content of the current buffer as the prompt.
• ellama-blueprint-new: This function creates a new buffer for a blueprint, optionally inserting the content of the current region if active.
• ellama-blueprint-select: This function allows users to select a prompt from the collection of blueprints. It filters prompts based on whether they are for developers and their source (user-defined, community, or all).

Blueprints can include variables that need to be filled before running the chat session. Ellama provides command to fill these variables:

• ellama-blueprint-fill-variables: Prompts the user to enter values for variables found in the current buffer and fills them.

Ellama provides a local keymap ellama-blueprint-mode-map for managing blueprints within buffers. The mode includes key bindings for sending the buffer to a new chat session, killing the current buffer, creating a new blueprint, and filling variables.

The ellama-blueprint-mode is a derived mode from text-mode, providing syntax highlighting for variables in curly braces and setting up the local keymap.

When in ellama-blueprint-mode, the following keybindings are available:

• C-c C-c: Send current buffer to a new chat session and kill the current buffer.
• C-c C-k: Kill the current buffer.
• C-c c: Create a blueprint from the current buffer.
• C-c v: Fill variables in the current blueprint.

Ellama includes transient menus for easy access to blueprint commands. The ellama-transient-blueprint-menu provides options for chatting with a selected blueprint, creating a new blueprint, and quitting the menu.

The ellama-transient-main-menu integrates the blueprint menu into the main menu, providing a comprehensive interface for all Ellama commands.

The ellama-blueprint-run function initiates a chat session using a specified blueprint. It pre-fills variables based on the provided arguments.

(defun my-chat-with-morpheus ()
  "Start chat with Morpheus."
  (interactive)
  (ellama-blueprint-run "Character" '(:character "Morpheus" :series "Matrix")))

(global-set-key (kbd "C-c e M") #'my-chat-with-morpheus)