dsh-blender-plugin: A Direct Realtime Blender Control Plugin for DeepSeek Harness
sixtysevenlf/dsh-blender-plugin
A DSH plugin that lets an AI model drive Blender in real time over a direct TCP channel, with 15 tools for viewport frames, any-angle renders, inner-loop search, render profiling and headless offload.
dsh-blender-plugin turns Blender viewport frames, scene edits and render tuning into tools a model can call directly inside DeepSeek Harness over a single direct TCP channel, removing the need to paste screenshots into prompts or run an extra forwarding service. It covers any-angle rendering, inner-loop search, render profiling, safe decimation, headless offload and a contract-layer planner, with the model-facing surface frozen at 15 tools and the plan channel spanning 28 families and 183 ops. There is exactly one acceptance test: the viewport tool's doctor operation must return kind=ok. Maintained by sixtysevenlf under BSD-3-Clause.
How to Install
dsh plugin --profile <your-profile> add github:sixtysevenlf/dsh-blender-pluginReplace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.
- Category
- Tools & Capabilities
- Platform
- DSH Plugin
- Author
- sixtysevenlf
- Distribution
- Plugin
dsh-blender-plugin Key Features
dsh-blender-plugin Repo Summary
What Does It Do?
DSH × Blender Direct Realtime Plugin is a DSH plugin for DeepSeek Harness that lets an AI model actually drive Blender over a direct TCP channel. It removes the need to click through the UI, paste screenshots into prompts, or run an MCP server, turning viewport frames, scene edits and render tuning into tools the model can call. Maintained by sixtysevenlf under BSD-3-Clause, v1.0 is the first stable release, freezing the model-facing surface at 15 tools while the plan channel exposes 28 families and 183 ops.
Core Features
- Viewport and any-angle rendering: render from a given position and look-at without a camera object, leaving the user's own viewport untouched, at roughly 85–280 ms per call.
- Inner-loop search: run thousands of iterations inside the plugin with zero model turns, turning parameter tuning into a single call.
- Render profiling and presets: analyze render performance and produce reusable presets, with analysis taking about 10–20 s.
- Safe decimation and geometry optimization: decimate objects with safe joining and zero geometry loss, at about 1.4 ms per object.
- Headless offload: push heavy renders and batch geometry to a separate headless process with a 0.9–1.2 s cold start, plus hot session reuse.
- Contract layer and planner: judge, verify and export through blender_rt_plan, backed by AABB sweeps and BVH acceleration across hundreds of objects.
How to Use This Plugin?
After enabling the plugin in DSH and bringing the Blender-side addon and backend channel up, the model can call the tools directly: peek at the current viewport, change one thing and verify it immediately, then use the watch tool to capture a few frames when it needs to know whether something moved or looks right. Heavy work goes to the headless process or batch jobs, long tasks can be rolled back, parameter presets can be stored, and any addon command can be passed through. There is exactly one acceptance test: the viewport tool's doctor operation must return kind=ok, otherwise follow the README troubleshooting section step by step.
How to Troubleshoot This Plugin?
The plugin defines "not installed" very precisely: if the doctor check does not return kind=ok, it is not installed successfully, and you should walk the official README troubleshooting section item by item instead of retrying blindly. The README also advises having an AI agent read the requirements, install and troubleshooting sections plus AGENTS.md before doing anything, then run the doctor self-check rather than guessing.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: sixtysevenlf/dsh-blender-plugin. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
