stt

type GoogleSTTProvider ¶

type GoogleSTTProvider struct {
	APIKey     string
	Model      string // "chirp_3", "chirp_2", "latest_long"
	BaseURL    string // Override for testing; defaults to googleSTTBaseURL
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

GoogleSTTProvider implements STTProvider for Google Cloud Speech-to-Text v1 REST API.

BaseURL is user-configurable (for testing or regional endpoints). It is validated against Validation on every request. Default Validation is strict (public https only).

func NewGoogleSTTProvider(apiKey, model string) *GoogleSTTProvider

func (p *GoogleSTTProvider) Health(ctx context.Context) error

func (p *GoogleSTTProvider) Name() string

func (p *GoogleSTTProvider) Transcribe(ctx context.Context, audio []byte, opts TranscribeOpts) (*Result, error)

type HuggingFaceProvider ¶

type HuggingFaceProvider struct {
	Model      string
	Token      string
	BaseURL    string // Override for testing; defaults to hfBaseURL
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

HuggingFaceProvider implements STTProvider for Tier 3: HuggingFace Inference API.

BaseURL is user-configurable. It is validated against Validation on every request. Default Validation is strict (public https only).

func NewHuggingFaceProvider(model, token string) *HuggingFaceProvider

func (p *HuggingFaceProvider) Health(ctx context.Context) error

func (p *HuggingFaceProvider) Name() string

func (p *HuggingFaceProvider) Transcribe(ctx context.Context, audio []byte, opts TranscribeOpts) (*Result, error)

type InstallStatus ¶ added in v0.17.0

type InstallStatus struct {
	BinaryFound bool     `json:"binaryFound"`
	BinaryPath  string   `json:"binaryPath"`
	ModelFound  bool     `json:"modelFound"`
	ModelPath   string   `json:"modelPath"`
	ModelBytes  int64    `json:"modelBytes"`
	ServerReady bool     `json:"serverReady"`
	Problems    []string `json:"problems,omitempty"`
}

InstallStatus describes what's present and what's missing for local STT.

type LocalProvider ¶

type LocalProvider struct {
	BaseURL    string // e.g. "http://127.0.0.1:8080"
	Port       int
	ModelPath  string
	GPU        string
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

LocalProvider implements STTProvider for Tier 1: localhost whisper.cpp server.

func NewLocalProvider(port int, modelPath, gpu string) *LocalProvider

func (p *LocalProvider) Health(ctx context.Context) error

func (p *LocalProvider) IsReady() bool

func (p *LocalProvider) Name() string

func (p *LocalProvider) StartServer(ctx context.Context) error

func (p *LocalProvider) StopServer()

func (p *LocalProvider) Transcribe(ctx context.Context, audioData []byte, opts TranscribeOpts) (*Result, error)

func (p *LocalProvider) VerifyInstallation() InstallStatus

type OpenAICompatibleProvider ¶

type OpenAICompatibleProvider struct {
	BaseURL    string
	APIKey     string
	Model      string
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

OpenAICompatibleProvider implements STTProvider for any endpoint speaking the OpenAI /v1/audio/transcriptions API (OpenAI, Groq, VPS whisper-server, etc.).

BaseURL is user-supplied configuration. It is validated against Validation on every request (Transcribe, Health). The default Validation is strict: only public https:// endpoints are accepted. Self-hosted VPS and local whisper-server require relaxing Validation — see NewVPSProvider.

func NewGroqSTTProvider(apiKey string) *OpenAICompatibleProvider

func NewOllamaSTTProvider(baseURL, model string) *OpenAICompatibleProvider

func NewOpenAICompatibleProvider(name, baseURL, apiKey, model string) *OpenAICompatibleProvider

func NewOpenAISTTProvider(apiKey string) *OpenAICompatibleProvider

func NewVPSProvider(baseURL, apiKey string) *OpenAICompatibleProvider

func NewVPSProviderWithModel(baseURL, apiKey, model string) *OpenAICompatibleProvider

func (p *OpenAICompatibleProvider) Health(ctx context.Context) error

func (p *OpenAICompatibleProvider) Name() string

func (p *OpenAICompatibleProvider) Transcribe(ctx context.Context, audio []byte, opts TranscribeOpts) (*Result, error)

type OpenRouterSTTProvider ¶ added in v0.28.2

type OpenRouterSTTProvider struct {
	BaseURL    string
	APIKey     string
	Model      string
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

OpenRouterSTTProvider implements OpenRouter's JSON speech-to-text endpoint. OpenRouter is a cloud gateway, not a direct model provider, and its STT API accepts base64 audio rather than OpenAI's multipart Whisper shape.

func NewOpenRouterSTTProvider(apiKey, model string) *OpenRouterSTTProvider

func (p *OpenRouterSTTProvider) Health(ctx context.Context) error

func (p *OpenRouterSTTProvider) Name() string

func (p *OpenRouterSTTProvider) Transcribe(ctx context.Context, audio []byte, opts TranscribeOpts) (*Result, error)

type Result ¶

type Result struct {
	Text       string
	Language   string
	Duration   time.Duration
	Provider   string
	Model      string
	Confidence float64 // If available from the provider
}

Result holds the output of a transcription.

type STTProvider ¶

type STTProvider interface {
	// Transcribe sends audio data to the STT backend and returns the transcription.
	Transcribe(ctx context.Context, audio []byte, opts TranscribeOpts) (*Result, error)

	// Name returns the provider identifier (e.g. "local", "vps", "huggingface").
	Name() string

	// Health checks if the provider is reachable and ready.
	Health(ctx context.Context) error
}

STTProvider defines the interface for all speech-to-text backends.

type TranscribeOpts ¶

type TranscribeOpts struct {
	Language string // "de", "en", "auto"
	Model    string // Optional: model override
	Prompt   string // Optional: provider-specific hint prompt for better recognition
}

TranscribeOpts configures a single transcription request.

type VPSProvider ¶

type VPSProvider = OpenAICompatibleProvider

VPSProvider is an alias for backward compatibility. Use OpenAICompatibleProvider directly for new code.