free-coding-models 0.1.3 → 0.1.5

package/README.md

@@ -5,7 +5,17 @@
   <img src="https://img.shields.io/badge/models-44-76b900?logo=nvidia" alt="models count">
 </p>
 
-<h1 align="center">⚡ Free Coding Models</h1>
+<h1 align="center">free-coding-models</h1>
+
+<p align="center">
+
+```
+1. Create a free API key on NVIDIA → https://build.nvidia.com
+2. npm i -g free-coding-models
+3. free-coding-models
+```
+
+</p>
 
 <p align="center">
   <strong>Find the fastest coding LLM models in seconds</strong><br>
@@ -288,41 +298,48 @@ Or run without flags and choose **OpenClaw** from the startup menu.
 
 ```json
 {
-  "providers": {
-    "nvidia": {
-      "baseUrl": "https://integrate.api.nvidia.com/v1",
-      "apiKey": "nvapi-xxxx-your-key",
-      "api": "openai-completions",
-      "models": [
-        {
-          "id": "deepseek-ai/deepseek-v3.2",
-          "name": "DeepSeek V3.2",
-          "contextWindow": 128000,
-          "maxTokens": 8192
-        }
-      ]
+  "models": {
+    "providers": {
+      "nvidia": {
+        "baseUrl": "https://integrate.api.nvidia.com/v1",
+        "api": "openai-completions"
+      }
     }
   },
+  "env": {
+    "NVIDIA_API_KEY": "nvapi-xxxx-your-key"
+  },
   "agents": {
     "defaults": {
       "model": {
         "primary": "nvidia/deepseek-ai/deepseek-v3.2"
+      },
+      "models": {
+        "nvidia/deepseek-ai/deepseek-v3.2": {}
       }
     }
   }
 }
 ```
 
+> ⚠️ **Note:** `providers` must be nested under `models.providers` — not at the config root. A root-level `providers` key is ignored by OpenClaw.
+
+> ⚠️ **Note:** The model must also be listed in `agents.defaults.models` (the allowlist). Without this entry, OpenClaw rejects the model with *"not allowed"* even if it is set as primary.
+
 ### After updating OpenClaw config
 
-Restart OpenClaw or run the CLI command to apply the new model:
+OpenClaw's gateway **auto-reloads** config file changes (depending on `gateway.reload.mode`). To apply manually:
 
 ```bash
-openclaw restart
-# or
+# Apply via CLI
 openclaw models set nvidia/deepseek-ai/deepseek-v3.2
+
+# Or re-run the interactive setup wizard
+openclaw configure
 ```
 
+> ⚠️ **Note:** `openclaw restart` does **not** exist as a CLI command. Kill and relaunch the process manually if you need a full restart.
+
 > 💡 **Why use remote NIM models with OpenClaw?** NVIDIA NIM serves models via a fast API — no local GPU required, no VRAM limits, free credits for developers. You get frontier-class coding models (DeepSeek V3, Kimi K2, Qwen3 Coder) without downloading anything.
 
 ---
