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

@local/dsh-model-hub

Install

README

Configuration