From ad10a62ae63e1c2f3fd4438b0eeaed52075c86e4 Mon Sep 17 00:00:00 2001
From: space <space@reversed.dev>
Date: Sun, 24 May 2026 12:32:30 +0200
Subject: [PATCH] first commit

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..53e360a
--- /dev/null
+++ b/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.