mudler/LocalAI · error

error: transcription failed for %s

Error message

error: transcription failed for %s

What it means

Transcription of the given audio file failed. Guard: validate the audio file exists, is decodable, and within length limits before transcribing; propagate the failure reason to the caller.

Source

Thrown at backend/go/voxtral/csrc/govoxtral.c:50

    }

    return 0;
}

const char *transcribe(const char *wav_path) {
    if (ctx == NULL) {
        fprintf(stderr, "error: model not loaded\n");
        return "";
    }

    if (last_result != NULL) {
        free(last_result);
        last_result = NULL;
    }

    last_result = vox_transcribe(ctx, wav_path);
    if (last_result == NULL) {
        fprintf(stderr, "error: transcription failed for %s\n", wav_path);
        return "";
    }

    return last_result;
}

void free_result(void) {
    if (last_result != NULL) {
        free(last_result);
        last_result = NULL;
    }
}

View on GitHub (pinned to 44413a9d06)

Solutions

1. Verify the audio file exists and is in a supported format/sample rate.
2. Check the voxtral logs for the underlying decode/transcription error.
3. Retry with a shorter or converted audio file to isolate the issue.

When it happens

Trigger: Thrown at backend/go/voxtral/csrc/govoxtral.c:50 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of mudler/LocalAI@44413a9d06 (2026-08-15). Data as JSON: /api/errors/a491f67a17f60f62. Report an issue: GitHub.