first

README.md

@@ -1,3 +1,32 @@
 # audio-transcription
 
-Generated by AppFactory.
+Stateless FastAPI služba (AppFactory) pro přepis audia. Přijme audio soubor + parametry
+v POST a vrátí JSON. Přepis běží paralelně dvěma engine — **Deepgram** a **OpenAI Whisper**
+— a volitelně se oba texty sloučí přes OpenAI Chat do jednoho co nejpřesnějšího přepisu.
+
+Port původní .NET implementace `CallCenterController` (dual/combined přepis); napojení na
+Twilio bylo vynecháno — audio se posílá přímo jako proměnná (upload).
+
+## Endpointy
+
+- `GET /health` — health check
+- `GET /version` — verze + root_path
+- `POST /transcribe/dual` — Deepgram + Whisper (dva nezávislé texty)
+- `POST /transcribe/combined` — dual + sloučený `merged`
+
+Swagger: `/docs`.
+
+## Přihlašovací údaje (hlavičky)
+
+- `X-Deepgram-Api-Key`
+- `X-OpenAI-Api-Key`
+
+## Lokální běh
+
+```bash
+pip install -r requirements.txt
+uvicorn app.main:app --host 0.0.0.0 --port 8000
+```
+
+Podrobná dokumentace: [documentation/overview.md](documentation/overview.md),
+[documentation/transcribe.md](documentation/transcribe.md).