Skip to content
Back to search

soundbox

Open-source app that generates sound effects, music, text-to-speech and voice clones locally from open-weight models (Stable Audio, ACE-Step and more). No account, works offline. Desktop app for Windows and macOS, HTTP API, and a 21-tool MCP server for Claude Code and Cursor.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/HamSanders/soundbox with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/HamSanders/soundbox'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gadurp1--soundbox/badge.svg)](/listings/gadurp1--soundbox)

HTML

<a href="/listings/gadurp1--soundbox"><img src="/api/listings/gadurp1--soundbox/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 264 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # Soundbox
  3. **The free, open-source, local alternative to ElevenLabs and Suno.**
  4. Sound effects, music, songs with lyrics, speech and voice cloning from
  5. open-weight models on your own GPU. Arrange it on a timeline, or let Claude
  6. Code, Cursor or any MCP agent do it. No account, no credits, works offline. MIT.
  7. [Download](#download) · [Hear it](#hear-it) · [For agents](#for-agents) · [Models](#models) · [Docs](#docs) · [Website](https://hamsanders.github.io/soundbox/) · [Patreon](https://patreon.com/soundboxai)
  8. [![Latest release](https://img.shields.io/github/v/release/HamSanders/soundbox?label=release)](https://github.com/HamSanders/soundbox/releases/latest)
  9. [![Downloads](https://img.shields.io/github/downloads/HamSanders/soundbox/total?label=downloads)](https://github.com/HamSanders/soundbox/releases)
  10. [![MIT licence](https://img.shields.io/badge/licence-MIT-2ea44f)](LICENSE)
  11. [![MCP server](https://img.shields.io/badge/MCP-24%20tools-6b4fbb)](docs/MCP.md)
  12. [![Patreon](https://img.shields.io/badge/Patreon-support-f96854?logo=patreon&logoColor=white)](https://patreon.com/soundboxai)
  13. <img src="site/public/product/same-prompt-three-models.gif" alt="The same prompt and seed rendered by Stable Audio 3.0 Small Music, MiniMax Music 3 and ACE-Step 1.5 Turbo, with measured render times on an RTX 5080" width="880">
  14. **Watch:** [30-second tour](https://hamsanders.github.io/soundbox/media/soundbox-vibe.mp4) · [Under the hood](https://hamsanders.github.io/soundbox/media/soundbox-tech.mp4) · [Agents and MCP](https://hamsanders.github.io/soundbox/media/soundbox-agents.mp4)
  15. </div>
  16. ## Describe it, hear it, arrange it
  17. | Make | Arrange | Connect |
  18. |---|---|---|
  19. | Sound effects and ambience from a description | A multi-track timeline with effects, MIDI and mixdown | An MCP server with 24 tools for Claude Code and Cursor |
  20. | Instrumentals, or songs from a lyric sheet | Cast saved voices onto the lines of a script | A local HTTP API on port 17494 |
  21. | Speech, voice cloning and voice conversion | Extend, cover, repaint, split into stems | Three agent skills, including a full sound pass |
  22. Four models are verified end to end and on by default; 61 more can be switched
  23. on from the Models page. Each model's licence is shown before you download it.
  24. Everything stays in one SQLite file and a folder of WAVs under `~/.soundbox`.
  25. Profiles give you several libraries in one install, one per game or client,
  26. switched from the header without a restart; the models are shared.
  27. <details>
  28. <summary><b>Screenshots</b> · studio, music, SFX, Voice Lab, models</summary>
  29. <br>
  30. <img src="site/public/product/studio.png" alt="The Soundbox studio: a script cast across three speakers above a multi-track timeline holding the spoken lines, an ambient music bed and sound effects, with the library panel on the right" width="880">
  31. | | |
  32. |---|---|
  33. | <img src="site/public/product/music-studio.png" alt="The Music page: a request form with model, licence, styles, tempo, key and length beside a shelf of generated takes"> | <img src="site/public/product/sfx.png" alt="The SFX library with waveforms, models and seeds, and the prompt composer"> |
  34. | **Music.** A style prompt or a lyric sheet in, a shelf of takes out. | **Sound effects.** Every take kept with its prompt, model and seed. |
  35. | <img src="site/public/product/voice-lab.png" alt="The Voice Lab: saved voices as cards, cloned from a clip or built into a model"> | <img src="site/public/product/models.png" alt="The Models page: each model with its licence badge, size and install state"> |
  36. | **Voice Lab.** Clone a voice, then cast it onto script lines. | **Models.** Licence and VRAM shown before you download. |
  37. </details>
  38. ## Download
  39. The [download page](https://mirli.app/download/) picks the installer for your system. Or take one directly:
  40. | Platform | Installer |
  41. |---|---|
  42. | **Windows** 10 and 11 (x64) | [`Soundbox_x.y.z_x64-setup.exe`](https://mirli.app/download/) |
  43. | **macOS**, Apple silicon | [`Soundbox_x.y.z_aarch64.dmg`](https://mirli.app/download/) |
  44. | **macOS**, Intel | [`Soundbox_x.y.z_x64.dmg`](https://mirli.app/download/) |
  45. The installer carries its own runtime. The builds are not signed yet, so the
  46. first launch asks you to confirm ([where](docs/DESKTOP.md#installing)). Open
  47. SFX, describe the material, the action and the space, and generate: the first
  48. model downloads when you pick it, with its licence shown first.
  49. | Hardware | What to expect |
  50. |---|---|
  51. | NVIDIA GPU (Windows, Linux) | CUDA. A few GB of VRAM covers the verified models; MiniMax Music 3 wants about 10 GB. |
  52. | AMD or Intel GPU | Runs on the CPU unless you set `SOUNDBOX_AUDIOCPP_BACKEND=vulkan` ([how](docs/AUDIOCPP.md#choosing-a-backend)). Vulkan is not yet confirmed on the verified models; reports welcome. |
  53. | Apple silicon | Metal. Installers exist; none of the verified models has been confirmed on a Mac yet. |
  54. | No dedicated GPU | Works, slowly. A clip that takes seconds on a GPU takes minutes on the CPU. |
  55. Linux, Docker and running from source are under [Run from source](#run-from-source).
  56. ### Install with a prompt
  57. Paste this into Claude Code, Cursor or Codex:
  58. ```text
  59. Install Soundbox on this machine and confirm it works, following
  60. https://github.com/HamSanders/soundbox/blob/main/docs/INSTALL-AGENT.md
  61. ```
  62. The guide tells the agent to check the GPU and VRAM first, to show you each
  63. model's size and licence before downloading it, never to accept a
  64. non-commercial licence for you, and to finish by generating one sound and
  65. telling you where the WAV is.
  66. ## Hear it
  67. Each clip was generated by Soundbox from the prompt shown. The
  68. [samples site](https://hamsanders.github.io/soundbox/sfx/) has around 600 more.
  69. | | Prompt | Model | |
  70. |---|---|---|---|
  71. | Glass | *large window pane breaking, cracking then collapsing inward with long shards falling and shattering on a wooden floor* | Stable Audio 3.0 SFX | [▶ Listen](https://hamsanders.github.io/soundbox/sfx/glass/glass-window-pane-break) |
  72. | Ambience | *heavy thunderstorm, driving rain with rolling thunder and wind gusting through trees, outdoor, seamless loop* | Stable Audio 3.0 SFX | [▶ Listen](https://hamsanders.github.io/soundbox/sfx/rain/rain-thunderstorm-full) |
  73. | Game | *plasma bolt firing, thick electric discharge with a downward pitch sweep and a crackling tail* | Stable Audio 3.0 SFX | [▶ Listen](https://hamsanders.github.io/soundbox/sfx/laser/laser-plasma-bolt) |
  74. | Instrumental | *1980s synthwave arcade title theme, wide analog saw lead, gated reverb drum machine, pulsing sidechained bass, 110 BPM* | Stable Audio 3.0 Small Music | [▶ Listen](https://hamsanders.github.io/soundbox/music/neon-arcade-nights) |
  75. | Song | *triumphant power pop victory anthem, bright electric guitars, punchy live drums, gang vocal chorus*, with a four-line lyric sheet | ACE-Step 1.5 | [▶ Listen](https://hamsanders.github.io/soundbox/music/victory-lap) |
  76. ## For agents
  77. Start Soundbox, then add it to your client.
  78. ```bash
  79. claude mcp add --transport http soundbox http://127.0.0.1:17494/mcp
  80. ```
  81. Cursor and other MCP clients take `{ "type": "http", "url": "http://127.0.0.1:17494/mcp" }`.
  82. Then ask: "add a door slam and a coin pickup to this game", "voice these three
  83. lines as two characters", "write a 20-second loading-screen loop". The agent
  84. gets 24 tools for sounds, speech and multi-track stories, and three skills:
  85. `soundbox-sfx`, `soundbox-sound-pass` and `soundbox-voice-story`. Every tool,
  86. the stdio bridge and the skills are in [docs/MCP.md](docs/MCP.md).
  87. <img src="site/public/product/agents.png" alt="The Agents page: connected MCP clients, copy-paste connection commands, and a log of recent calls" width="880">
  88. ## Models
  89. Every model runs through [audio.cpp](docs/AUDIOCPP.md), a native runtime, so
  90. there is no Python to set up. Verified end to end and on by default:
  91. | Model | Good for | Licence | Commercial use |
  92. |---|---|---|---|
  93. | **Stable Audio 3.0 SFX** | Sound effects, foley, ambience | Stability AI Community | ⚠️ Under $1M revenue |
  94. | **Stable Audio 3.0 Small Music** | Instrumental music, loops | Stability AI Community | ⚠️ Under $1M revenue |
  95. | **ACE-Step 1.5 Turbo** | Songs with lyrics; extend, cover, repaint | MIT | ✅ Yes |
  96. | **MiniMax Music 3** | Songs with lyrics, about 10 GB VRAM | MiniMax-Music3 Community | ⚠️ Conditional |
  97. <details>
  98. <summary><b>61 more in the catalog</b> · 45 text-to-speech, 6 music, 2 SFX, 4 stem separation, 4 voice conversion</summary>
  99. <br>
  100. | Kind | Count | Includes |
  101. |---|---|---|
  102. | Text-to-speech | 45 | Chatterbox, Fish Audio S2 Pro, IndexTTS 2, VibeVoice, Higgs Audio v3, Qwen3-TTS, CosyVoice 3, Kokoro and more; several clone from a reference clip |
  103. | Music | 6 | ACE-Step 1.5 Base and XL, Stable Audio 3.0 Medium, HeartMuLa, MiniMax H3 |
  104. | Sound effects | 2 | MiDashengLM-Gen, ControlFoley |
  105. | Stem separation | 4 | HTDemucs (4- and 6-stem), BS-RoFormer, Mel-Band RoFormer |
  106. | Voice conversion | 4 | RVC, Seed-VC, MioCodec, MeanVC2 |
  107. VibeVoice 1.5B, MiDashengLM-Gen, HTDemucs 6-stem and Chatterbox Turbo have also
  108. been run end to end; the rest are marked unverified until someone reports. The
  109. 19 added in October 2026 need audio.cpp 0.9.2 or newer
  110. (`soundbox model install audiocpp` fetches the latest).
  111. </details>
  112. Any model whose licence could not be established is treated as non-commercial.
  113. This is a summary, not legal advice: read each licence before you ship what a
  114. model made.
  115. ## Compared with a hosted service
  116. | | Hosted (ElevenLabs, Suno and similar) | Soundbox |
  117. |---|---|---|
  118. | Runs on | Their GPUs | Your machine |
  119. | Cost | Subscription or credits | Your electricity |
  120. | Account | Required | None |
  121. | Models | Closed, tuned, consistent | Open weights; quality varies by model |
  122. | Output rights | Their terms of service | The licence of the model that made it, shown up front |
  123. | Offline | No | Yes, once the weights are downloaded |
  124. | Agents | HTTP API | HTTP API and an MCP server |
  125. | Source | Closed | MIT |
  126. ## Run from source
  127. <details>
  128. <summary><b>Node, Docker and the HTTP API</b></summary>
  129. <br>
  130. Requires Node 22.12 or later. No Python, no CUDA toolkit.
  131. ```bash
  132. git clone https://github.com/HamSanders/soundbox
  133. cd soundbox
  134. npm install
  135. npm run dev
  136. ```
  137. This starts the server on port 17494 and the UI on <http://localhost:5174>.
  138. `npm run dev:mock` runs the UI with no GPU or server (see [CONTRIBUTING.md](CONTRIBUTING.md)).
  139. **Docker.** The server and web UI run headless in one container with the
  140. audio.cpp runtime inside. CPU by default; add the CUDA override for a GPU. Both
  141. pull the prebuilt image from GHCR (`:latest`, `:cuda`, or a version such as
  142. `:v0.4.0` and `:v0.4.0-cuda`).
  143. ```bash
  144. docker compose up -d
  145. docker compose -f docker-compose.yml -f docker-compose.cuda.yml up -d
  146. ```
  147. To build from the checkout instead, add `-f docker-compose.build.yml`
  148. (and `-f docker-compose.build-cuda.yml` for CUDA) and `--build`; see
  149. [docs/INSTALL.md](docs/INSTALL.md#docker).
  150. There is no authentication unless you set `SOUNDBOX_API_TOKEN`, so keep the
  151. port on localhost, or set a token and serve it over HTTPS, and set
  152. `SOUNDBOX_ALLOWED_HOSTS` to the name you reach it by. Details are in
  153. [docs/INSTALL.md](docs/INSTALL.md#access-token).
  154. **HTTP API.** Everything the app does is available on port 17494:
  155. ```bash
  156. curl -X POST http://127.0.0.1:17494/api/generate \
  157. -H 'Content-Type: application/json' \
  158. -d '{"model":"audiocpp-stable-audio-3-sfx","prompt":"heavy wooden door slamming in a stone corridor","duration_s":3}'
  159. ```
  160. Long jobs return an id with a server-sent event stream. Every route is in
  161. [docs/API.md](docs/API.md).
  162. </details>
  163. ## Docs
  164. | If you want to | Read |
  165. |---|---|
  166. | Get it running, or fix a first run | [Install](docs/INSTALL.md) · [Desktop](docs/DESKTOP.md) |
  167. | Write prompts these models answer | [Generating](docs/GENERATING.md) |
  168. | Arrange, mix and export | [Studio](docs/STUDIO.md) · [Library](docs/LIBRARY.md) |
  169. | Drive it from an agent or a script | [MCP](docs/MCP.md) · [HTTP API](docs/API.md) |
  170. | Add or verify a model | [audio.cpp](docs/AUDIOCPP.md) · [Contributing](CONTRIBUTING.md) |
  171. | Understand how the pieces fit | [Architecture](docs/ARCHITECTURE.md) |
  172. ## FAQ
  173. **Can I sell what I make?** It depends on the model. Stable Audio is free under
  174. $1M revenue, ACE-Step 1.5 is MIT, and models with an unestablished licence are
  175. marked non-commercial. Each model's terms are on its card in the app.
  176. **Do I need a GPU?** No, but CPU generation is slow. The hardware table above
  177. says what to expect.
  178. **Does it work on a Mac?** There are installers for Apple silicon and Intel,
  179. and audio.cpp runs on Metal. None of the verified models has been confirmed on
  180. a Mac yet, so reports are welcome.
  181. **How do I remove it?** Delete the app and `~/.soundbox`. There is no account
  182. to close and nothing was uploaded.
  183. ## Star history
  184. <a href="https://www.star-history.com/#HamSanders/soundbox&Date">
  185. <picture>
  186. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=HamSanders/soundbox&type=Date&theme=dark" />
  187. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=HamSanders/soundbox&type=Date" />
  188. <img alt="Star history chart for HamSanders/soundbox" src="https://api.star-history.com/svg?repos=HamSanders/soundbox&type=Date" />
  189. </picture>
  190. </a>
  191. ## Licence
  192. Soundbox is [MIT](LICENSE). The model weights are not: each carries its own
  193. licence, and what you can do with generated audio is governed by the licence of
  194. the model that made it. Clone only voices you have permission to use. Soundbox
  195. downloads weights at your direction and does not redistribute them. Example
  196. media under `site/public/` was generated with third-party models; its
  197. provenance is in [ASSETS.md](ASSETS.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.