OpenKilo

Access 40+ free AI models through Kilo Gateway. Zero-config, no API key required for free models.

Installation

🤖 Let an LLM do it (Recommended)

Paste this into any LLM agent (OpenCode, Claude Code, Cursor, etc.):

Install the openkilo plugin by following: https://raw.githubusercontent.com/AnganSamadder/openkilo/main/README.md

To install this plugin, please perform the following steps for the user:

1. Install the NPM package globally:

   npm install -g openkilo

   Note: This plugin requires no additional setup - free models work instantly.

2. Configure OpenCode: Add "openkilo" to the plugin array in the user's config file (usually ~/.config/opencode/opencode.json).

   {
     "plugin": [
       "openkilo"
     ]
   }

3. Verify & Finalize:

   • Tell the user: "Installation complete! Restart OpenCode and select any model under the 'OpenKilo' provider to start using free AI models instantly."

👤 For Humans (Manual)

1. Install via NPM:

   npm install -g openkilo

2. Enable the Plugin: Add "openkilo" to your ~/.config/opencode/opencode.json:

   {
     "plugin": [
       "openkilo"
     ]
   }

3. Use Free Models: Restart OpenCode and select any model under the OpenKilo provider. No API key needed!

✨ Features

• Zero-config free models: 40+ free models available instantly without authentication
• Kilo Gateway: Uses Kilo's free OpenRouter-compatible gateway at api.kilo.ai
• Dual authentication: OAuth browser flow or API key for 350+ paid models
• Auto-refresh: Model registry updates automatically on OpenCode startup
• Simple tools: /kilo_login, /kilo_logout, /kilo_status, /kilo_models, /kilo_refresh

🎯 Available Free Models

| Model | Context | Output | Description | |-------|---------|--------|-------------| | z-ai/glm-5:free | 202K | 131K | Z.AI's flagship model for complex systems | | deepseek/deepseek-r1-0528:free | 164K | 164K | DeepSeek R1 reasoning model | | meta-llama/llama-3.3-70b-instruct:free | 128K | 128K | Meta Llama 3.3 70B | | qwen/qwen3-coder:free | 262K | 262K | Qwen3 Coder 480B | | minimax/minimax-m2.5:free | 205K | 131K | MiniMax M2.5 | | google/gemma-3-27b-it:free | 131K | 8K | Google Gemma 3 27B | | mistralai/mistral-small-3.1-24b-instruct:free | 128K | 8K | Mistral Small 3.1 |

And 30+ more free models!

🔐 Authentication (For Paid Models)

To access 350+ paid models, authenticate with Kilo:

/kilo_login

This opens a browser for OAuth authentication. Alternatively, use an API key:

/kilo_login --method api-key --api-key YOUR_KEY

🛠️ Available Tools

| Tool | Description | |------|-------------| | kilo_login | Authenticate with Kilo (OAuth or API key) | | kilo_logout | Clear stored credentials | | kilo_status | Check authentication status | | kilo_refresh | Force refresh model registry | | kilo_models | List available models |

⚙️ Configuration

| File | Purpose | |------|---------| | ~/.config/openkilo/auth.json | Stored credentials | | ~/.cache/openkilo/gateway-models.json | Model registry cache |

❓ Troubleshooting

Models Not Showing

1. Check OpenCode config has "openkilo" in the plugin array
2. Restart OpenCode
3. Run /kilo_refresh to force refresh the model registry

Free Models Not Working

• Free models should work without any API key
• The plugin uses apiKey: "anonymous" for free access
• If you see authentication errors, run /kilo_status to check

Paid Models Require Auth

• Run /kilo_login to authenticate
• Use --method api-key if you have a Kilo API key

🔧 Development

# Install dependencies
bun install

# Build
bun run build

# Type check
bun run typecheck

# Lint
bun run lint

📄 License

MIT