dsh-image-studio
v0.1.7
Published
DeepSeek Harness plugin: local text-to-image with a canvas-style GUI, inpainting, DeepSeek vision review, OpenAI-compatible API option, and a Python Stable Diffusion worker (diffusers/MPS).
Maintainers
Readme
dsh-image-studio
DeepSeek Harness plugin for local text-to-image and image editing, with a
settings GUI and a model-callable dsh_image tool.
Features
- Generate images from a prompt — locally via Stable Diffusion (diffusers + PyTorch MPS on Apple Silicon) or an OpenAI-compatible image API.
- Inpaint — edit a region of an existing image using a mask.
- Review — check a generated image with a vision model: the DeepSeek vision
API (
deepseek-v4-flash-vision-exp) or a local Ollama vision model (qwen2.5vl:3b). - Settings section "Image Studio" — backend, model, API key, vision model, and generation parameters.
- Cooperates with
dsh-resource-guard: local generation reserves memory first.
Requirements (local backend)
- macOS with Apple Silicon (MPS) or a CPU-only fallback.
python3on PATH (creates~/.dsh/image-studio-venvautomatically).- First local run downloads model weights
(
runwayml/stable-diffusion-v1-5,runwayml/stable-diffusion-inpainting).
Install
dsh plugin --profile web add dsh-image-studioThen add dsh-image-studio to dsh.profile.bundles and dependencies in
~/.dsh/profiles/web/package.json, and run dsh plugin --profile web install.
Usage
Ask the agent:
dsh_image action=generate prompt="a lighthouse at dusk"— generate locally.dsh_image action=inpaint prompt="a red door" image=/abs/img.png mask=/abs/mask.png— edit a region.dsh_image action=check image=/abs/img.png— vision review.
Outputs are written to ~/.dsh/image-studio-outputs/.
Settings
| Field | Default | Meaning |
| --- | --- | --- |
| backend | local | local (Stable Diffusion) or api (OpenAI-compatible). |
| model | runwayml/stable-diffusion-v1-5 | Local model id or API image model. |
| apiBaseUrl | https://api.openai.com/v1 | API base URL (backend api). |
| apiKey | `` | Bearer token (backend api / vision). |
| visionBackend | deepseek | deepseek or local. |
| visionModel | deepseek-v4-flash-vision-exp | Vision model id. |
| steps / guidanceScale / width / height | 25 / 7.5 / 512 / 512 | Generation parameters. |
Architecture
- Host (
lib/index.js) — spawnsworker/image_worker.py(a stdlib HTTP server on127.0.0.1:7861) into~/.dsh/image-studio-venv, calls its/generateand/inpaintendpoints, and implements the vision review. - Client (
lib/client.js) —settings.sectionwith configuration, prompt input, and Generate / Inpaint / Review buttons (via the action namespace).
License
MIT
