efforting.tech/tts-server
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Replace HTTP API with WebSocket server #4

Merged
mikael-lovqvist merged 1 commits from mikael-lovqvists-claude-agent/tts-server:websocket-api into main 2026-06-09 21:35:49 +00:00
Conversation 0 Commits 1 Files Changed 7 +310 -127
mikael-lovqvists-claude-agent commented 2026-06-09 21:35:09 +00:00
Contributor
Copy Link

Summary

  • Replaces the HTTP POST API with a WebSocket server on the same single port (TTS_PORT)
  • Adds a job queue + generation worker so requests are non-blocking; playback events (queued, started, finished, aborted, error) are broadcast to all connected clients
  • Adds abort_current (kills active playback, advances queue) and abort_all (kills + drains queues)
  • Fixes BrokenPipeError when pacat is killed mid-write during abort
  • Updates all examples to use WebSocket; adds abort-demo.mjs
  • Adds websockets to setup-venv.sh

Test plan

  • ./chatterbox-server.py starts and logs listening on port 11500
  • node examples/speak.mjs "hello" plays audio and exits
  • node examples/abort-demo.mjs speaks then cuts off after 3 seconds
  • node examples/terminate.mjs shuts down the server cleanly
## Summary - Replaces the HTTP POST API with a WebSocket server on the same single port (`TTS_PORT`) - Adds a job queue + generation worker so requests are non-blocking; playback events (`queued`, `started`, `finished`, `aborted`, `error`) are broadcast to all connected clients - Adds `abort_current` (kills active playback, advances queue) and `abort_all` (kills + drains queues) - Fixes `BrokenPipeError` when `pacat` is killed mid-write during abort - Updates all examples to use WebSocket; adds `abort-demo.mjs` - Adds `websockets` to `setup-venv.sh` ## Test plan - [ ] `./chatterbox-server.py` starts and logs `listening on port 11500` - [ ] `node examples/speak.mjs "hello"` plays audio and exits - [ ] `node examples/abort-demo.mjs` speaks then cuts off after 3 seconds - [ ] `node examples/terminate.mjs` shuts down the server cleanly
mikael-lovqvists-claude-agent added 1 commit 2026-06-09 21:35:10 +00:00
Replace HTTP API with WebSocket server f4ae96c6b9 
Single port (TTS_PORT) handles both the WS upgrade handshake and
connections. Adds job queue, generation worker, playback events
(queued/started/finished/aborted/error), and abort_current/abort_all
commands. Fixes BrokenPipeError when pacat is killed mid-write.
Updates all examples to use WebSocket; adds abort-demo.mjs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
mikael-lovqvist merged commit cfbbd528d3 into main 2026-06-09 21:35:49 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
mikael-lovqvist
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: efforting.tech/tts-server#4
Delete Branch "mikael-lovqvists-claude-agent/tts-server:websocket-api"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?