Add openai-local provider for custom OpenAI-compatible endpoints

- Add OpenAiLocalProvider class that auto-discovers models via /models endpoint
- Add example entry in llms.json
- Fix config-example docs to use correct npm/api syntax (was type/base_url)
- Add link to main docs site in config-example README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: noahkiss

config-example/README.md

@@ -1,6 +1,6 @@
 # Custom Configuration Example
 
-This directory shows how to use custom `llms.json` and `providers.json` configuration files with the Docker container.
+This directory shows how to use custom `llms.json` and `providers.json` configuration files with the Docker container. For full documentation, see [llmspy.org/docs/configuration](https://llmspy.org/docs/configuration).
 
 ## Quick Start
 
@@ -93,24 +93,23 @@ docker run -p 8000:8000 \
 
 ### Custom Provider Configuration
 
-Add a custom OpenAI-compatible provider:
+Add a custom OpenAI-compatible provider (LiteLLM, vLLM, text-generation-webui, etc.):
 
 ```json
 {
   "providers": {
-    "my-custom-provider": {
+    "my-backend": {
       "enabled": true,
-      "type": "OpenAiProvider",
-      "base_url": "https://api.example.com/v1",
-      "api_key": "$MY_CUSTOM_API_KEY",
-      "models": {
-        "my-model": "provider-model-name"
-      }
+      "npm": "openai-local",
+      "api": "http://localhost:8000/v1",
+      "api_key": "$MY_BACKEND_API_KEY"
     }
   }
 }
 ```
 
+The `openai-local` provider auto-discovers models via the `/models` endpoint. You can name the provider anything you want and use any environment variable for the API key. (Note: `npm` specifies the provider type, not an npm package.)
+
 ### Enable Only Free Providers
 
 ```json

llms/llms.json

@@ -247,6 +247,12 @@
             "api": "http://127.0.0.1:1234/v1",
             "models": {}
         },
+        "openai-local": {
+            "enabled": false,
+            "npm": "openai-local",
+            "api": "http://localhost:8000/v1",
+            "api_key": "$OPENAI_LOCAL_API_KEY"
+        },
         "google": {
             "enabled": true,
             "safety_settings": [

llms/main.py

@@ -1431,6 +1431,10 @@ async def get_models(self):
         return ret
 
 
+class OpenAiLocalProvider(LMStudioProvider):
+    sdk = "openai-local"
+
+
 def get_provider_model(model_name):
     for provider in g_handlers.values():
         provider_model = provider.provider_model(model_name)
@@ -2838,6 +2842,7 @@ def __init__(self, cli_args: argparse.Namespace, extra_args: Dict[str, Any]):
             CodestralProvider,
             OllamaProvider,
             LMStudioProvider,
+            OpenAiLocalProvider,
         ]
         self.aspect_ratios = {
             "1:1": "1024×1024",