@local/dsh-model-hub

Configuration

Everything lives in the data dir: $DSH_HUB_DATA_DIR, else $DSH_HOME/model-hub, else ~/.dsh/model-hub (created 0700; files 0600). dsh-hub doctor prints the one in use.

config.json (optional; re-read whenever it changes; an invalid value never throws — it is ignored and reported by dsh-hub doctor):

{
  "gpuServer": { "id": "mybox", "name": "My GPU box", "url": "http://127.0.0.1:8000", "icon": "nvidia",
                 "hideModels": ["flash-next"], "defaultModel": "my-model" },
  "localProviders": ["mybox", "mac"],
  "hub": { "allowedOrigins": ["http://127.0.0.1:3200"] },
  "priceModels": ["google/gemini-3.8-flash"],
  "extraLedgers": ["/absolute/path/to/another/spend.jsonl"]
}

Key	Meaning
gpuServer	the optional GPU server (see GPU server); null or absent = off
localProviders	DSH provider ids priced as local ($0, never capped); the GPU server's id is always included. The providers with built-in pricing, anthropic, dashscope, deepseek-account, deepseek-official, github-copilot, google, ollama, ollama-cloud, openai-codex, openrouter and xai, are never treated as local even if listed here
hub.allowedOrigins	extra exact origins allowed to call the host API (see Security model)
priceModels	up to 50 provider/model ids (the model part may contain /; at most 120 characters) always shown in the Costs panel, besides models you actually used
plans	prepaid monthly credits per provider, e.g. {"ollama": {"name": "Pro", "includedUsd": 60, "resetsOnDay": 9}}. See Plans
subscriptions	provider ids declared as subscription-billed ($0 charged, API value kept, never capped). The Costs panel and dsh-hub prices label them "declared in config.json" so a typo is visible. A provider also in localProviders stays local
extraLedgers	other spend ledgers (JSONL rows with ts, usd, optional provider) shown next to DSH's spend, display only

Other files in the data dir: spend.jsonl (ledger), caps.json, prices.json (price overrides), prices.litellm.json (24 h price-table cache), ollama-prices.json (refreshed Ollama Cloud rates), accounts-state.json, provider-health.json.

Environment variable	Effect
DSH_HUB_DATA_DIR	data dir override
DSH_HUB_URL	where the CLI reaches the host API (default http://127.0.0.1:8185)
DSH_HUB_ALLOWED_ORIGINS	extra UI origins, comma-separated
DSH_NODE_MODULES	the installed @deepseek-ai/dsh package's node_modules, if not auto-found
DSH_HUB_GPU_URL, DSH_HUB_GPU_NAME	GPU server URL / name override (ROCCO_SHIM_URL is accepted for back-compat)
DSH_HUB_EXTRA_LEDGERS	extra ledgers, comma-separated absolute paths (overrides extraLedgers)
DSH_HUB_PRICE_FALLBACK	an offline LiteLLM price-table file used when the network fetch fails
DSH_HUB_REFRESH=0	account watchdog reports only, never refreshes