Repository navigation
Transcribe on Modal
[transcribe] backend = "modal" runs the same WhisperX (same pinned versions, large-v3, word
alignment) on a Modal cloud GPU, so any machine can be the worker and the
transcripts match the local ones (99.9% of words identical on an 8 h test stream). The Starter
plan includes $30 of compute a month. Measured on that 8 h stream: L40S (default) 10 min,
~$0.34; L4 19 min, ~$0.26 (cheapest per hour of audio, for bulk); H100 8 min, ~$0.59.
- Make a Modal account, then Settings → API Tokens → New token. Set the two values as
Windows user environment variables
MODAL_TOKEN_IDandMODAL_TOKEN_SECRET(or run.venv/Scripts/python.exe -m modal token new, which writes~/.modal.toml). -
uv sync --extra modal(add it to the other extras you use;--extra gpuisn't needed for this backend). -
clippa transcribe --deploybuilds and deploys the app inclippa/modal_app.py. The first build takes several minutes (it bakes the models into the image); re-run it after changing that file. - In clipper.toml (or
CLIPPER_TRANSCRIBE_BACKEND=modalon one machine):[transcribe] backend = "modal" modal_gpu = "L40S" # T4 | L4 | A10 | L40S | A100 | H100 modal_audio = "flac" # lossless upload, ~60 MB per hour of audio; "opus" is smaller
-
clippa doctor --role gpuchecks the package, the token and that the app is deployed.
Each run prints the GPU, the call time and an estimated cost, and keeps them under "modal" in
transcript.json. The estimate is an upper bound (it counts upload and cold start).
Every Modal call also writes a start and an end line to [paths] modal_runs (logs/modal_runs.jsonl). clippa modal (and the war room's Modal panel) shows
GPUs up, runs going now, failures, recent runs, each archive's progress and ETA, and the
month's spend from Modal's own billing: metered, credit, billed, the last 24 h and the rate
over the last 3 hours. The per-run estimates are only a guide; billing is the real number.
The bot DMs ([notify] kind spend) each time the month passes a multiple of [modal] alert_every_usd (25); set monthly_budget_usd to show the month against your own ceiling.
The process that serves the war room (clippa serve) needs the Modal token, as the worker does.
On a new install, clippa modal --backfill adds the runs from before the log, once.
Home · Getting started · clippa doctor · These pages are built from docs/wiki/ in the repo, so edits made here are overwritten: how to edit them
Run it
- Overview
- Getting started
- Roles and services
- Configuration
- Pipeline
- Review
- Reviewing
- War room
- Clippa messenger
- Scheduling and uploads
- Costs
- Checkup
- Audit
- Backups
Install
- Install
- Install checklist
- Kitsu
- Discord app
- YouTube sign-in
- Windows
- macOS
- Transcribe on Modal
- NAS recorder
- NAS hub
- Claude on the NAS
- Phone access
- Model providers
- Adding a show
- YouTube channel
Features
- Pre-shows
- Fetching VODs
- Speakers
- Faces
- Covers
- Cast library
- B-roll
- Clip art
- Weekly issue
- X posts
- TikTok
- News watcher
- Character pieces
- Documentaries
Research
Working on Clippa