@simplellm/opencode-providerSimpleLLM provider setup for OpenCode — one command, EU-hosted LLM inference
0
30
6 in 7 days
26.4
Multi-signal model
1 month ago
2026-06-25
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@simplellm/opencode-provider@0.5.1"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@simplellm/opencode-provider@0.5.1"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D @simplellm/opencode-provideropencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
Use SimpleLLM — EU-hosted, DSGVO-compliant LLM inference — as a model provider in OpenCode. One command sets everything up.
SimpleLLM exposes an OpenAI-compatible API, so this package wires it into OpenCode via @ai-sdk/openai-compatible. It also ships a small plugin that shows your remaining credit balance when an OpenCode session starts.
Quick start
npx @simplellm/opencode-provider
The setup wizard:
- Connects to SimpleLLM and fetches the available models
- Asks for your API key and validates it (shows your SC balance)
- Writes the OpenCode provider config (
~/.config/opencode/opencode.json) - Stores your API key (
~/.local/share/opencode/auth.json)
Then start OpenCode with a SimpleLLM model:
opencode --model simplellm/Qwen3-Coder-30B-A3B-Instruct
Re-run the command any time models or your URL change — it merges into your existing OpenCode config without overwriting other providers.
What it does
- Setup CLI — interactive, idempotent configuration of OpenCode
- Plugin — shows your credit balance (
SC) on session start, warns when low or unconfigured - Model discovery — pulls the live model list (context window, pricing) from SimpleLLM
Configuration
| Variable | Default | Purpose |
|---|---|---|
SIMPLELLM_BASE_URL |
https://api.simplellm.eu |
Point at a self-hosted or local SimpleLLM instance |
SIMPLELLM_API_KEY |
— | Read by the plugin if set; overrides the stored key |
Get an API key at simplellm.eu.
Using the plugin programmatically
import { SimpleLLMPlugin, discoverModels } from '@simplellm/opencode-provider'
SimpleLLMPlugin is an OpenCode plugin factory; discoverModels() fetches the current model list from a SimpleLLM instance.
Development
Requires Node.js 20+.
git clone https://github.com/SimpleLLM/opencode-provider.git
cd opencode-provider
npm install
npm run build # tsc → dist/
Related
- @simplellm/openclaw-provider — the same, for OpenClaw
License
MIT — see LICENSE.