init.vim

A comprehensive Neovim configuration that transforms your editor into a full-featured IDE with intelligent code assistance, seamless Git integration, and powerful language tools for Data Science, AI Engineering, and Backend development.

Development Environments

• GitHub Copilot with Copilot Chat integration
• Local LLM assistance with Ollama integration

Python (Data Science/AI)

• Full LSP support via Jedi Language Server
• Automatic linting and formatting with Ruff
• IPython integration with cell-based execution
• Jupyter notebook support with automatic conversion

Zig (Systems programming)

• Zig Language Server (ZLS) integration
• Real-time error checking with zig compiler
• Automatic code formatting with zig fmt
• Smart completion and diagnostic messages

Deno (TS/JS backend dev./Data Science/AI)

• Advanced LSP features for modern JavaScript/TypeScript
• Built-in linting and formatting

Julia (Data Science/AI)

• Full language server support with hover documentation
• Snippet completion and intelligent code assistance
• JuliaFormatter integration for code formatting
• REPL integration via vim-slime

Container & Infrastructure

• Containerfile/Dockerfile LSP support
• Shell script (Bash/Zsh) language server

Documentation & Data

• Markdown LSP with preview via markdown-preview.nvim
• Built-in spell checking
• Text-to-speech capabilities via Piper
• CSV viewing and editing with csvview.nvim
• Note-taking with journal.nvim

Key Bindings

• <leader> = <space>
• <localleader> = ,

Development

• LSP hover: K
• Definition: gd
• References: gr
• Code actions: <leader>ca
• Format file: <leader>==
• Format JSON: <leader>j

Navigation

• Find files: <leader>f
• Find keymappings: <leader>k
• Previous/next cell: [c / ]c

IPython

• Send cell: <localleader>c
• Send line: <localleader>l
• Send selection: <localleader>v (in visual mode)

Git

• Diff view: <leader>gd
• Merge conflicts: <leader>gm
• Stage hunk: <leader>hs
• Preview hunk: <leader>hp
• Conflict resolution: <leader>go/gt/gb (ours/theirs/both)

AI Assistance

• Copilot Chat: <leader>cp
• Toggle Chat: <leader>cpt
• Fix diagnostic: <leader>cpf
• Explain code: <leader>cpe
• Start Ollama Server: <leader>os
• Stop Ollama Server: <leader>ox
• Trigger Ollama completion: <C-x><C-o> (insert mode)

Requirements

• Neovim
• git
• node.js (for copilot.vim)
• ollama (for local LLM capabilities)
• ripgrep for global search (optional)
• Deno (TS/JS development)
• Zig (Systems programming)
• Python with uv (optionally, Jupyter for notebook support)
• IPython for Python REPL-driven development
• Julia
• Piper (for text-to-speech, previously rhasspy/piper)
• Voice model for text-to-speech capabilities

Installation

1. Backup your existing config:

mv ~/.config/nvim ~/.config/nvim.backup # Backup your current setup
# Cleanup old configuration artefacts
rm -r ~/.local/share/nvim
rm -r ~/.local/state/nvim
rm -r ~/.cache/nvim

2. Install Vim-plug

curl -fLo ~/.local/share/nvim/site/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

3. Clone this config:

git clone https://github.com/ai-mindset/init.vim ~/.config/nvim

4. Start Neovim:

nvim --headless +PlugInstall +qall # Only required on first start, to install plugins

Ollama Setup

For local LLM capabilities, you need to install and set up Ollama:

# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# Start the Ollama server
ollama serve

# In another terminal, pull the mistral model
ollama pull mistral

You can also start and stop the Ollama server directly from Neovim using:

• <leader>os - Start Ollama Server
• <leader>ox - Stop Ollama Server

Piper TTS Setup

For text-to-speech capabilities, install Piper using uv (a faster, more reliable Python package installer):

# Install uv if you don't have it already
curl -fsSL https://astral.sh/uv/install.sh | bash

# Install Piper using uv
uv pip install piper-tts

# Download a voice model
mkdir -p ~/.local/share/piper-voices/
# You can choose any voice model from https://huggingface.co/rhasspy/piper-voices/
# For example:
wget -P ~/.local/share/piper-voices/ https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_GB/alba/medium/en_GB-alba-medium.onnx

Use text-to-speech in Neovim with these commands:

• <space>tw - Speak Word
• <space>tc - Speak Current Line
• <space>tp - Speak Current Paragraph
• <space>tf - Speak Current File
• <space>tv - Speak Visual Selection

Julia Setup

For full Julia language support, set up your environment with these steps:

# Install juliaup (cross-platform Julia version manager)
curl -fsSL https://install.julialang.org | sh

# Add Julia and set as default (v1.12 is the latest stable release at the time of writing)
juliaup add 1.12  # Replace with your version
juliaup default 1.12  # Replace with your version

# Install required packages in the global environment
julia --project=~/.julia/environments/v1.12 -e '
    using Pkg;
    Pkg.add(["LanguageServer", "SymbolServer", "StaticLint", "JuliaFormatter"]);
    Pkg.precompile()
'

Note: v1.12 is used in this example as it's the latest stable version at the time of writing. Replace with whichever version you have installed.

Customisation

• LSP servers: Modify ensure_installed in the Mason setup (Python, Zig, Deno, JSON, YAML, etc.)
• Colour scheme: Change colorscheme catppuccin to your preferred theme
• Formatters: Adjust formatters_by_ft in the conform.nvim setup
• Keybindings: Modify the which-key configuration
• CSV view: Customize the csvview.nvim configuration

Tagbar Setup

Zig & TypeScript Tagbar Setup

For Exuberant Ctags (default in many distros), a .ctags file is provided in this repo with support for:

• Zig (functions, structs, enums, unions, constants, variables, tests)
• TypeScript (classes, modules, functions, interfaces, etc.)

Save the file in $HOME/.ctags. Press <F8> to toggle Tagbar for code navigation in supported languages.

Both Zig and TypeScript support requires the language patterns in .ctags. The configuration is already included in this repo.