Skip to content

Document how embedding apps supply their own stems - #11

Merged
setoelkahfi merged 3 commits into
mainfrom
docs/embedding-hosts-supply-demucs
Oct 13, 2026
Merged

setoelkahfi merged 3 commits into
mainfrom
docs/embedding-hosts-supply-demucs

Conversation

@setoelkahfi

@setoelkahfi setoelkahfi commented Oct 11, 2026 •

Copy link
Copy Markdown
Contributor

Three apps now embed splitfire-agent and handle stems differently, and the docs only described the standalone case.

The README's stem separation section and AGENTS.md now say that an embedding app can pass its own demucs MCP server (the SplitFire AI Audio Separator does, with its own executable in --mcp mode) or return no built-in servers from its Profile (KaroKowe Jam and KaroKowe Karaoke do, and each writes its own guidance). They also name the two result shapes the stem hooks read: structuredContent.models[]{id,size_mb,cached} and structuredContent.stems[].path.

Since the last revision, 1.2.0 is out with the embed feature, and main is merged into this branch. The new Embedding section sits next to the stems text without overlap, and Karaoke was added as the third host.

Docs only, no code change.

Hosts decide what stems mean through a client-supplied demucs MCP
server, or by returning no built-in servers from their Profile. The
README and AGENTS.md now say so, and name the two result shapes the
stem hooks read.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@sigit-code-review

Copy link
Copy Markdown

siGit Code Review is paused because the linked siGit account has reached its monthly cloud allowance. On siGit Code Unlimited, reviews don't count toward it: https://sigit.si/billing

@setoelkahfi setoelkahfi self-assigned this Oct 13, 2026
@setoelkahfi setoelkahfi added the documentation Improvements or additions to documentation label Oct 13, 2026
@keypair34

Copy link
Copy Markdown
Collaborator

Better postpone this until v1.2.0 out

@sigit-code-review sigit-code-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated README.md and .agents/AGENTS.md to document how embedding apps supply their own Demucs MCP server or handle stems differently, describing the two result shapes the stem hooks read and naming the two embedding apps that do so.


Automated review by siGit Code Review · commit 45dfa60 · see the review dashboard

@setoelkahfi

Copy link
Copy Markdown
Contributor Author

1.2.0 is published and main is merged in, so the hold is over. I also added KaroKowe Karaoke to the hosts that return no built-in servers.

@setoelkahfi
setoelkahfi merged commit dc291f1 into main Oct 13, 2026
2 checks passed
@setoelkahfi
setoelkahfi deleted the docs/embedding-hosts-supply-demucs branch October 13, 2026 12:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants