first commit

README.md

@@ -0,0 +1,27 @@
+# whisper-remote
+
+Two separate Python packages live in this repo:
+
+- `backend/`: FastAPI wrapper around the upstream `whisper` CLI
+- `cli/`: local `whisper-remote` command that forwards work to the remote API
+
+## Backend
+
+```bash
+cd backend
+pip install -e .
+uvicorn whisper_remote_backend.server:app --host 0.0.0.0 --port 8000
+```
+
+The backend machine must already have the upstream `whisper` CLI available on `PATH`.
+
+## CLI
+
+```bash
+cd cli
+pip install -e .
+export WHISPER_REMOTE=http://your-server:8000
+whisper-remote ./audio.mp3 --model base --language en --output-format txt
+```
+
+By default the CLI prints the transcript to stdout. Use `--to-file` to save the returned transcript locally.