hermes-clinepass
ClinePass model-provider plugin for Hermes Agent.
Use ClinePass models (cline-pass/*) from Hermes with a normal API key. Includes Kimi K3, GLM, DeepSeek, and the rest of the curated catalog.
Quick start
1. Install
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/Adolanium/hermes-clinepass/main/scripts/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/Adolanium/hermes-clinepass/main/scripts/install.ps1 | iex
2. API key
Create a key at app.cline.bot (Settings → API Keys). You need an active ClinePass subscription for cline-pass/* models.
# $HERMES_HOME/.env (Windows: %LOCALAPPDATA%\hermes\.env)
CLINE_API_KEY=your_key_here
3. Chat
hermes chat -q "Reply with exactly: HELLO" --provider clinepass -m cline-pass/kimi-k3
Or in config.yaml:
model:
provider: clinepass
default: cline-pass/kimi-k3
Provider aliases: clinepass, cline-pass, cline.
Models
| Model | ID |
|---|---|
| Kimi K3 | cline-pass/kimi-k3 |
| GLM-5.3 | cline-pass/glm-5.3 |
| GLM-5.3 Flash | cline-pass/glm-5.3-flash |
| GLM-5.2 | cline-pass/glm-5.2 |
| Kimi K2.7 Code | cline-pass/kimi-k2.7-code |
| Kimi K2.6 | cline-pass/kimi-k2.6 |
| DeepSeek V4 Pro | cline-pass/deepseek-v4-pro |
| DeepSeek V4 Flash | cline-pass/deepseek-v4-flash |
| DeepSeek V4.1 Flash | cline-pass/deepseek-v4.1-flash |
| MiMo-V2.5-Pro | cline-pass/mimo-v2.5-pro |
| MiMo-V2.5 | cline-pass/mimo-v2.5 |
| MiniMax M3 | cline-pass/minimax-m3 |
| Qwen3.8 Max | cline-pass/qwen3.8-max |
| Qwen3.7 Max | cline-pass/qwen3.7-max |
| Qwen3.7 Plus | cline-pass/qwen3.7-plus |
Default auxiliary model: cline-pass/deepseek-v4-flash.
The gateway's generic model listing omits cline-pass/* IDs. The plugin reads the clinePass and free blocks from Cline's live catalog, matching Cline's ClinePass picker. Free models keep their exact gateway IDs, including stealth/* and cline-free/*; the plugin does not add a cline-pass/ prefix. New pass and free models appear without a plugin update when Cline advertises them in those blocks.
The table above is the built-in fallback used when that request fails. It contains pass models only because free offerings rotate. The plugin supplies ProviderProfile.fallback_models and fetch_models(); Hermes owns picker and validator integration. If a live refresh fails, discovery returns to the curated fallback, so rotating free models require an available live catalog. Catalog discovery does not verify account access or successful inference. See ClinePass docs.
Usage-billing model ids (OpenRouter-style) work on the same host and key if you pass them with -m, for example anthropic/claude-sonnet-4.6.
Verify
hermes doctor
hermes chat -q "Reply with exactly: PING" --provider clinepass -m cline-pass/deepseek-v4-flash
Other install methods
mkdir -p "${HERMES_HOME:-$HOME/.hermes}/plugins/model-providers"
git clone https://github.com/Adolanium/hermes-clinepass.git /tmp/hermes-clinepass
cp -R /tmp/hermes-clinepass/clinepass "${HERMES_HOME:-$HOME/.hermes}/plugins/model-providers/clinepass"
Windows:
$homeDir = if ($env:HERMES_HOME) { $env:HERMES_HOME } else { Join-Path $env:LOCALAPPDATA "hermes" }
$dest = Join-Path $homeDir "plugins\model-providers\clinepass"
New-Item -ItemType Directory -Force -Path (Split-Path $dest) | Out-Null
git clone https://github.com/Adolanium/hermes-clinepass.git $env:TEMP\hermes-clinepass
Copy-Item -Recurse -Force $env:TEMP\hermes-clinepass\clinepass $dest
git clone https://github.com/Adolanium/hermes-clinepass.git
cd hermes-clinepass
pip install .
Registers hermes_agent.plugins entry point clinepass = clinepass:register.
Notes
Cline’s gateway wraps some non-streaming JSON responses. Streaming chat is fine. Hermes auxiliary work (titles, summaries, compaction) uses non-streaming calls and needs a Hermes core fix:
This plugin still registers the provider and catalog on any recent Hermes.
License
MIT. ClinePass and Cline are trademarks of their respective owners. This is an independent community plugin.