<img src="https://github.com/Kurama622/screenshot/raw/master/llm/logo.png" alt="llm.nvim" width="300"> <a href="README.md">English</a> | <a href="README_CN.md">简体中文</a>

[!IMPORTANT] A large language model(LLM) plugin that allows you to interact with LLM in Neovim.

Supports any LLM, such as GPT, GLM, Kimi, DeepSeek, Gemini, Qwen or local LLMs (such as ollama).

Allows you to define your own AI tools, with different tools able to use different models.

Most importantly, you can use free models provided by any platform (such as Copilot, GitHub models, SiliconFlow, openrouter, Cloudflare or other platforms).

[!NOTE] The configurations of different LLMs (such as ollama, deepseek), UI configurations, and AI tools (including code completion) should be checked in the examples first. Here you will find most of the information you want to know. Additionally, before using the plugin, you should ensure that your LLM_KEY is valid and that the environment variable is in effect.

Additionally, you should also take a look at wiki and docs.

Screenshots
Installation
Configuration
TODO List
Author's configuration
Acknowledgments
- Special thanks

Screenshots

Chat

models | UI

Press ? can display the shortcut key help window

Float-UI

Split-UI

Quick Translation

enable_cword_context = true: Translate the text under the cursor in normal mode.

Explain Code

Streaming output | Non-streaming output

Ask

One-time, no history retained.

You can configure inline_assistant to decide whether to display diffs (default: show by pressing 'd').

Attach To Chat

You can configure inline_assistant to decide whether to display diffs (default: show by pressing 'd').

Optimize Code

Display side by side

Display in the form of a diff

Generate Test Cases

AI Translation

Image Recognition

Generate Git Commit Message

Generate Doc String

Web Search

/buffer | /file | @web_search

Diagnostic

Both disposable_ask_handler, attach_to_chat_handler, side_by_side_handler and action_handler can enable diagnostic features:

diagnostic = { min = vim.diagnostic.severity.HINT },
-- or
-- diagnostic = { vim.diagnostic.severity.WARN, vim.diagnostic.severity.ERROR },
-- see `:h diagnostic-severity`

Lsp

[!NOTE] New features, still in continuous iteration.

Both disposable_ask_handler, attach_to_chat_handler, and action_handler can enable lsp features:

lsp = {
  cpp = { methods = { "definition", "declaration" } },
  python = { methods = { "definition" } },
  lua = { methods = { "definition", "declaration" } },

  root_dir = { {'pyproject.toml', 'setup.py' }, ".git" },
},

⬆ back to top

Installation

Dependencies

curl
fzf >= 0.37.0: Optional. Split style preview of session history and image recognition tool image selection depends on fzf(The author's development environment is 0.39.0)
render-markdown.nvim: Optional. Better Markdown preview depends on this plugin.

{
    "MeanderingProgrammer/render-markdown.nvim",
    dependencies = {
      {
        "nvim-treesitter/nvim-treesitter",
        branch = "main",
        config = function()
          vim.api.nvim_create_autocmd("FileType", {
            pattern = { "llm", "markdown" },
            callback = function()
              vim.treesitter.start(0, "markdown")
            end,
          })
        end,
      },
      "nvim-mini/mini.icons",
    }, -- if you use standalone mini plugins
    ft = { "markdown", "llm" },

    config = function()
      require("render-markdown").setup({
        restart_highlighter = true,
        heading = {
          enabled = true,
          sign = false,
          position = "overlay", -- inline | overlay
          icons = { "󰎤 ", "󰎧 ", "󰎪 ", "󰎭 ", "󰎱 ", "󰎳 " },
          signs = { "󰫎 " },
          width = "block",
          left_margin = 0,
          left_pad = 0,
          right_pad = 0,
          min_width = 0,
          border = false,
          border_virtual = false,
          border_prefix = false,
          above = "▄",
          below = "▀",
          backgrounds = {},
          foregrounds = {
            "RenderMarkdownH1",
            "RenderMarkdownH2",
            "RenderMarkdownH3",
            "RenderMarkdownH4",
            "RenderMarkdownH5",
            "RenderMarkdownH6",
          },
        },
        dash = {
          enabled = true,
          icon = "─",
          width = 0.5,
          left_margin = 0.5,
          highlight = "RenderMarkdownDash",
        },
        code = { style = "normal" },
      })
    end,
  }

Preconditions

Register on the official website and obtain your API Key (Cloudflare needs to obtain an additional account).
Set the LLM_KEY (Cloudflare needs to set an additional `ACCOUNT

Llm.nvim

Install / Use

README

Contents