engineering/make_post_sell
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases 2 Packages Wiki Activity Actions

docs: add karaoke pipeline architecture to CLAUDE.md

Browse source 
Disk-backed vocal isolation pipeline, 3.698GB upstream limit,
concurrency, retry, and caller documentation.
This commit is contained in:
russell@unturf.com 2026-02-19 17:56:23 -05:00
parent 046fb1342d
commit 3fbef65b20
1 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

12
CLAUDE.md
View file

@ -20,6 +20,18 @@ Files are NEVER streamed through uwsgi. The server only generates presigned URLs
- **Uploads**: presigned `post` → client uploads directly to Spaces
- **Thumbnails**: public CDN URLs with `?ts=` cache busting
### Karaoke Pipeline (lib/karaoke.py)
Disk-backed vocal isolation pipeline. Downloads media from S3, builds a JSON
request on disk with streaming base64 encoding, POSTs to unsandbox API, streams
response to disk, decodes artifacts one at a time and uploads to S3.
- **Concurrency**: `ThreadPoolExecutor` sized to account's unsandbox concurrency limit
- **Memory**: ~64KB per worker on the request side (disk-backed, not in-memory)
- **Upstream limit**: 3.698GB / 3,698,742,051 bytes per file (unsandbox `@max_upload_bytes`)
- **Retries**: 3 attempts with exponential backoff (5s, 10s)
- **Callers**: `views/product.py`, `views/shop.py` (backfill), `scripts/backfill_karaoke.py`
## Project Setup
This project uses a Makefile for most development operations. Use `make` commands instead of running tools directly.