How to install avante.nvim with lazy.nvim?

Use the Lua snippet in the README, ensuring to set the build command and dependencies like plenary.nvim and nui.nvim. Configure API keys via environment variables such as AVANTE_ANTHROPIC_API_KEY for your chosen provider.

avante.nvim vs Cursor IDE: which is better for Neovim users?

avante.nvim is ideal for Neovim users who want AI features without leaving their editor, offering customization and Vim workflows. Cursor provides a polished, standalone IDE with less setup but less control. Choose based on preference for integration versus convenience.

Can avante.nvim work with local AI models like Ollama?

Yes, it supports Ollama as a first-class provider by setting provider to 'ollama' and configuring the model in the providers section. You need to ensure Ollama is running and accessible.

How to set up project-specific instructions in avante.nvim?

Create an avante.md file in your project root with sections like 'your role' and 'your mission', following the structure in the README. This file is automatically referenced to guide AI behavior during interactions.

What are common troubleshooting steps for API key issues in avante.nvim?

Ensure environment variables are set correctly, using scoped keys like AVANTE_ANTHROPIC_API_KEY. Check provider configuration in your Neovim setup and verify API endpoints are accessible. The README includes detailed examples for different providers.

How to use Zen mode in avante.nvim?

Alias the command as shown in the README (e.g., alias avante='nvim -c "lua require(\"avante.api\").zen_mode()"') to run a CLI-like interface. This retains Neovim functionality for AI interactions while mimicking a coding agent CLI.

Open-Awesome

avante.nvim

Apache-2.0Luav0.0.27

A Neovim plugin that emulates Cursor AI IDE's behavior, providing AI-powered code suggestions and one-click application.

GitHub

17.8k stars814 forks0 contributors

What is avante.nvim?

avante.nvim is a Neovim plugin that emulates the AI-powered features of Cursor IDE, allowing developers to get AI-driven code suggestions and apply them directly within Neovim. It solves the problem of context switching between traditional editors and AI coding assistants by integrating AI capabilities directly into the Neovim workflow.

Target Audience

Neovim users who want AI-assisted coding features similar to Cursor IDE without leaving their preferred editor, particularly developers who value keyboard-driven workflows and extensibility.

Value Proposition

Developers choose avante.nvim because it brings modern AI coding assistance into Neovim's highly customizable environment, offering one-click code application, project-specific AI instructions, and the ability to use familiar Vim motions and plugins while working with AI.

Overview

Use your Neovim like using Cursor AI IDE!

Use Cases

Best For

Neovim users wanting Cursor-like AI features in their editor
Applying AI code suggestions directly to source files with minimal effort
Customizing AI behavior per project with instruction files
Using AI coding assistants while maintaining Vim keybindings and workflows
Integrating multiple AI providers (Claude, OpenAI, Gemini) into Neovim
Self-hosting AI coding assistance without proprietary IDE dependencies

Not Ideal For

Teams using Neovim versions below 0.10.1 that require AI coding assistance
Projects needing out-of-the-box, stable AI tools without configuration overhead or breaking changes
Developers who prefer cloud-based AI IDEs with minimal setup, like Cursor's hosted service
Environments without internet access or API key management for external AI providers

Pros & Cons

Pros

Deep Neovim Integration

Zen Mode maintains Vim keybindings and plugin ecosystem, allowing muscle-memory operations while leveraging AI, as highlighted in the README's philosophy of enhancing workflow.

Customizable AI Behavior

Supports avante.md files for project-specific instructions, enabling tailored AI responses based on context, with detailed examples and best practices provided.

Multi-Provider Flexibility

Configurable with various AI providers like Claude, OpenAI, and Gemini, including ACP support for enhanced agent interactions, offering choice and redundancy.

Direct Code Application

Features one-click application of AI suggestions with Fast Apply for instant edits, streamlining the editing process as a core feature.

Cons

Setup Complexity

Requires installing multiple dependencies, setting API keys, and configuring external tools like Docker for RAG service, which can be daunting for new users.

Developmental Instability

The project is in rapid iteration phase with warnings about rough edges and significant changes, leading to potential bugs and breaking changes.

Heavy External Dependencies

Relies on external AI services, optional plugins, and tools like Docker, increasing maintenance and potential points of failure.

Open Source Alternative To

avante.nvim is an open-source alternative to the following products:

Cursor

Cursor is an AI-powered code editor built on VS Code, designed to enhance developer productivity with features like AI-assisted coding, code generation, and intelligent autocomplete.

Frequently Asked Questions

Related Projects

codecompanion.nvim

✨ AI Coding, Vim Style

Stars6,482

Forks406

Last commit2 days ago

ChatGPT.nvim

ChatGPT Neovim Plugin: Effortless Natural Language Generation with OpenAI's ChatGPT API

Stars4,003

Forks324

Last commit3 months ago

CopilotChat.nvim

Chat with GitHub Copilot in Neovim

Stars3,625

Forks170

Last commit7 days ago

opencode.nvim

Integrate Neovim and OpenCode AI to stay in your flow.

Stars3,242

Forks115

Last commit8 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub