fc-plugin-codbi/com.github.xima_formcycle_entwicklerkreis.fc.plugin.codbi.logic.cb.ai.commons/WhisperServerManager

WhisperServerManager

class WhisperServerManager(log: (CodBi.LogLevel, String) -> Unit)

Manages the full lifecycle of a local whisper-server instance: binary download, FFmpeg provisioning, process launch, health-checking, resource monitoring, and shutdown.

Extracted from Whisper.kt so the servlet class only handles configuration and request routing.

Parameters

log

Logging callback (LogLevel, message).

Constructors

WhisperServerManager

constructor(log: (CodBi.LogLevel, String) -> Unit)

Types

Companion

object Companion

Properties

detectedGpu

var detectedGpu: PlatformDetector.GpuBackend

GPU backend detected at initialization.

ffmpegAvailable

var ffmpegAvailable: Boolean

true when ffmpeg is available, enabling the --convert flag.

loadError

@Volatile

var loadError: Throwable?

Captures the first fatal error during background initialization, if any.

serverPort

@Volatile

var serverPort: Int

The TCP port the running server listens on. 0 means no server is running.

serverReady

@Volatile

var serverReady: Boolean

true once the whisper-server is healthy and accepting requests.

Functions

estimateWaitSeconds

fun estimateWaitSeconds(): Int

Estimated seconds the client should wait before retrying.

exceedReason

fun exceedReason(): String?

Returns a human-readable reason if resource thresholds are exceeded, or null if available.

setExternalReady

fun setExternalReady()

Marks the server as ready without starting a local process (external API mode).

shutdown

fun shutdown()

Stops the resource monitor, kills the server process, and resets readiness state.

startAsync

fun startAsync(preferredPort: Int, whisperRelease: String, whisperReleaseBaseUrl: String, modelUrl: String, modelsDir: File, binDir: File, whisperDir: File, noGpu: Boolean, threadCount: Int?, maxRAMPercent: Double, maxComputePercent: Double, onReady: (port: Int) -> Unit)

Starts background initialization: downloads the whisper-server binary and model, ensures ffmpeg, launches the server, and starts the resource monitor.