Skip to main content

voicecast-worker

VoiceCast Worker lends your Mac to VoiceCast Studio. It pulls bite-size jobs from the studio's one job queue, does them on your GPU, and hands the results back:

  • pictures: FLUX.2 klein on Apple silicon with mflux, the model kept loaded (an M2 Ultra draws a picture in about 6 s, an M2 Max in about 20 s);
  • narration: one paragraph at a time with sonic-forge (Kokoro, and cloned voices on the Apple GPU), assembled by the studio with the same seeded pauses as a whole narration;
  • picture checks and whole renders: only on machines the studio owner trusts (renders need a checkout of the studio app).

Your own Mac makes your own videos first: the worker alternates one job for someone else, one of yours ("give one, take one"). It never opens a port: it calls the studio over HTTPS, and files travel by short-lived presigned URLs.

Install

pipx install 'voicecast-worker[pictures,voice,menubar]'
voicecast-worker join <join-token> --server https://voicecast.studio

Get the join token from the studio's Developers page ("Join a Mac"), or with voicecast worker join. Then run it in a terminal (voicecast-worker run) or from the menu bar (voicecast-worker menubar: Pause/Resume, Start at login).

Extras: pictures (mflux), voice (sonic-forge + Kokoro), clone (sonic-forge cloned voices on the Apple GPU), menubar (rumps), all.

When it works

voicecast-worker settings --gpu-max 35        # only while the GPU is quiet (someone else's model, a game)
voicecast-worker settings --user-idle 300     # only when you've been away 5 minutes
voicecast-worker settings --gpu-share 0.5     # rest as long as it worked
voicecast-worker settings --hours "22:00-08:00"
voicecast-worker pause / resume
voicecast-worker status
voicecast-worker doctor                       # which engines this Mac can run
voicecast-worker leave

State lives in ~/.voicecast/worker/ (an older ~/.video-maker-worker/ is still read) (config.json with the machine token, status.json, worker.log).

Privacy

What a machine may see depends on its trust, set by the join token: a person's own Mac (self) only takes their own jobs; a community Mac only takes public, bite-size jobs, never a cloned voice's reference, a real person's portrait, a presenter's take or a whole render. Work on a Mac is not encrypted while it runs there; that is why private and personal work only goes to machines that may see it.

Metadata

Release files for voicecast-worker 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for voicecast-worker 0.1.0
File Size Uploaded
voicecast_worker-0.1.0.tar.gz 27.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for voicecast-worker 0.1.0
File Interpreter ABI Platform
voicecast_worker-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 55.3 kB

Release files / voicecast_worker-0.1.0.tar.gz

Download URL voicecast_worker-0.1.0.tar.gz
Size 27.6 kB
Tags Source
SHA-256 checksum
How to use checksums
31c7f9636a3f1d5b3b82f02659beac0e369d899b1c1fcf25a5fb29dbbf60b671
BLAKE2b-256 checksum
How to use checksums
49598888dabdb1be6e02e4d21a68c0a64d7d90d05b976f50b058e9df3f2d74be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release files / voicecast_worker-0.1.0-py3-none-any.whl

Download URL voicecast_worker-0.1.0-py3-none-any.whl
Size 27.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6d3427989c60ad10a9f0e7392f609f5c1ed57ae8b620bf08eb8930553fa54968
BLAKE2b-256 checksum
How to use checksums
cf6431d5fb2232486b0fb47559acaf8164e540d9c34dc0d620629da0e27f02df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page