Note

This repo was forked from bascodes/copilot-ollama

🎯 Problem

OpenRouter provides access to various AI models from OpenAI, Anthropic, and others. However, GitHub Copilot's Agent Mode requires models to support function calling/tools, but OpenRouter's API doesn't announce tool support for its models.

This prevents using powerful models like Claude, GPT-4, and others through OpenRouter with Copilot's advanced Agent Mode features.

✨ Solution

copilot-ollama creates a local proxy chain that:

• 🔄 Forwards requests to OpenRouter while preserving tool support
• 🛠️ Makes OpenRouter models compatible with Copilot's Ollama integration
• 🚀 Enables Agent Mode with any OpenRouter model
• 🔧 Uses LiteLLM for OpenAI-compatible proxying
• 🔗 Uses oai2ollama for Ollama compatibility

🚀 Quick Start

Prerequisites

• OpenRouter API key (get one here)
• VSCode with GitHub Copilot extension

Installation & Setup

1. Set your OpenRouter API key

   [System.Environment]::SetEnvironmentVariable('OPENROUTER_API_KEY','your-openrouter-api-key-here', 'User')
   

2. Create a config file Checkout config.yaml as an example.

3. Start copilot-ollama-windows

   uvx copilot-ollama-windows your-config-file.yaml
   

4. Configure VSCode

   • Open VSCode settings
   • Set github.copilot.chat.byok.ollamaEndpoint to http://localhost:11434
   • Click "Manage Models" → Select "Ollama"

5. Start coding! 🎉 Your OpenRouter models are now available in Copilot Agent Mode.

⚙️ Configuration

Adding Models

Edit your config.yaml to add or modify available models:

# This section defines the models that your local proxy will advertise
model_list:
  - model_name: kimi-k2  # Name that appears in VSCode
    litellm_params:
      model: openrouter/moonshotai/kimi-k2  # Actual OpenRouter model

  - model_name: claude-3-sonnet
    litellm_params:
      model: openrouter/anthropic/claude-3-sonnet

  - model_name: gpt-4-turbo
    litellm_params:
      model: openrouter/openai/gpt-4-turbo

Popular OpenRouter Models

Here are some recommended models to add:

🔧 How It Works

graph LR
    A[VSCode Copilot] --> B[oai2ollama<br/>:11434]
    B --> C[LiteLLM Proxy<br/>:4000]
    C --> D[OpenRouter API]
    D --> E[AI Models<br/>Claude, GPT-4, etc.]

1. VSCode Copilot sends requests to what it thinks is an Ollama server
2. oai2ollama translates Ollama API calls to OpenAI format
3. LiteLLM proxies OpenAI-compatible requests to OpenRouter
4. OpenRouter routes to the actual AI model providers
5. Tool/function calling capabilities are preserved throughout the chain

🤝 Contributing

We welcome contributions! Here's how you can help:

• 🐛 Report bugs by opening an issue
• 💡 Suggest features or improvements
• 📖 Improve documentation
• 🔧 Submit pull requests

Development Setup

# Clone the repo
git clone https://github.com/jm6271/copilot-ollama-windows.git
cd copilot-ollama-windows

# Install dependencies
uv sync

# Make your changes and test
[System.Environment]::SetEnvironmentVariable('OPENROUTER_API_KEY','your-openrouter-api-key-here', 'User')
uv run copilot-ollama-windows your-config-file.yaml

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• LiteLLM for the excellent proxy framework
• oai2ollama for Ollama compatibility
• OpenRouter for model access
• copilot-ollama for the original project
• The VSCode and GitHub Copilot teams