ollama-copilot：使用本地 Ollama 模型替代 GitHub Copilot

ollama-copilot 是一个开源代理工具，可以将本地 Ollama 模型作为 GitHub Copilot 的免费替代方案。该项目由 ethanrous 维护（forked from bernardo-bruning），支持 Neovim 和 VSCode，实现完全本地化的 AI 代码补全。

项目简介

ollama-copilot 是一个用 Go 语言编写的代理服务，它充当 Ollama 本地模型与 IDE 之间的桥梁。通过拦截 GitHub Copilot 的 API 请求并将其转发到本地运行的 Ollama 实例，开发者可以在不依赖云端服务的情况下享受 AI 代码补全功能。

该项目在 GitHub 上使用 MIT 许可证开源，主要使用 Go 语言（100%）编写。

核心特性

• 完全本地化：所有代码补全都在本地运行，无需将代码发送到云端
• GitHub Copilot 兼容：作为 Copilot API 的代理，兼容现有 Copilot 插件
• 多 IDE 支持：支持 Neovim 和 VSCode 等主流编辑器
• 灵活配置：支持自定义模型配置（默认使用 codellama:code）
• HTTP 代理支持：内置 HTTP 代理功能，便于网络环境配置
• 开源免费：MIT 许可证，完全免费使用

技术栈

• Go：后端代理服务，100% Go 语言实现
• Ollama：本地大语言模型运行环境
• CodeLlama：默认使用的代码生成模型

安装指南

前置要求

• 已安装 Ollama
• Go 环境（用于从源码安装）

安装 Ollama

# 使用官方安装脚本
curl -fsSL https://ollama.com/install.sh | sh

或参考 手动安装指南。

拉取模型

# 下载默认模型（codellama:code）
ollama pull codellama:code

安装 ollama-copilot

# 使用 go install 安装
go install github.com/bernardo-bruning/ollama-copilot@latest

配置环境变量

确保 $PATH 包含 $HOME/go/bin 或 $GOPATH/bin，在 ~/.bashrc 或 ~/.zshrc 中添加：

export PATH="$HOME/go/bin:$GOPATH/bin:$PATH"

快速开始

启动服务

ollama-copilot

服务默认在以下端口运行：

• localhost:11435 - HTTP 代理端口
• localhost:11437 - Copilot API 代理端口

IDE 配置

Neovim 配置

1. 安装 copilot.vim 插件
2. 在配置中添加以下变量：

let g:copilot_proxy = 'http://localhost:11435'
let g:copilot_proxy_strict_ssl = v:false

VSCode 配置

1. 安装 GitHub Copilot 扩展
2. 登录或注册 GitHub 账号
3. 打开 VSCode 设置，添加以下配置：

{
  "github.copilot.advanced": {
    "debug.overrideProxyUrl": "http://localhost:11437"
  },
  "http.proxy": "http://localhost:11435",
  "http.proxyStrictSSL": false
}

项目 Roadmap

• 启用 completions API 使用（Fill in the Middle 支持）
• 灵活配置模型（当前仅支持 codellama:code）
• 创建自安装功能
• Windows 安装支持
• 使用文档完善

项目链接

• GitHub 仓库：ethanrous/ollama-copilot
• 原始仓库：bernardo-bruning/ollama-copilot
• 许可证：MIT License