v2.0.4 — restore AstrBot compatibility helpers

2.0.4 — regression fix for AstrBot

The 2.0 refactor kept the AstrBot adapter's instance methods but dropped the module-level helpers that aqq_voice_adapter imports by name. As a result, its 60-second watchdog silently did nothing: no 23:00 IndexTTS stop, no daytime TTS replenish.

This release restores them as thin wrappers over the new orchestrator:

• _is_indextts_running
• _kill_indextts_webui
• _start_indextts_webui
• _is_comfyui_running
• _is_comfyui_process_running
• _is_tts_busy (new)

It also refuses to stop IndexTTS while tts_busy.flag is fresh, so the 23:00 quiet window cannot kill a voice synthesis in progress. The qq_voice_adapter watchdog checks the same flag before stop/start.

Adds a source-level contract test so the helpers cannot disappear silently again. No changes to the coordinator core or the DSH plugin.

Install

• AstrBot: plugin market → search VRAM Switcher, or clone into AstrBot/data/plugins/astrbot_plugin_vram_switcher.
• DSH: dsh plugin --profile web add https://github.com/xiaoxiao150/vram-switcher/releases/download/v2.0.4/dsh-vram-switcher-2.0.4.tgz

If you run AstrBot, restart it after updating so the restored helpers are loaded.

v2.0.3 — built for local AI companions

2.0.3 — built for local AI companions

This release is a positioning release, not a runtime rewrite: it makes clear what this project is for and when you should use something else.

The setup it is built for: a local AI companion on AstrBot or DeepSeek Harness — persona chat via a local LLM, voice via IndexTTS, selfies/edits via ComfyUI, all on one 12 GB card. A generic GPU broker does not know when a voice clip has actually finished synthesizing; for a companion, that boundary is the whole point.

New docs

• docs/indextts.md — the tts_busy.flag / tts_ready.flag contract, copy-paste adapter code, AstrBot hook priorities, IndexTTS 2.0/2.5 selection, troubleshooting and a checklist.
• docs/comparison.md — an honest comparison with llama-swap, berth and vhotseat, including when not to use this project.
• README/README.en now include "who it is for", the companion turn diagram, and a history section: first internal version in August 2026, ComfyUI cold-start incident in September, 2.0 rewrite and open source in October.

Install

• AstrBot: plugin market → search VRAM Switcher, or clone into AstrBot/data/plugins/astrbot_plugin_vram_switcher.
• DSH: dsh plugin --profile web add https://github.com/xiaoxiao150/vram-switcher/releases/download/v2.0.3/dsh-vram-switcher-2.0.3.tgz

No runtime code changed since 2.0.2; upgrading is optional if you already have a working setup.

v2.0.2 — one-command profile setup

2.0.2

One command to configure it. configure.py looks at your machine and writes a profile for you.

git clone https://github.com/xiaoxiao150/vram-switcher
cd vram-switcher
python configure.py --root D:/AI        # add --dry-run to look without writing

It detects a running llama-server, an IndexTTS webui and ComfyUI, falls back to scanning --root directories, checks the usual ports, and marks anything it could not find as enabled: false. Nothing is started or stopped.

Also in this release

• English README (README.en.md) with a benefit-first intro and the same measured numbers as the Chinese one.
• 8 new tests for configure.py: pure-JSON --dry-run, refusal to overwrite, .bak on --force, and the generated profile is loaded by the real plugin loader.
• The npm tarball now ships configure.py and README.en.md, and no longer contains __pycache__.
• Version 2.0.2 across metadata.yaml, dsh-plugin.json, package.json and the MCP server.

Install

• AstrBot: plugin market → search VRAM Switcher, or clone into AstrBot/data/plugins/astrbot_plugin_vram_switcher.
• DSH: dsh plugin --profile web add https://github.com/xiaoxiao150/vram-switcher/releases/download/v2.0.2/dsh-vram-switcher-2.0.2.tgz

Full changelog: CHANGELOG.md

VRAM Switcher 2.0.1

Root cordis.patch.yml, corrected DSH prerelease ranges, CI package validation.

VRAM Switcher 2.0.0

First public release.

• Configurable local-GPU coordinator for AstrBot.
• Native DSH Cordis plugin with vram_status / vram_acquire / vram_release.
• Cross-process coordinator lock shared by both adapters.