# Pi Ds4 Config

> Reconfigure pi-ds4/ds4 local DeepSeek V4 Flash by editing ~/.pi/ds4/settings.json. Use when the user asks how to configure, reconfigure, change settings, switch model quant/protocol/runtime, or debug pi-ds4 configuration. Use when this capability is needed.

- Skill: `tomevault-io/pi-ds4-config` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pi-ds4-config`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pi-ds4-config/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pi-ds4-config

---


# pi-ds4 configuration

To reconfigure pi-ds4/ds4, edit `~/.pi/ds4/settings.json` (create it if missing). Do not edit other runtime state files in `~/.pi/ds4` unless explicitly debugging.

The file is a JSON object. Environment variables override it. Keys can be env names (`DS4_READY_TIMEOUT_MS`), camelCase without `DS4_` (`readyTimeoutMs`), or lower snake_case (`ready_timeout_ms`). Use `settings.schema.json` / `settings.example.json` from the pi-ds4 package for validation/examples.

Minimal example:

```json
{
  "$schema": "https://raw.githubusercontent.com/mitsuhiko/pi-ds4/main/settings.schema.json",
  "protocol": "openai-responses",
  "modelQuant": "q2-imatrix",
  "readyTimeoutMs": 900000
}
```

Common settings:

- `protocol`: `openai` (default), `openai-responses`, or `anthropic`
- `modelQuant`: force `q2`/`q2-imatrix` or `q4`/`q4-imatrix` for `ds4/deepseek-v4-flash`
- `readyTimeoutMs`: server startup timeout in ms
- `runtimeDir`: existing antirez/ds4 checkout instead of `~/.pi/ds4/support`
- `supportRepo` / `supportBranch`: runtime checkout source
- `serverBinary` / `watchdogScript`: custom executable/script paths
- `apiKey`: token Pi sends to the local provider (default `dsv4-local`)

After editing, run `/reload` or restart pi. Use `/ds4` to inspect the live ds4 log.

---
> Source: [mitsuhiko/pi-ds4](https://github.com/mitsuhiko/pi-ds4) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-19 -->