How to Use Demucs in Claude Code
Demucs separates mixed music into stems for practice, remix preparation, and vocal extraction. Its six-source model adds guitar and piano to the usual four stems, though piano separation can contain substantial bleed and artifacts.
Prompts to try with Demucs in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Demucs to separate the demo song in this project's audio assets into vocals, drums, bass, and other accompaniment. Save the results beside the original in a clearly named folder.
Use Demucs to extract the bass from the rehearsal recording in this project. Add a simple playback comparison between the original and the extracted bass.
Use Demucs with its six-source model to separate the guitar from the project's demo recording. Keep the original available for listening comparisons.
Use Demucs on the chorus of the project's demo song twice, with shifts set to 1 and 4. Build a listening comparison so I can choose which vocal stem to keep.
Use Demucs with the six-source model on the piano demo in this project. Add a review note asking me to check the piano stem for bleed and artifacts before editing.
How to set up Demucs in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Demucs
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "fal", "model": "fal-ai/demucs", "input": { "audio_url": "https://storage.googleapis.com/falserverless/model_tests/audio-understanding/Title_%20Running%20on%20Fal.mp3" } }'
Then paste one of the prompts above: Claude Code finds Demucs on Spiral, shows the price and runs it.
Demucs providers and prices
Spiral runs Demucs through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Demucs works from your audio URL. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Model | htdemucs, htdemucs_ft, htdemucs_6s, hdemucs_mmi, mdx, mdx_extra, mdx_q, or mdx_extra_q | htdemucs_6s | Demucs model to use for separation |
| Segment length | a whole number from 1 | Length in seconds of each segment for processing (minimum 1). Smaller values use less memory but may reduce quality. Default is model-specific. | |
| Shifts | 1 to 10 | 1 | Number of random shifts for equivariant stabilization. Higher values improve quality but increase processing time. |
| Overlap | 0 to 1 | 0.25 | Overlap between segments (0.0 to 1.0). Higher values may improve quality but increase processing time. |
| Output format | wav or mp3 | mp3 | Output audio format for the separated stems |
Every API field of Demucs Stem Separation is on its tool page: open its card above.
What can you do with Demucs in Claude Code?
Demucs lets you turn mixed music in a project into separate instrument references. A coding agent can organize the results and build listening comparisons around the extracted stems.
Vocal practice
Extract the vocal stem from a song to study phrasing and entrances without the full accompaniment competing for attention.
Drum practice
Separate the drums for focused listening to fills, groove, and transitions before practicing the part.
Bass transcription preparation
Extract the bass stem as a listening reference while working out a bass line by ear.
Remix preparation
Separate a mixed recording into stems, then audition each stem before choosing material for an arrangement.
Guitar part study
Use the six-source model to extract a guitar reference for studying rhythm patterns and musical entrances.
Piano part exploration
Try the six-source model for a piano listening reference. Check carefully for other instruments bleeding through before relying on individual notes.
More on Demucs and Claude Code
Overview
Demucs in other agents
Questions about Demucs in Claude Code
Can Claude Code use Demucs?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Demucs like any built-in tool.
How much does Demucs cost in Claude Code?
$0.00091 per second. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need a fal account to use Demucs in Claude Code?
No. Spiral runs Demucs on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Demucs in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Demucs runs?
Demucs runs in the background. Claude Code starts the run, checks on it and gives you the audio when it's ready.
What is Demucs useful for?
Demucs separates mixed music into vocals, drums, bass, and other accompaniment. Those stems give you material for instrument practice, vocal study, and remix preparation.
Can Demucs isolate guitar and piano?
Yes, with the experimental six-source model. The developers warn that the piano stem can contain substantial bleed and artifacts, so audition it before using it in an edit.
Will Demucs produce perfectly isolated instruments?
Treat the results as estimated stems and check them by ear. Piano separation has a documented problem with other instruments leaking through and audible artifacts.
Does the 7.8-second limit restrict the length of my song?
That limit applies to processing segments in Hybrid Transformer Demucs. Demucs can split a recording into chunks and combine their predictions, so segment length is different from song length.
When should I increase random shifts?
Try more shifts when separation quality matters more than processing time. Demucs averages repeated predictions, so compare the result with your first pass before adopting the change.
Start using Demucs in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


