STT

A FastAPI-based service for real-time speech-to-text using faster-whisper.

stt_preview.mov

Installation

# Install system requirements
sudo apt install libcublas-12-9 libcudnn9-cuda-12

# Install python dependencies
python3 src/setup.py
source src/stt-venv/bin/activate

Usage

Start the service:

cd src/
python app.py

Python example:

import requests

with open("audio.wav", "rb") as f:
    response = requests.post(
        "http://localhost:47102/transcribe",
        files={"file": f}
    )
    print(response.json()["text"])

Endpoints

Method	Path	Description
GET	/health	Check service health and loaded model
POST	/transcribe	Transcribe audio, with optional segments, word timestamps, or translation