@@ -391,6 +408,21 @@ npm install
 npm start -- YOUR_API_KEY
 ```
 
+### Releasing a new version
+
+1. Make your changes and commit them with a descriptive message
+2. Update `CHANGELOG.md` with the new version entry
+3. Bump `"version"` in `package.json` (e.g. `0.1.3` → `0.1.4`)
+4. Commit with **just the version number** as the message:
+
+```bash
+git add .
+git commit -m "0.1.4"
+git push
+```
+
+The GitHub Actions workflow automatically publishes to npm on every push to `main`.
+
 ---
 
 ## 📄 License

package/bin/free-coding-models.js

@@ -755,48 +755,59 @@ async function startOpenClaw(model, apiKey) {
     console.log(chalk.dim(`  💾 Backup: ${backupPath}`))
   }
 
-  // 📖 Ensure providers section exists with nvidia NIM block
-  // 📖 Only injects if not already present - we don't overwrite existing provider config
-  if (!config.providers) config.providers = {}
-  if (!config.providers.nvidia) {
-    config.providers.nvidia = {
+  // 📖 Ensure models.providers section exists with nvidia NIM block.
+  // 📖 Per OpenClaw docs (docs.openclaw.ai/providers/nvidia), providers MUST be nested under
+  // 📖 "models.providers", NOT at the config root. Root-level "providers" is ignored by OpenClaw.
+  // 📖 API key is NOT stored in the provider block — it's read from env var NVIDIA_API_KEY.
+  // 📖 If needed, it can be stored under the root "env" key: { env: { NVIDIA_API_KEY: "nvapi-..." } }
+  if (!config.models) config.models = {}
+  if (!config.models.providers) config.models.providers = {}
+  if (!config.models.providers.nvidia) {
+    config.models.providers.nvidia = {
       baseUrl: 'https://integrate.api.nvidia.com/v1',
-      // 📖 Store key reference as env var name — avoid hardcoding key in config file
-      apiKey: apiKey || process.env.NVIDIA_API_KEY || 'YOUR_NVIDIA_API_KEY',
       api: 'openai-completions',
-      models: [],
     }
-    console.log(chalk.dim('  ➕ Added nvidia provider block to OpenClaw config'))
+    console.log(chalk.dim('  ➕ Added nvidia provider block to OpenClaw config (models.providers.nvidia)'))
   }
 
-  // 📖 Ensure the chosen model is in the nvidia models array
-  const modelsArr = config.providers.nvidia.models
-  const modelEntry = {
-    id: model.modelId,
-    name: model.label,
-    contextWindow: 128000,
-    maxTokens: 8192,
-  }
-  const alreadyListed = modelsArr.some(m => m.id === model.modelId)
-  if (!alreadyListed) {
-    modelsArr.push(modelEntry)
-    console.log(chalk.dim(`  ➕ Added ${model.label} to nvidia models list`))
+  // 📖 Store API key in the root "env" section so OpenClaw can read it as NVIDIA_API_KEY env var.
+  // 📖 Only writes if not already set to avoid overwriting an existing key.
+  const resolvedKey = apiKey || process.env.NVIDIA_API_KEY
+  if (resolvedKey) {
+    if (!config.env) config.env = {}
+    if (!config.env.NVIDIA_API_KEY) {
+      config.env.NVIDIA_API_KEY = resolvedKey
+      console.log(chalk.dim('  🔑 Stored NVIDIA_API_KEY in config env section'))
+    }
   }
 
-  // 📖 Set as the default primary model for all agents
+  // 📖 Set as the default primary model for all agents.
+  // 📖 Format: "provider/model-id" — e.g. "nvidia/deepseek-ai/deepseek-v3.2"
+  // 📖 Set as the default primary model for all agents.
+  // 📖 Format: "provider/model-id" — e.g. "nvidia/deepseek-ai/deepseek-v3.2"
   if (!config.agents) config.agents = {}
   if (!config.agents.defaults) config.agents.defaults = {}
   if (!config.agents.defaults.model) config.agents.defaults.model = {}
   config.agents.defaults.model.primary = `nvidia/${model.modelId}`
 
+  // 📖 REQUIRED: OpenClaw requires the model to be explicitly listed in agents.defaults.models
+  // 📖 (the allowlist). Without this entry, OpenClaw rejects the model with "not allowed".
+  // 📖 See: https://docs.openclaw.ai/gateway/configuration-reference
+  if (!config.agents.defaults.models) config.agents.defaults.models = {}
+  config.agents.defaults.models[`nvidia/${model.modelId}`] = {}
+
   saveOpenClawConfig(config)
 
   console.log(chalk.rgb(255, 140, 0)(`  ✓ Default model set to: nvidia/${model.modelId}`))
   console.log()
   console.log(chalk.dim('  📄 Config updated: ' + OPENCLAW_CONFIG))
   console.log()
-  console.log(chalk.dim('  💡 Restart OpenClaw for changes to take effect:'))
-  console.log(chalk.dim('     openclaw restart') + chalk.dim('  or  ') + chalk.dim('openclaw models set nvidia/' + model.modelId))
+  // 📖 "openclaw restart" does NOT exist. The gateway auto-reloads on config file changes.
+  // 📖 To apply manually: use "openclaw models set" or "openclaw configure"
+  // 📖 See: https://docs.openclaw.ai/gateway/configuration
+  console.log(chalk.dim('  💡 OpenClaw will reload config automatically (gateway.reload.mode).'))
+  console.log(chalk.dim('     To apply manually: openclaw models set nvidia/' + model.modelId))
+  console.log(chalk.dim('     Or run the setup wizard: openclaw configure'))
   console.log()
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",