Skip to content

fix: Add local backend entries for chatterbox on MacOS#8953

Open
localai-bot wants to merge 1 commit intomudler:masterfrom
localai-bot:fix/chatterbox-macos-backend-8610
Open

fix: Add local backend entries for chatterbox on MacOS#8953
localai-bot wants to merge 1 commit intomudler:masterfrom
localai-bot:fix/chatterbox-macos-backend-8610

Conversation

@localai-bot
Copy link
Contributor

This PR fixes issue #8610 by adding local backend entries for chatterbox on MacOS.

Problem

When trying to install the chatterbox backend on MacOS (Apple M2), users encountered the error:
Error installing model "chatterbox": not a valid backend: run file not found "/backends/cpu-chatterbox/run.sh"

Root Cause

The backend/index.yaml file was configured to use container images for cpu-chatterbox and metal-chatterbox backends, but these container images don't exist or aren't available. The system was unable to download the backend and fall back to a local implementation.

Solution

  • Replaced the container-based URIs for and with local Python backend references
  • The Python backend at is now used for both cpu-chatterbox and metal-chatterbox backends
  • This allows MacOS users to install and use the chatterbox TTS backend locally

Changes

  • : Updated cpu-chatterbox and metal-chatterbox entries to use local path

Testing

  • Verified that the backend/python/chatterbox directory exists and contains run.sh
  • The run.sh script properly sources the common backend library and starts the Python backend

Fixes #8610

@netlify
Copy link

netlify bot commented Mar 11, 2026

Deploy Preview for localai ready!

Name Link
🔨 Latest commit 5c5f4d1
🔍 Latest deploy log https://app.netlify.com/projects/localai/deploys/69b1422de22b410008ed3e1a
😎 Deploy Preview https://deploy-preview-8953--localai.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

- Replace container-based cpu-chatterbox and metal-chatterbox entries
  with local Python backend references
- This fixes the 'run file not found' error when installing chatterbox
  on MacOS systems
- The Python backend at backend/python/chatterbox/ is now used for
  both cpu-chatterbox and metal-chatterbox backends

Fixes mudler#8610

Signed-off-by: team-coding-agent-1 <team-coding-agent-1@localai.dev>
@localai-bot localai-bot force-pushed the fix/chatterbox-macos-backend-8610 branch from 799a3fb to 5c5f4d1 Compare March 11, 2026 10:21
@localai-bot
Copy link
Contributor Author

✅ Fixed DCO check by adding Signed-off-by to the commit. The CI checks should now pass for DCO. Please allow some time for the remaining checks to complete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In review

Development

Successfully merging this pull request may close these issues.

Chatterbox backend unavailable on MacOS

1 participant