z-node / docs

← Docs index

GSD2

Setup guide for using Z-Node with GSD2.

Official docs

Start with GSD2's official install and configuration docs. They document the CLI install path and core setup:

GSD2 uses ~/.gsd/agent/models.json for custom providers and ~/.gsd/agent/settings.json for defaults.

Z-Node example (~/.gsd/agent/models.json)

json
{
  "providers": {
    "Z-Node": {
      "baseUrl": "https://api.z-node.com/v1",
      "apiKey": "OPENAI_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "gpt-5.5",
          "name": "gpt-5.5",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 1050000,
          "maxTokens": 128000
        },
        {
          "id": "gpt-5.4",
          "name": "gpt-5.4",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 1050000,
          "maxTokens": 128000
        },
        {
          "id": "gpt-5.4-mini",
          "name": "gpt-5.4-mini",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 400000,
          "maxTokens": 128000
        },
        {
          "id": "gpt-5.3-codex",
          "name": "gpt-5.3-codex",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 400000,
          "maxTokens": 128000
        },
        {
          "id": "gpt-5.2",
          "name": "gpt-5.2",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 400000,
          "maxTokens": 128000
        },
        {
          "id": "codex-auto-review",
          "name": "codex-auto-review",
          "reasoning": true,
          "input": ["text"]
        }
      ]
    }
  }
}

Z-Node example (~/.gsd/agent/settings.json)

Then set your defaults in ~/.gsd/agent/settings.json:

json
{
  "defaultProvider": "Z-Node",
  "defaultModel": "gpt-5.5"
}

Acceptable Z-Node model ids for this example:

Smoke test

bash
OPENAI_API_KEY="$ZNODE_ISSUED_API_KEY" gsd --print --no-session "Reply with exactly: Z-NODE-GSD2-OK"