Vertex AI Gemini provider using local service-account JSON, with a native model-settings card, custom model entries, and per-model concurrency and cooldown.
Install
# from a prebuilt release tarball
dsh plugin --profile web add "https://github.com/Z5-Bit/dsh-vertex-sa/releases/download/v0.1.4/dsh-vertex-sa-0.1.4.tgz"
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:Z5-Bit/dsh-vertex-sa
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
A Vertex AI Gemini model provider for DeepSeek Harness using a local Google service-account JSON file.
Install
In DSH's Plugins → Add plugin input, paste this URL by itself:
https://github.com/Z5-Bit/dsh-vertex-sa/releases/download/v0.1.4/dsh-vertex-sa-0.1.4.tgz
This prebuilt package needs neither Git nor an npm account. DSH uses its own package manager. If your network cannot reach GitHub's Release asset host, the version archive also contains prebuilt bundles and installs without Git:
https://github.com/Z5-Bit/dsh-vertex-sa/archive/refs/tags/v0.1.4.tar.gz
The equivalent DSH CLI command is:
dsh plugin add https://github.com/Z5-Bit/dsh-vertex-sa/releases/download/v0.1.4/dsh-vertex-sa-0.1.4.tgz
The bare repository URL https://github.com/Z5-Bit/dsh-vertex-sa and github:Z5-Bit/dsh-vertex-sa are Git installation specs. They require a working git command on the computer running DSH. For ERR_PNPM_GIT_RESOLVE_FAILED followed by git: not found or 'git' is not recognized, use a tarball URL above, or install Git, add it to PATH and restart DSH completely, including its tray process. Appending .git, upgrading pnpm or switching to SSH does not fix a missing executable. This public repository does not require GitHub sign-in or SSH keys.
You may also extract the Release ZIP and add its directory in DSH. The repository and packages contain prebuilt host/client bundles; no install-time script runs. Requires Node.js >=22.19.0 and the declared DSH 0.2.2 prerelease/0.2 stable API range. Host integration was developed against 0.2.2-rc.1, rc.2 and rc.3; newer prerelease tuples need explicit npm peer validation.
Open Settings → Models → Vertex AI · Service Account → Edit. Select your own service-account JSON file, set the project/region if necessary, save, and test the connection. Your project must enable Vertex AI, billing, and the requested models; the service account needs appropriate IAM permissions. The connection probe uses countTokens rather than generating an answer.
What it provides
- A native model-settings card with local credential-file selection and custom Gemini model entries.
- Streaming text/reasoning, function tools, thought-signature round trips and image input through DSH's model/attachment interfaces.
- Per-model concurrency limits, cancellation and shared cooldown after rate limiting.
- Direct, explicit HTTP(S) proxy, environment proxy and Windows system-proxy modes.
- Same-name local-directory updates that preserve existing configuration.
This is a service-account-only provider. It does not implement gcloud user ADC login. It provides configurable model presets, not a guarantee that an account can use every model. See the Chinese guide for configuration and troubleshooting.
Development
Use Node.js 24 LTS and npm:
npm ci --ignore-scripts
npm run verify
npm test
npm run build
The build goes to .build/. To intentionally replace the reviewed distribution bundles, use node scripts/build.mjs --write, then review/test the changes and update the release. npm pack --ignore-scripts creates the installable tarball. Tests generate synthetic keys and use isolated profiles/mock HTTP; no real cloud credential is required.
Opt-in network installation tests use the real DSH plugin manager and isolated profiles: npm run test:install -- --release --without-git, npm run test:install -- --archive --without-git, or npm run test:install -- --source https://github.com/Z5-Bit/dsh-vertex-sa. The no-Git tests remove Git from the child process's PATH and verify installation plus bundle selection. No real DSH profile or service-account file is used.
Security and attribution
Credentials remain in your original local JSON file; only its path is saved in DSH configuration. OAuth tokens are cached in memory. Submitted conversation content, tool data and selected images are sent over HTTPS to your configured Google endpoints. See SECURITY.md.
MIT; see LICENSE. Protocol conversion and image helpers include adaptations from zh-plus/dsh-gemini-argon v0.7.3, with the original copyright and license retained in THIRD_PARTY_NOTICES.md. The current public package preserves the 0.1.3 implementation and prebuilt bundles.
Links
More in this category
Ebony-Vinyl/dsh-our-free-model★ 77208
Adds free model lanes to DeepSeek Harness — DeepSeek V4.1 Flash, Kimi K3 and others — with no login, sign-up or API key, plus a local OpenAI-compatible gateway, fallback routing and a usage dashboard.
dingminhua/dsh-connect-workbuddy★ 1681
Connects locally signed-in WorkBuddy models, CN and international alike, to DSH, reading each model's credit multiplier from the upstream catalog on every refresh, with per-model image input toggles, account switching backed by an auto-failing-over pool, manual daily check-in, and read-only credit overviews shown as compact pills on the card and in the composer.
Alice-Marx/dsh-model-router★ 966
Routes DeepSeek Harness work across configured model APIs and supported vendor CLIs with dependency-aware packages and cost previews.
V1ki/dsh-plugin-subscriptions★ 618
Use ChatGPT (Codex), Claude, and Grok subscriptions as DeepSeek Harness LLM providers, with Settings login, model catalogs, usage, plus image_generate, video_generate, and x_search tools.
XDTrees/dsh-workbuddy-xdpool★ 541
Merge every locally signed-in WorkBuddy account into DeepSeek Harness as one auto-failing-over model pool (multi-account rotation, live credits, and a model catalog showing per-model credit multipliers and free/night-discount tags).
XDTrees/dsh-xdpool★ 541
Merge every locally signed-in WorkBuddy account into DeepSeek Harness as one auto-failing-over model pool: multi-account rotation, 429 cooldowns, live credits, a model catalog with per-model credit multipliers and free/night-discount tags, QR-code login for 13 vendors, and aggregate free-tier channels. Accounts persist across restarts.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.