zytsyj/dsh-gpu

GPU-aware execution layer for DeepSeek Harness: gpu_status / gpu_exec / gpu_run_

A GPU-aware execution layer for DeepSeek Harness: agents get three tools — gpu_status (one query, every device: memory used/total, SM utilization, temperature, free/busy verdict), gpu_exec (one-shot command with an automatically selected freest card, CUDA_VISIBLE_DEVICES set in the command environment; pin a card explicitly when you care), and gpu_run_bg (background jobs). An optional per-step GPU context line injects a snapshot into the agent's context. A device is busy at or above 80% memory used or 50% utilization (both configurable).

Agent Capabilities ★ 3 updated 2026-08-14 ⏳ pending
View on GitHub ↗

Install

dsh plugin --profile web add dsh-gpu

npm package dsh-gpu 0.1.4 (registry-verified 2026-08-29): dsh plugin --profile web add dsh-gpu — the bundled cordis.patch.yml registers the plugin automatically. Load order: place it after your execution-world plugins (e.g. an SSH provider) so the shell seam it queries is the one you intend. Hosts without NVIDIA GPUs get a clean no-gpu result instead of failing.

Compatibility

DeepSeek Harness (dsh), out-of-tree plugin — no harness patches. NVIDIA GPU hosts; gpu_run_bg needs @deepseek-ai/dsh-jobs + @deepseek-ai/dsh-tool-jobs in the composition.

Details

Recent updates

gpu_status/gpu_exec/gpu_run_bg tools; automatic freest-card selection with CUDA_VISIBLE_DEVICES; per-step GPU context line; configurable busy thresholds; no-gpu fallback.

FAQ

How are cards selected?
Automatically — the freest card is picked first with CUDA_VISIBLE_DEVICES set in the command environment; you can pin a specific card via gpuIndex.
What does a 'busy' verdict mean?
A device is busy at or above 80% memory used or 50% SM utilization — both thresholds are configurable.
Does it work without NVIDIA GPUs?
Yes — gpu_status reports a clean no-gpu result instead of failing on hosts without NVIDIA hardware.

Alternatives

GPIOX/dsh-api-balance · YYTbit/dsh-plugin-cost-tracker · huanyuLv/dsh-balance-tide

More plugins in Agent Capabilities

Browse more in Agent Capabilities

Guides for Agent Capabilities plugins