#include "parakeet.h" #include "parakeet-arch.h" #include "ggml.h" #include "ggml-cpp.h" #include "ggml-alloc.h" #include "ggml-backend.h" #include #include #include #include #define _USE_MATH_DEFINES #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef _MSC_VER #include #endif #if defined(PARAKEET_BIG_ENDIAN) template static T byteswap(T value) { T value_swapped; char * source = reinterpret_cast(&value); char * target = reinterpret_cast(&value_swapped); int size = sizeof(T); for (int i = 0; i < size; i++) { target[size - 1 - i] = source[i]; } return value_swapped; } template static void byteswap_tensor_data(ggml_tensor * tensor) { T * datum = reinterpret_cast(tensor->data); for (int i = 0; i < ggml_nelements(tensor); i++) { datum[i] = byteswap(datum[i]); } } static void byteswap_tensor(ggml_tensor * tensor) { switch (tensor->type) { case GGML_TYPE_I16: { byteswap_tensor_data(tensor); break; } case GGML_TYPE_F16: { byteswap_tensor_data(tensor); break; } case GGML_TYPE_I32: { byteswap_tensor_data(tensor); break; } case GGML_TYPE_F32: { byteswap_tensor_data(tensor); break; } default: { // GML_TYPE_I8 break; } } } #define BYTESWAP_VALUE(d) d = byteswap(d) #define BYTESWAP_FILTERS(f) \ do { \ for (auto & datum : f.data) { \ datum = byteswap(datum); \ } \ } while (0) #define BYTESWAP_TENSOR(t) \ do { \ byteswap_tensor(t); \ } while (0) #else #define BYTESWAP_VALUE(d) do {} while (0) #define BYTESWAP_FILTERS(f) do {} while (0) #define BYTESWAP_TENSOR(t) do {} while (0) #endif #ifdef __GNUC__ #ifdef __MINGW32__ #define PARAKEET_ATTRIBUTE_FORMAT(...) __attribute__((format(gnu_printf, __VA_ARGS__))) #else #define PARAKEET_ATTRIBUTE_FORMAT(...) __attribute__((format(printf, __VA_ARGS__))) #endif #else #define PARAKEET_ATTRIBUTE_FORMAT(...) #endif // // logging // PARAKEET_ATTRIBUTE_FORMAT(2, 3) static void parakeet_log_internal (ggml_log_level level, const char * format, ...); static void parakeet_log_callback_default(ggml_log_level level, const char * text, void * user_data); #define PARAKEET_LOG_ERROR(...) parakeet_log_internal(GGML_LOG_LEVEL_ERROR, __VA_ARGS__) #define PARAKEET_LOG_WARN(...) parakeet_log_internal(GGML_LOG_LEVEL_WARN , __VA_ARGS__) #define PARAKEET_LOG_INFO(...) parakeet_log_internal(GGML_LOG_LEVEL_INFO , __VA_ARGS__) // define this to enable verbose trace logging - useful for debugging purposes //#define PARAKEET_DEBUG #if defined(PARAKEET_DEBUG) #define PARAKEET_LOG_DEBUG(...) parakeet_log_internal(GGML_LOG_LEVEL_DEBUG, __VA_ARGS__) #else #define PARAKEET_LOG_DEBUG(...) #endif #define PARAKEET_ASSERT(x) \ do { \ if (!(x)) { \ PARAKEET_LOG_ERROR("PARAKEET_ASSERT: %s:%d: %s\n", __FILE__, __LINE__, #x); \ abort(); \ } \ } while (0) #define PARAKEET_MAX_NODES 8192 // Threshold for when local attention should be used. // 8192 frames x 80ms = 655 s (about 10.9 mins) static constexpr int PARAKEET_LOCAL_ATTN_THRESHOLD = 8192; // Window of context in each director of the current token. // 128 frames * 80ms = 10.24 s static constexpr int PARAKEET_LOCAL_ATTN_WINDOW = 128; static std::string format(const char * fmt, ...) { va_list ap; va_list ap2; va_start(ap, fmt); va_copy(ap2, ap); int size = vsnprintf(NULL, 0, fmt, ap); GGML_ASSERT(size >= 0 && size < INT_MAX); // NOLINT std::vector buf(size + 1); int size2 = vsnprintf(buf.data(), size + 1, fmt, ap2); GGML_ASSERT(size2 == size); va_end(ap2); va_end(ap); return std::string(buf.data(), size); } // // ggml helpers // static bool ggml_graph_compute_helper( struct ggml_cgraph * graph, int n_threads, ggml_abort_callback abort_callback, void * abort_callback_data) { ggml_backend_ptr backend { ggml_backend_init_by_type(GGML_BACKEND_DEVICE_TYPE_CPU, nullptr) }; auto * reg = ggml_backend_dev_backend_reg(ggml_backend_get_device(backend.get())); auto * set_abort_callback_fn = (ggml_backend_set_abort_callback_t) ggml_backend_reg_get_proc_address(reg, "ggml_backend_set_abort_callback"); if (set_abort_callback_fn) { set_abort_callback_fn(backend.get(), abort_callback, abort_callback_data); } auto ggml_backend_set_n_threads_fn = (ggml_backend_set_n_threads_t) ggml_backend_reg_get_proc_address(reg, "ggml_backend_set_n_threads"); if (ggml_backend_set_n_threads_fn) { ggml_backend_set_n_threads_fn(backend.get(), n_threads); } return ggml_backend_graph_compute(backend.get(), graph) == GGML_STATUS_SUCCESS; } static bool ggml_graph_compute_helper( ggml_backend_sched_t sched, struct ggml_cgraph * graph, int n_threads, bool sched_reset = true) { for (int i = 0; i < ggml_backend_sched_get_n_backends(sched); ++i) { ggml_backend_t backend = ggml_backend_sched_get_backend(sched, i); ggml_backend_dev_t dev = ggml_backend_get_device(backend); ggml_backend_reg_t reg = dev ? ggml_backend_dev_backend_reg(dev) : nullptr; auto * fn_set_n_threads = (ggml_backend_set_n_threads_t) ggml_backend_reg_get_proc_address(reg, "ggml_backend_set_n_threads"); if (fn_set_n_threads) { fn_set_n_threads(backend, n_threads); } } const bool t = (ggml_backend_sched_graph_compute(sched, graph) == GGML_STATUS_SUCCESS); if (!t || sched_reset) { ggml_backend_sched_reset(sched); } return t; } // TODO: move these functions to ggml-base with support for ggml-backend? struct parakeet_mel { int n_len = 0; int n_len_org = 0; int n_mel = 0; std::vector data; }; struct parakeet_filters { int32_t n_mel = 0; int32_t n_fb = 0; // number of frequency bins std::vector data; }; struct parakeet_vocab { using id = int32_t; using token = std::string; int n_vocab = 8192; size_t max_token_length = 0; std::map token_to_id; std::map id_to_token; id token_unk; id token_bos; id token_blank; id token_eos; }; struct parakeet_segment { int64_t t0; int64_t t1; std::string text; std::vector tokens; }; struct parakeet_batch { int32_t n_tokens; parakeet_token * token; int32_t * i_time; // index of the audio frame parakeet_pos * pos; int32_t * n_seq_id; // always 1, here for consistency with llama.cpp parakeet_seq_id ** seq_id; // null terminated int8_t * logits; }; // ggml_backend_sched wrapper for parakeet usage struct parakeet_sched { ggml_backend_sched_t sched = nullptr; std::vector meta; }; // TODO: Find out is there a multiple version types. It is not yet clear to me // at this point. enum parakeet_arch { PARAKEET_ARCH_UNKNOWN = 0, PARAKEET_ARCH_TDT = 1, // NVIDIA Parakeet TDT (RNN-T) }; struct parakeet_hparams { int32_t n_vocab = 8192; int32_t n_audio_ctx = 0; // 0 = unlimited, will be set based on input int32_t n_audio_state = 1024; int32_t n_audio_head = 8; int32_t n_audio_layer = 24; int32_t n_mels = 128; int32_t ftype = 1; int32_t n_fft = 512; // FFT size for mel spectrogram float eps = 1e-5f; int32_t subsampling_factor = 8; int32_t n_subsampling_channels = 256; int32_t n_conv_kernel = 9; int32_t n_pred_dim = 640; int32_t n_pred_layers = 2; int32_t n_tdt_durations = 5; int32_t n_max_tokens = 10; parakeet_arch arch = PARAKEET_ARCH_TDT; }; struct parakeet_layer_encoder { struct ggml_tensor * norm_ff1_w = nullptr; struct ggml_tensor * norm_ff1_b = nullptr; struct ggml_tensor * ff1_linear1_w = nullptr; struct ggml_tensor * ff1_linear2_w = nullptr; struct ggml_tensor * norm_conv_w = nullptr; struct ggml_tensor * norm_conv_b = nullptr; struct ggml_tensor * conv_pw1_w = nullptr; // pointwise_conv1 struct ggml_tensor * conv_dw_w = nullptr; // depthwise_conv struct ggml_tensor * conv_bn_w = nullptr; // batch_norm weight struct ggml_tensor * conv_bn_b = nullptr; // batch_norm bias struct ggml_tensor * conv_bn_mean = nullptr; // batch_norm running_mean struct ggml_tensor * conv_bn_var = nullptr; // batch_norm running_var struct ggml_tensor * conv_bn_num_batches = nullptr; // batch_norm num_batches_tracked struct ggml_tensor * conv_pw2_w = nullptr; // pointwise_conv2 struct ggml_tensor * norm_attn_w = nullptr; struct ggml_tensor * norm_attn_b = nullptr; struct ggml_tensor * attn_pos_bias_u = nullptr; struct ggml_tensor * attn_pos_bias_v = nullptr; struct ggml_tensor * attn_q_w = nullptr; struct ggml_tensor * attn_k_w = nullptr; struct ggml_tensor * attn_v_w = nullptr; struct ggml_tensor * attn_out_w = nullptr; struct ggml_tensor * attn_pos_w = nullptr; struct ggml_tensor * norm_ff2_w = nullptr; struct ggml_tensor * norm_ff2_b = nullptr; struct ggml_tensor * ff2_linear1_w = nullptr; struct ggml_tensor * ff2_linear2_w = nullptr; struct ggml_tensor * norm_out_w = nullptr; struct ggml_tensor * norm_out_b = nullptr; }; struct parakeet_lsmt_layer { struct ggml_tensor * ih_w = nullptr; // input-to-hidden weight struct ggml_tensor * hh_w = nullptr; // hidden-to-hidden weight struct ggml_tensor * b_h = nullptr; // bias (ih folded into hh at conversion time) }; struct parakeet_prediction_network { struct ggml_tensor * embed_w = nullptr; std::vector lstm_layer; }; struct parakeet_joint_network { struct ggml_tensor * pred_w = nullptr; struct ggml_tensor * pred_b = nullptr; struct ggml_tensor * enc_w = nullptr; struct ggml_tensor * enc_b = nullptr; struct ggml_tensor * net_w = nullptr; struct ggml_tensor * net_b = nullptr; }; struct parakeet_model { parakeet_filters filters; parakeet_hparams hparams; struct ggml_tensor * enc_pre_out_w = nullptr; struct ggml_tensor * enc_pre_out_b = nullptr; struct ggml_tensor * enc_pre_conv_0_w = nullptr; struct ggml_tensor * enc_pre_conv_0_b = nullptr; struct ggml_tensor * enc_pre_conv_2_w = nullptr; struct ggml_tensor * enc_pre_conv_2_b = nullptr; struct ggml_tensor * enc_pre_conv_3_w = nullptr; struct ggml_tensor * enc_pre_conv_3_b = nullptr; struct ggml_tensor * enc_pre_conv_5_w = nullptr; struct ggml_tensor * enc_pre_conv_5_b = nullptr; struct ggml_tensor * enc_pre_conv_6_w = nullptr; struct ggml_tensor * enc_pre_conv_6_b = nullptr; std::vector layers; parakeet_prediction_network prediction; parakeet_joint_network joint; std::vector tdt_durations; std::vector ctxs; std::vector buffers; int n_loaded = 0; std::map tensors; }; struct parakeet_lstm_state_layer { struct ggml_tensor * h_state = nullptr; struct ggml_tensor * c_state = nullptr; }; struct parakeet_lstm_state { std::vector layer; std::vector ctx_buf; ggml_backend_buffer_t buffer = nullptr; }; struct parakeet_state { int64_t t_sample_us = 0; int64_t t_encode_us = 0; int64_t t_decode_us = 0; int64_t t_predict_us = 0; int64_t t_predict_build_us = 0; // time spent building the prediction graph int64_t t_predict_alloc_us = 0; // time spent in ggml_backend_sched_alloc_graph int64_t t_predict_compute_us = 0; // time spent in ggml_graph_compute_helper int64_t t_mel_us = 0; int32_t n_sample = 0; // number of tokens sampled int32_t n_encode = 0; // number of encoder calls int32_t n_decode = 0; // number of decoder calls with n_tokens == 1 (text-generation) int32_t n_predict = 0; // number of prediction network calls int32_t n_fail_p = 0; // number of logprob threshold failures int32_t n_fail_h = 0; // number of entropy threshold failures parakeet_mel mel; parakeet_batch batch; int n_frames = 0; std::vector backends; parakeet_sched sched_encode; parakeet_sched sched_decode; // outputs from encoder stages struct ggml_tensor * enc_out = nullptr; struct ggml_tensor * pred_out = nullptr; std::vector enc_out_buf; ggml_backend_buffer_t enc_out_buffer = nullptr; std::vector pred_out_buf; ggml_backend_buffer_t pred_out_buffer = nullptr; struct ggml_tensor * attn_mask = nullptr; std::vector inp_mel; std::vector inp_mask; std::vector logits; std::vector result_all; std::vector decoded_tokens; std::vector decoded_token_data; std::string path_model; int32_t n_audio_ctx = 0; int32_t sched_encode_n_audio_ctx = 0; parakeet_lstm_state lstm_state; }; // FFT cache for mel spectrogram computation struct parakeet_mel_cache { int n_fft = 0; // In FFT, we frequently use sine and cosine operations with the same values. // We can use precalculated values to speed up the process. std::vector sin_vals; std::vector cos_vals; // Hann window (Use cosf to eliminate difference) // ref: https://pytorch.org/docs/stable/generated/torch.hann_window.html // ref: https://github.com/openai/whisper/blob/main/whisper/audio.py#L147 std::vector hann_window; // Window function from model (Parakeet uses actual window from training) std::vector window; void init(int fft_size) { n_fft = fft_size; sin_vals.resize(n_fft); cos_vals.resize(n_fft); hann_window.resize(n_fft); fill_sin_cos_table(); fill_hann_window(n_fft, true, hann_window.data()); } void fill_sin_cos_table() { for (int i = 0; i < n_fft; i++) { double theta = (2 * M_PI * i) / n_fft; sin_vals[i] = sinf(theta); cos_vals[i] = cosf(theta); } } void fill_hann_window(int length, bool periodic, float * output) { int offset = -1; if (periodic) { offset = 0; } for (int i = 0; i < length; i++) { output[i] = 0.5 * (1.0 - cosf((2.0 * M_PI * i) / (length + offset))); } } }; struct parakeet_context { int64_t t_load_us = 0; int64_t t_start_us = 0; ggml_type wtype = ggml_type::GGML_TYPE_F16; ggml_type itype = ggml_type::GGML_TYPE_F16; parakeet_context_params params; parakeet_model model; parakeet_vocab vocab; parakeet_state * state = nullptr; parakeet_mel_cache mel_cache; std::string path_model; }; struct parakeet_global { // We save the log callback globally ggml_log_callback log_callback = parakeet_log_callback_default; void * log_callback_user_data = nullptr; }; static parakeet_global g_state; static const std::string PARAKEET_SPM_SPACE = "\xE2\x96\x81"; static inline int utf8_codepoint_len(unsigned char c) { if ((c & 0x80) == 0x00) return 1; if ((c & 0xE0) == 0xC0) return 2; if ((c & 0xF0) == 0xE0) return 3; if ((c & 0xF8) == 0xF0) return 4; return 1; } static bool is_sentencepiece_control(const std::string & piece) { return piece == "" || piece == "" || piece == "" || piece == "[BLANK]"; } static std::string sentencepiece_normalize(const std::string & text) { std::string normalized; normalized.reserve(text.size() + PARAKEET_SPM_SPACE.size()); normalized += PARAKEET_SPM_SPACE; // SentencePiece dummy prefix for (unsigned char c : text) { if (std::isspace(c)) { normalized += PARAKEET_SPM_SPACE; } else { normalized += static_cast(c); } } return normalized; } static std::string sentencepiece_piece_to_text(const std::string & piece, bool is_first_piece) { if (is_sentencepiece_control(piece)) { return ""; } std::string text; text.reserve(piece.size()); size_t pos = 0; while (pos < piece.size()) { if (piece.compare(pos, PARAKEET_SPM_SPACE.size(), PARAKEET_SPM_SPACE) == 0) { if (!is_first_piece || !text.empty()) { text += ' '; } pos += PARAKEET_SPM_SPACE.size(); continue; } text += piece[pos]; ++pos; } return text; } static struct parakeet_batch parakeet_batch_init(int32_t n_tokens) { parakeet_batch batch = { 0, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, }; batch.token = (parakeet_token * ) malloc(sizeof(parakeet_token) * (n_tokens)); batch.i_time = (int32_t *) malloc(sizeof(int32_t) * (n_tokens)); batch.pos = (parakeet_pos *) malloc(sizeof(parakeet_pos) * (n_tokens)); batch.n_seq_id = (int32_t *) malloc(sizeof(int32_t) * (n_tokens)); batch.seq_id = (parakeet_seq_id **) malloc(sizeof(parakeet_seq_id *) * (n_tokens + 1)); for (int i = 0; i < n_tokens; ++i) { batch.seq_id[i] = (parakeet_seq_id *) malloc(sizeof(parakeet_seq_id)); } batch.seq_id[n_tokens] = nullptr; batch.logits = (int8_t *) malloc(sizeof(int8_t) * n_tokens); return batch; } static void parakeet_batch_free(struct parakeet_batch batch) { if (batch.token) free(batch.token); if (batch.i_time) free(batch.i_time); if (batch.pos) free(batch.pos); if (batch.n_seq_id) free(batch.n_seq_id); if (batch.seq_id) { for (int i = 0; batch.seq_id[i]; ++i) { free(batch.seq_id[i]); } free(batch.seq_id); } if (batch.logits) free(batch.logits); } static void parakeet_batch_prep_legacy(parakeet_batch & batch, const parakeet_token * tokens, int n_tokens, int n_past, int seq_id) { batch.n_tokens = n_tokens; for (int i = 0; i < n_tokens; ++i) { if (tokens) { batch.token[i] = tokens[i]; } batch.pos [i] = n_past + i; batch.n_seq_id[i] = 1; batch.seq_id [i][0] = seq_id; batch.logits [i] = 0; } batch.logits[n_tokens - 1] = 1; } static size_t parakeet_sched_size(struct parakeet_sched & allocr) { size_t size = allocr.meta.size(); for (int i = 0; i < ggml_backend_sched_get_n_backends(allocr.sched); ++i) { ggml_backend_t backend = ggml_backend_sched_get_backend(allocr.sched, i); size += ggml_backend_sched_get_buffer_size(allocr.sched, backend); } return size; } static bool parakeet_sched_graph_init(struct parakeet_sched & allocr, std::vector backends, std::function && get_graph) { auto & sched = allocr.sched; auto & meta = allocr.meta; sched = ggml_backend_sched_new(backends.data(), nullptr, backends.size(), PARAKEET_MAX_NODES, false, true); if (!sched) { PARAKEET_LOG_ERROR("%s: failed to create scheduler\n", __func__); return false; } meta.resize(ggml_tensor_overhead()*PARAKEET_MAX_NODES + ggml_graph_overhead()); if (!ggml_backend_sched_alloc_graph(sched, get_graph())) { PARAKEET_LOG_ERROR("%s: failed to allocate the compute buffer\n", __func__); ggml_backend_sched_free(sched); sched = nullptr; return false; } ggml_backend_sched_reset(sched); return true; } static void parakeet_sched_free(struct parakeet_sched & sched) { if (sched.sched) { ggml_backend_sched_free(sched.sched); sched.sched = nullptr; } sched.meta.clear(); } template static void read_safe(parakeet_model_loader * loader, T & dest) { loader->read(loader->context, &dest, sizeof(T)); BYTESWAP_VALUE(dest); } static bool parakeet_lstm_state_init( struct parakeet_state & pstate, ggml_backend_t backend, int n_layer, int n_pred_dim) { parakeet_lstm_state & lstm_state = pstate.lstm_state; lstm_state.ctx_buf.resize(ggml_tensor_overhead() * n_layer * 2); lstm_state.layer.resize(n_layer); struct ggml_init_params params = { /*.mem_size =*/ lstm_state.ctx_buf.size(), /*.mem_buffer =*/ lstm_state.ctx_buf.data(), /*.no_alloc =*/ true, }; struct ggml_context * ctx = ggml_init(params); if (!ctx) { PARAKEET_LOG_ERROR("%s: failed to allocate memory for the lstm states context\n", __func__); return false; } for (int il = 0; il < n_layer; ++il) { lstm_state.layer[il].h_state = ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_pred_dim); lstm_state.layer[il].c_state = ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_pred_dim); } lstm_state.buffer = ggml_backend_alloc_ctx_tensors(ctx, backend); if (!lstm_state.buffer) { PARAKEET_LOG_ERROR("%s: failed to allocate memory for the lstm states\n", __func__); return false; } ggml_backend_buffer_clear(lstm_state.buffer, 0); ggml_free(ctx); return true; } static bool parakeet_pred_state_init( struct parakeet_state & pstate, ggml_backend_t backend, int n_pred_dim) { pstate.pred_out_buf.resize(ggml_tensor_overhead()); struct ggml_init_params params = { /*.mem_size =*/ pstate.pred_out_buf.size(), /*.mem_buffer =*/ pstate.pred_out_buf.data(), /*.no_alloc =*/ true, }; struct ggml_context * ctx = ggml_init(params); if (!ctx) { PARAKEET_LOG_ERROR("%s: failed to allocate memory for pred tensor context\n", __func__); return false; } pstate.pred_out = ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_pred_dim); pstate.pred_out_buffer = ggml_backend_alloc_ctx_tensors(ctx, backend); if (!pstate.pred_out_buffer) { PARAKEET_LOG_ERROR("%s: failed to allocate memory for pred tensor\n", __func__); ggml_free(ctx); return false; } ggml_free(ctx); return true; } static bool parakeet_enc_state_init( struct parakeet_state & pstate, ggml_backend_t backend, int n_audio_state, int n_frames_max) { pstate.enc_out_buf.resize(ggml_tensor_overhead()); struct ggml_init_params params = { /*.mem_size =*/ pstate.enc_out_buf.size(), /*.mem_buffer =*/ pstate.enc_out_buf.data(), /*.no_alloc =*/ true, }; struct ggml_context * ctx = ggml_init(params); if (!ctx) { PARAKEET_LOG_ERROR("%s: failed to allocate memory for enc_out tensor context\n", __func__); return false; } pstate.enc_out = ggml_new_tensor_2d(ctx, GGML_TYPE_F32, n_audio_state, n_frames_max); pstate.enc_out_buffer = ggml_backend_alloc_ctx_tensors(ctx, backend); if (!pstate.enc_out_buffer) { PARAKEET_LOG_ERROR("%s: failed to allocate memory for enc_out tensor\n", __func__); ggml_free(ctx); return false; } ggml_free(ctx); return true; } static ggml_backend_t parakeet_backend_init_gpu(const parakeet_context_params & params) { ggml_log_set(g_state.log_callback, g_state.log_callback_user_data); ggml_backend_dev_t dev = nullptr; int cnt = 0; if (params.use_gpu) { for (size_t i = 0; i < ggml_backend_dev_count(); ++i) { ggml_backend_dev_t dev_cur = ggml_backend_dev_get(i); enum ggml_backend_dev_type dev_type = ggml_backend_dev_type(dev_cur); const char * dev_name = ggml_backend_dev_name(dev_cur); PARAKEET_LOG_INFO("%s: device %zu: %s (type: %d)\n", __func__, i, dev_name, dev_type); if (dev_type == GGML_BACKEND_DEVICE_TYPE_GPU || dev_type == GGML_BACKEND_DEVICE_TYPE_IGPU) { PARAKEET_LOG_INFO("%s: found GPU device %zu: %s (type: %d, cnt: %d)\n", __func__, i, dev_name, dev_type, cnt); if (cnt == params.gpu_device) { dev = dev_cur; } if (++cnt > params.gpu_device) { break; } } } } if (dev == nullptr) { PARAKEET_LOG_INFO("%s: no GPU found\n", __func__); return nullptr; } PARAKEET_LOG_INFO("%s: using %s backend\n", __func__, ggml_backend_dev_name(dev)); ggml_backend_t result = ggml_backend_dev_init(dev, nullptr); if (!result) { PARAKEET_LOG_ERROR("%s: failed to initialize %s backend\n", __func__, ggml_backend_dev_name(dev)); } return result; } static std::vector parakeet_backend_init(const parakeet_context_params & params) { std::vector result; ggml_backend_t backend_gpu = parakeet_backend_init_gpu(params); if (backend_gpu) { result.push_back(backend_gpu); } // ACCEL backends for (size_t i = 0; i < ggml_backend_dev_count(); ++i) { ggml_backend_dev_t dev = ggml_backend_dev_get(i); if (ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_ACCEL) { PARAKEET_LOG_INFO("%s: using %s backend\n", __func__, ggml_backend_dev_name(dev)); ggml_backend_t backend = ggml_backend_dev_init(dev, nullptr); if (!backend) { PARAKEET_LOG_ERROR("%s: failed to initialize %s backend\n", __func__, ggml_backend_dev_name(dev)); continue; } result.push_back(backend); } } ggml_backend_t backend_cpu = ggml_backend_init_by_type(GGML_BACKEND_DEVICE_TYPE_CPU, nullptr); if (backend_cpu == nullptr) { throw std::runtime_error("failed to initialize CPU backend"); } result.push_back(backend_cpu); return result; } using buft_list_t = std::vector>; static buft_list_t make_buft_list(parakeet_context_params & params) { // Prio order: GPU -> CPU Extra -> CPU buft_list_t buft_list; // GPU if (params.use_gpu) { int cnt = 0; for (size_t i = 0; i < ggml_backend_dev_count(); ++i) { ggml_backend_dev_t dev = ggml_backend_dev_get(i); if (ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_GPU || ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_IGPU) { if (cnt == params.gpu_device) { auto * buft = ggml_backend_dev_buffer_type(dev); if (buft) { buft_list.emplace_back(dev, buft); } } if (++cnt > params.gpu_device) { break; } } } } // CPU Extra auto * cpu_dev = ggml_backend_dev_by_type(GGML_BACKEND_DEVICE_TYPE_CPU); auto * cpu_reg = ggml_backend_dev_backend_reg(cpu_dev); auto get_extra_bufts_fn = (ggml_backend_dev_get_extra_bufts_t) ggml_backend_reg_get_proc_address(cpu_reg, "ggml_backend_dev_get_extra_bufts"); if (get_extra_bufts_fn) { ggml_backend_buffer_type_t * extra_bufts = get_extra_bufts_fn(cpu_dev); while (extra_bufts && *extra_bufts) { buft_list.emplace_back(cpu_dev, *extra_bufts); ++extra_bufts; } } // CPU buft_list.emplace_back(cpu_dev, ggml_backend_cpu_buffer_type()); return buft_list; } static bool weight_buft_supported(const parakeet_hparams & hparams, ggml_tensor * w, ggml_op op, ggml_backend_buffer_type_t buft, ggml_backend_dev_t dev) { bool op_supported = true; if (ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_GPU || ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_IGPU || (ggml_backend_dev_type(dev) == GGML_BACKEND_DEVICE_TYPE_CPU && buft == ggml_backend_cpu_buffer_type())) { // GPU and default CPU backend support all operators op_supported = true; } else { switch (op) { // The current extra_buffer_type implementations only support GGML_OP_MUL_MAT and GGML_OP_GET_ROWS case GGML_OP_GET_ROWS: case GGML_OP_MUL_MAT: { ggml_init_params params = { /*.mem_size =*/ 2 * ggml_tensor_overhead(), /*.mem_buffer =*/ nullptr, /*.no_alloc =*/ true, }; ggml_context_ptr ctx_ptr { ggml_init(params) }; if (!ctx_ptr) { throw std::runtime_error("failed to create ggml context"); } ggml_context * ctx = ctx_ptr.get(); ggml_tensor * op_tensor = nullptr; if (op == GGML_OP_MUL_MAT) { int64_t n_ctx = hparams.n_audio_ctx; ggml_tensor * b = ggml_new_tensor_4d(ctx, GGML_TYPE_F32, w->ne[0], n_ctx, w->ne[2], w->ne[3]); op_tensor = ggml_mul_mat(ctx, w, b); } else if (op == GGML_OP_GET_ROWS) { int64_t num_indices = 8; ggml_tensor * indices = ggml_new_tensor_1d(ctx, GGML_TYPE_I32, num_indices); op_tensor = ggml_get_rows(ctx, w, indices); } // create a temporary dummy buffer for the weight so that supports_op can check the buffer type GGML_ASSERT(w->buffer == nullptr); w->buffer = ggml_backend_buft_alloc_buffer(buft, 0); op_supported = ggml_backend_dev_supports_op(dev, op_tensor); ggml_backend_buffer_free(w->buffer); w->buffer = nullptr; break; } default: { op_supported = false; break; } }; } return op_supported; } static ggml_backend_buffer_type_t select_weight_buft(const parakeet_hparams & hparams, ggml_tensor * w, ggml_op op, buft_list_t buft_list) { GGML_ASSERT(!buft_list.empty()); for (const auto & p : buft_list) { ggml_backend_dev_t dev = p.first; ggml_backend_buffer_type_t buft = p.second; if (weight_buft_supported(hparams, w, op, buft, dev)) { return buft; } } return nullptr; } // load the model from a ggml file // // see the convert-parakeet-to-ggml.py script for details // static bool parakeet_model_load(struct parakeet_model_loader * loader, parakeet_context & wctx) { PARAKEET_LOG_INFO("%s: loading model\n", __func__); const int64_t t_start_us = ggml_time_us(); wctx.t_start_us = t_start_us; auto & model = wctx.model; auto & vocab = wctx.vocab; // verify magic { uint32_t magic; read_safe(loader, magic); if (magic != GGML_FILE_MAGIC) { PARAKEET_LOG_ERROR("%s: invalid model data (bad magic)\n", __func__); return false; } } //load hparams parakeet_hparams hparams; { read_safe(loader, hparams.n_vocab); read_safe(loader, hparams.n_audio_ctx); read_safe(loader, hparams.n_audio_state); read_safe(loader, hparams.n_audio_head); read_safe(loader, hparams.n_audio_layer); read_safe(loader, hparams.n_mels); read_safe(loader, hparams.ftype); read_safe(loader, hparams.n_fft); read_safe(loader, hparams.subsampling_factor); read_safe(loader, hparams.n_subsampling_channels); read_safe(loader, hparams.n_conv_kernel); read_safe(loader, hparams.n_pred_dim); read_safe(loader, hparams.n_pred_layers); read_safe(loader, hparams.n_tdt_durations); read_safe(loader, hparams.n_max_tokens); hparams.arch = PARAKEET_ARCH_TDT; wctx.model.hparams = hparams; const int32_t qntvr = hparams.ftype / GGML_QNT_VERSION_FACTOR; hparams.ftype %= GGML_QNT_VERSION_FACTOR; // for the big tensors, we have the option to store the data in 16-bit floats or quantized // in order to save memory and also to speed up the computation wctx.wtype = ggml_ftype_to_ggml_type((ggml_ftype) hparams.ftype); if (wctx.wtype == GGML_TYPE_COUNT) { PARAKEET_LOG_ERROR("%s: invalid model (bad ftype value %d)\n", __func__, hparams.ftype); return false; } const char* arch_name = hparams.arch == PARAKEET_ARCH_TDT ? "Parakeet TDT" : "unknown"; PARAKEET_LOG_INFO("%s: arch = %s\n", __func__, arch_name); PARAKEET_LOG_INFO("%s: n_vocab = %d\n", __func__, hparams.n_vocab); PARAKEET_LOG_INFO("%s: n_audio_ctx = %d\n", __func__, hparams.n_audio_ctx); PARAKEET_LOG_INFO("%s: n_audio_state = %d\n", __func__, hparams.n_audio_state); PARAKEET_LOG_INFO("%s: n_audio_head = %d\n", __func__, hparams.n_audio_head); PARAKEET_LOG_INFO("%s: n_audio_layer = %d\n", __func__, hparams.n_audio_layer); PARAKEET_LOG_INFO("%s: n_mels = %d\n", __func__, hparams.n_mels); PARAKEET_LOG_INFO("%s: n_fft = %d\n", __func__, hparams.n_fft); PARAKEET_LOG_INFO("%s: eps = %f\n", __func__, hparams.eps); PARAKEET_LOG_INFO("%s: ftype = %d\n", __func__, hparams.ftype); PARAKEET_LOG_INFO("%s: qntvr = %d\n", __func__, qntvr); PARAKEET_LOG_INFO("%s: subsampling_factor = %d\n", __func__, hparams.subsampling_factor); PARAKEET_LOG_INFO("%s: n_subsampling_channels = %d\n", __func__, hparams.n_subsampling_channels); PARAKEET_LOG_INFO("%s: n_conv_kernel = %d\n", __func__, hparams.n_conv_kernel); PARAKEET_LOG_INFO("%s: n_pred_dim = %d\n", __func__, hparams.n_pred_dim); PARAKEET_LOG_INFO("%s: n_pred_layers = %d\n", __func__, hparams.n_pred_layers); PARAKEET_LOG_INFO("%s: n_tdt_durations = %d\n", __func__, hparams.n_tdt_durations); PARAKEET_LOG_INFO("%s: n_max_tokens = %d\n", __func__, hparams.n_max_tokens); } // load mel filters { auto & filters = wctx.model.filters; read_safe(loader, filters.n_mel); read_safe(loader, filters.n_fb); filters.data.resize(filters.n_mel * filters.n_fb); loader->read(loader->context, filters.data.data(), filters.data.size() * sizeof(float)); BYTESWAP_FILTERS(filters); } // load window function { int32_t n_window = 0; read_safe(loader, n_window); wctx.mel_cache.window.resize(n_window); loader->read(loader->context, wctx.mel_cache.window.data(), n_window * sizeof(float)); #ifdef GGML_BIG_ENDIAN for (auto & datum : wctx.mel_cache.window) { datum = byteswap(datum); } #endif PARAKEET_LOG_INFO("%s: loaded window function with %d samples\n", __func__, n_window); } // load TDT (Token and Duration Transducer) values { auto & tdt_durations = wctx.model.tdt_durations; tdt_durations.resize(hparams.n_tdt_durations); loader->read(loader->context, tdt_durations.data(), hparams.n_tdt_durations * sizeof(uint32_t)); PARAKEET_LOG_INFO("%s: loaded tdt_durations: [", __func__); for (const auto value : tdt_durations) { PARAKEET_LOG_INFO("%u ", value); } PARAKEET_LOG_INFO("]\n"); } // load vocab { int32_t n_vocab = 0; read_safe(loader, n_vocab); std::string word; std::vector tmp; tmp.reserve(128); for (int i = 0; i < n_vocab; i++) { uint32_t len; read_safe(loader, len); if (len > 0) { tmp.resize(len); loader->read(loader->context, &tmp[0], tmp.size()); // read to buffer word.assign(&tmp[0], tmp.size()); } else { PARAKEET_LOG_WARN("%s: warning: empty-string token in vocab, i = %d\n", __func__, i); word = ""; } vocab.token_to_id[word] = i; vocab.id_to_token[i] = word; vocab.max_token_length = std::max(vocab.max_token_length, word.size()); } // Blank token for transducer is at index n_vocab (8192), outside the vocabulary int blank_id = n_vocab; vocab.token_blank = blank_id; vocab.id_to_token[blank_id] = "[BLANK]"; vocab.token_to_id["[BLANK]"] = blank_id; // Set special token IDs by looking them up in the loaded vocabulary // These are from the SentencePiece vocab file loaded above if (vocab.token_to_id.find("") != vocab.token_to_id.end()) { vocab.token_unk = vocab.token_to_id.at(""); } else { vocab.token_unk = 0; // Fallback } if (vocab.token_to_id.find("") != vocab.token_to_id.end()) { vocab.token_bos = vocab.token_to_id.at(""); } else if (vocab.token_to_id.find("<|startoftranscript|>") != vocab.token_to_id.end()) { vocab.token_bos = vocab.token_to_id.at("<|startoftranscript|>"); } else { vocab.token_bos = 0; // Fallback } if (vocab.token_to_id.find("") != vocab.token_to_id.end()) { vocab.token_eos = vocab.token_to_id.at(""); } else if (vocab.token_to_id.find("<|endoftext|>") != vocab.token_to_id.end()) { vocab.token_eos = vocab.token_to_id.at("<|endoftext|>"); } else { vocab.token_eos = 0; // Fallback } vocab.n_vocab = model.hparams.n_vocab; PARAKEET_LOG_INFO("%s: loaded vocab with %d tokens (blank_id=%d, unk=%d, bos=%d, eos=%d)\n", __func__, n_vocab, blank_id, vocab.token_unk, vocab.token_bos, vocab.token_eos); } const ggml_type wtype = wctx.wtype; const int n_audio_layer = hparams.n_audio_layer; // Calculate tensor count: pre_encode (12) + encoder layers (29 per layer) + prediction (9) + joint (6) size_t n_tensors = 12 + (29 * n_audio_layer) + 9 + 6; std::map ctx_map; auto get_ctx = [&](ggml_backend_buffer_type_t buft) -> ggml_context * { auto it = ctx_map.find(buft); if (it == ctx_map.end()) { ggml_init_params params = { /*.mem_size =*/ n_tensors * ggml_tensor_overhead(), /*.mem_buffer =*/ nullptr, /*.no_alloc =*/ true, }; ggml_context * ctx = ggml_init(params); if (!ctx) { throw std::runtime_error("failed to create ggml context"); } ctx_map[buft] = ctx; wctx.model.ctxs.emplace_back(ctx); return ctx; } return it->second; }; // Create a list of available bufts, in priority order buft_list_t buft_list = make_buft_list(wctx.params); auto create_tensor = [&](parakeet_tensor type, ggml_tensor * meta, int layer = -1) -> ggml_tensor * { ggml_op op = PARAKEET_TENSOR_INFO.at(type); ggml_backend_buffer_type_t buft = select_weight_buft(hparams, meta, op, buft_list); if (!buft) { throw std::runtime_error(format("failed to find a compatible buffer type for parakeet tensor %s", PARAKEET_TENSOR_NAMES.at(type))); } ggml_context * ctx = get_ctx(buft); ggml_tensor * tensor = ggml_dup_tensor(ctx, meta); std::string tensor_name; if (layer >= 0) { tensor_name = format(PARAKEET_TENSOR_NAMES.at(type), layer); } else { tensor_name = PARAKEET_TENSOR_NAMES.at(type); } wctx.model.tensors[tensor_name] = tensor; return tensor; }; // prepare tensors for the weights ggml_init_params params = { /*.mem_size =*/ n_tensors * ggml_tensor_overhead(), /*.mem_buffer =*/ nullptr, /*.no_alloc =*/ true, }; ggml_context * ctx = ggml_init(params); const int n_audio_state = hparams.n_audio_state; model.layers.resize(n_audio_layer); // Encoder pre_encode const int n_subsampling_channels = hparams.n_subsampling_channels; const int n_pre_enc_features = (hparams.n_mels / hparams.subsampling_factor) * n_subsampling_channels; model.enc_pre_out_w = create_tensor(PARAKEET_TENSOR_ENC_PRE_OUT_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_pre_enc_features, n_audio_state)); ggml_set_name(model.enc_pre_out_w, "enc_pre_out_w"); model.enc_pre_out_b = create_tensor(PARAKEET_TENSOR_ENC_PRE_OUT_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state)); ggml_set_name(model.enc_pre_out_b, "enc_pre_out_b"); model.enc_pre_conv_0_w = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_0_WEIGHT, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 3, 3, 1, n_subsampling_channels)); ggml_set_name(model.enc_pre_conv_0_w, "enc_pre_conv_0_w"); model.enc_pre_conv_0_b = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_0_BIAS, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, 1)); ggml_set_name(model.enc_pre_conv_0_b, "enc_pre_conv_0_b"); model.enc_pre_conv_2_w = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_2_WEIGHT, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 3, 3, 1, n_subsampling_channels)); ggml_set_name(model.enc_pre_conv_2_w, "enc_pre_conv_2_w"); model.enc_pre_conv_2_b = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_2_BIAS, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, 1)); ggml_set_name(model.enc_pre_conv_2_b, "enc_pre_conv_2_b"); model.enc_pre_conv_3_w = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_3_WEIGHT, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, n_subsampling_channels)); ggml_set_name(model.enc_pre_conv_3_w, "enc_pre_conv_3_w"); model.enc_pre_conv_3_b = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_3_BIAS, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, 1)); ggml_set_name(model.enc_pre_conv_3_b, "enc_pre_conv_3_b"); model.enc_pre_conv_5_w = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_5_WEIGHT, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 3, 3, 1, n_subsampling_channels)); ggml_set_name(model.enc_pre_conv_5_w, "enc_pre_conv_5_w"); model.enc_pre_conv_5_b = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_5_BIAS, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, 1)); ggml_set_name(model.enc_pre_conv_5_b, "enc_pre_conv_5_b"); model.enc_pre_conv_6_w = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_6_WEIGHT, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, n_subsampling_channels)); ggml_set_name(model.enc_pre_conv_6_w, "enc_pre_conv_6_w"); model.enc_pre_conv_6_b = create_tensor(PARAKEET_TENSOR_ENC_PRE_CONV_6_BIAS, ggml_new_tensor_4d(ctx, GGML_TYPE_F32, 1, 1, n_subsampling_channels, 1)); ggml_set_name(model.enc_pre_conv_6_b, "enc_pre_conv_6_b"); // Encoder layers for (int i = 0; i < n_audio_layer; ++i) { auto & layer = model.layers[i]; // Feed forward 1 layer.norm_ff1_w = create_tensor(PARAKEET_TENSOR_ENC_NORM_FF1_WEIGHT, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.norm_ff1_b = create_tensor(PARAKEET_TENSOR_ENC_NORM_FF1_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.ff1_linear1_w = create_tensor(PARAKEET_TENSOR_ENC_FF1_LINEAR1_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, 4*n_audio_state), i); ggml_format_name(layer.ff1_linear1_w, "enc_%d_ff1_linear1_w", i); layer.ff1_linear2_w = create_tensor(PARAKEET_TENSOR_ENC_FF1_LINEAR2_WEIGHT, ggml_new_tensor_2d(ctx, wtype, 4*n_audio_state, n_audio_state), i); ggml_format_name(layer.ff1_linear2_w, "enc_%d_ff1_linear2_w", i); // Convolution module layer.norm_conv_w = create_tensor(PARAKEET_TENSOR_ENC_NORM_CONV_WEIGHT, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); ggml_format_name(layer.norm_conv_w, "enc_%d_norm_conv_w", i); layer.norm_conv_b = create_tensor(PARAKEET_TENSOR_ENC_NORM_CONV_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); ggml_format_name(layer.norm_conv_b, "enc_%d_norm_conv_b", i); layer.conv_pw1_w = create_tensor(PARAKEET_TENSOR_ENC_CONV_PW1_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, 2*n_audio_state), i); ggml_format_name(layer.conv_pw1_w, "enc_%d_conv_pw1_w", i); layer.conv_dw_w = create_tensor(PARAKEET_TENSOR_ENC_CONV_DW_WEIGHT, ggml_new_tensor_2d(ctx, GGML_TYPE_F32, hparams.n_conv_kernel, n_audio_state), i); ggml_format_name(layer.conv_dw_w, "enc_%d_conv_dw_w", i); layer.conv_bn_w = create_tensor(PARAKEET_TENSOR_ENC_CONV_BN_WEIGHT, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); ggml_format_name(layer.conv_bn_w, "enc_%d_conv_bn_w", i); layer.conv_bn_b = create_tensor(PARAKEET_TENSOR_ENC_CONV_BN_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); ggml_format_name(layer.conv_bn_b, "enc_%d_conv_bn_b", i); layer.conv_bn_mean = create_tensor(PARAKEET_TENSOR_ENC_CONV_BN_MEAN, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.conv_bn_var = create_tensor(PARAKEET_TENSOR_ENC_CONV_BN_VAR, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); ggml_format_name(layer.conv_bn_var, "enc_%d_conv_bn_var", i); layer.conv_bn_num_batches = create_tensor(PARAKEET_TENSOR_ENC_CONV_BN_NUM_BATCHES, ggml_new_tensor_1d(ctx, GGML_TYPE_I32, 1), i); layer.conv_pw2_w = create_tensor(PARAKEET_TENSOR_ENC_CONV_PW2_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, n_audio_state), i); ggml_format_name(layer.conv_pw2_w, "enc_%d_conv_pw2_w", i); // Self attention layer.norm_attn_w = create_tensor(PARAKEET_TENSOR_ENC_NORM_ATTN_WEIGHT, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.norm_attn_b = create_tensor(PARAKEET_TENSOR_ENC_NORM_ATTN_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.attn_pos_bias_u = create_tensor(PARAKEET_TENSOR_ENC_ATTN_POS_BIAS_U, ggml_new_tensor_2d(ctx, GGML_TYPE_F32, hparams.n_audio_state / hparams.n_audio_head, hparams.n_audio_head), i); layer.attn_pos_bias_v = create_tensor(PARAKEET_TENSOR_ENC_ATTN_POS_BIAS_V, ggml_new_tensor_2d(ctx, GGML_TYPE_F32, hparams.n_audio_state / hparams.n_audio_head, hparams.n_audio_head), i); layer.attn_q_w = create_tensor(PARAKEET_TENSOR_ENC_ATTN_Q_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, n_audio_state), i); layer.attn_k_w = create_tensor(PARAKEET_TENSOR_ENC_ATTN_K_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, n_audio_state), i); layer.attn_v_w = create_tensor(PARAKEET_TENSOR_ENC_ATTN_V_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, n_audio_state), i); layer.attn_out_w = create_tensor(PARAKEET_TENSOR_ENC_ATTN_OUT_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, n_audio_state), i); layer.attn_pos_w = create_tensor(PARAKEET_TENSOR_ENC_ATTN_POS_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, n_audio_state), i); ggml_format_name(layer.attn_pos_w, "enc_%d_attn_pos_w", i); // Feed forward 2 layer.norm_ff2_w = create_tensor(PARAKEET_TENSOR_ENC_NORM_FF2_WEIGHT, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.norm_ff2_b = create_tensor(PARAKEET_TENSOR_ENC_NORM_FF2_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.ff2_linear1_w = create_tensor(PARAKEET_TENSOR_ENC_FF2_LINEAR1_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, 4*n_audio_state), i); layer.ff2_linear2_w = create_tensor(PARAKEET_TENSOR_ENC_FF2_LINEAR2_WEIGHT, ggml_new_tensor_2d(ctx, wtype, 4*n_audio_state, n_audio_state), i); // Output norm layer.norm_out_w = create_tensor(PARAKEET_TENSOR_ENC_NORM_OUT_WEIGHT, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); layer.norm_out_b = create_tensor(PARAKEET_TENSOR_ENC_NORM_OUT_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_audio_state), i); } // Prediction network (decoder) const int dec_hidden = hparams.n_pred_dim; const int n_pred_embed = hparams.n_vocab + 1; // vocab + blank token const int n_lstm_gates = 4 * dec_hidden; // 4 LSTM gates const int n_joint_out = hparams.n_vocab + hparams.n_tdt_durations + 1; // vocab + durations + blank // The prediction/joint hidden dimension is 640, which is not a multiple of the // K-quant block size (256). For K-quant models, we keep these tensors at F32. const int blck = ggml_blck_size(wtype); const ggml_type pred_wtype = (blck > 1 && dec_hidden % blck != 0) ? GGML_TYPE_F32 : wtype; const ggml_type join_wtype = pred_wtype; model.prediction.embed_w = create_tensor(PARAKEET_TENSOR_PRED_EMBED_WEIGHT, ggml_new_tensor_2d(ctx, pred_wtype, dec_hidden, n_pred_embed)); model.prediction.lstm_layer.resize(hparams.n_pred_layers); for (int i = 0; i < hparams.n_pred_layers; ++i) { auto & layer = model.prediction.lstm_layer[i]; layer.ih_w = create_tensor(PARAKEET_TENSOR_PRED_LSTM_WEIGHT_IH, ggml_new_tensor_2d(ctx, pred_wtype, dec_hidden, n_lstm_gates), i); ggml_format_name(layer.ih_w, "pred_%d_ih_w", i); layer.hh_w = create_tensor(PARAKEET_TENSOR_PRED_LSTM_WEIGHT_HH, ggml_new_tensor_2d(ctx, pred_wtype, dec_hidden, n_lstm_gates), i); ggml_format_name(layer.hh_w, "pred_%d_hh_w", i); layer.b_h = create_tensor(PARAKEET_TENSOR_PRED_LSTM_BIAS_H, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_lstm_gates), i); ggml_format_name(layer.b_h, "pred_%d_b_h", i); } // Joint network model.joint.pred_w = create_tensor(PARAKEET_TENSOR_JOINT_PRED_WEIGHT, ggml_new_tensor_2d(ctx, join_wtype, dec_hidden, dec_hidden)); ggml_set_name(model.joint.pred_w, "pred_w"); model.joint.pred_b = create_tensor(PARAKEET_TENSOR_JOINT_PRED_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, dec_hidden)); ggml_set_name(model.joint.pred_b, "pred_b"); model.joint.enc_w = create_tensor(PARAKEET_TENSOR_JOINT_ENC_WEIGHT, ggml_new_tensor_2d(ctx, wtype, n_audio_state, dec_hidden)); ggml_set_name(model.joint.enc_w, "enc_w"); model.joint.enc_b = create_tensor(PARAKEET_TENSOR_JOINT_ENC_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, dec_hidden)); ggml_set_name(model.joint.enc_b, "enc_b"); model.joint.net_w = create_tensor(PARAKEET_TENSOR_JOINT_NET_WEIGHT, ggml_new_tensor_2d(ctx, join_wtype, dec_hidden, n_joint_out)); ggml_set_name(model.joint.net_w, "net_w"); model.joint.net_b = create_tensor(PARAKEET_TENSOR_JOINT_NET_BIAS, ggml_new_tensor_1d(ctx, GGML_TYPE_F32, n_joint_out)); ggml_set_name(model.joint.net_b, "net_b"); ggml_free(ctx); // allocate tensors in the backend buffers for (auto & p : ctx_map) { ggml_backend_buffer_type_t buft = p.first; ggml_context * ctx = p.second; ggml_backend_buffer_t buf = ggml_backend_alloc_ctx_tensors_from_buft(ctx, buft); if (buf) { wctx.model.buffers.emplace_back(buf); size_t size_main = ggml_backend_buffer_get_size(buf); PARAKEET_LOG_INFO("%s: %12s total size = %8.2f MB\n", __func__, ggml_backend_buffer_name(buf), size_main / 1e6); } } // load weights { size_t total_size = 0; auto & tensors_map = wctx.model.tensors; int & n_loaded = wctx.model.n_loaded; n_loaded = 0; std::vector read_buf; while (true) { int32_t n_dims; int32_t length; int32_t ttype; read_safe(loader, n_dims); read_safe(loader, length); read_safe(loader, ttype); if (loader->eof(loader->context)) { break; } int32_t nelements = 1; int32_t ne[4] = { 1, 1, 1, 1 }; for (int i = 0; i < n_dims; ++i) { read_safe(loader, ne[i]); nelements *= ne[i]; } std::string name; std::vector tmp(length); // create a buffer loader->read(loader->context, &tmp[0], tmp.size()); // read to buffer name.assign(&tmp[0], tmp.size()); if (tensors_map.find(name) == tensors_map.end()) { PARAKEET_LOG_ERROR("%s: unknown tensor '%s' in model file\n", __func__, name.data()); return false; } auto tensor = tensors_map[name.data()]; if (ggml_nelements(tensor) != nelements) { PARAKEET_LOG_ERROR("%s: tensor '%s' has wrong size in model file\n", __func__, name.data()); PARAKEET_LOG_ERROR("%s: shape: [%d, %d, %d], expected: [%d, %d, %d]\n", __func__, ne[0], ne[1], ne[2], (int) tensor->ne[0], (int) tensor->ne[1], (int) tensor->ne[2]); return false; } if (tensor->ne[0] != ne[0] || tensor->ne[1] != ne[1] || tensor->ne[2] != ne[2] || tensor->ne[3] != ne[3]) { PARAKEET_LOG_ERROR("%s: tensor '%s' has wrong shape in model file: got [%d, %d, %d, %d], expected [%d, %d, %d, %d]\n", __func__, name.data(), (int) tensor->ne[0], (int) tensor->ne[1], (int) tensor->ne[2], (int) tensor->ne[3], ne[0], ne[1], ne[2], ne[3]); return false; } const size_t bpe = ggml_type_size(ggml_type(ttype)); if ((nelements*bpe)/ggml_blck_size(tensor->type) != ggml_nbytes(tensor)) { PARAKEET_LOG_ERROR("%s: tensor '%s' has wrong size in model file: got %zu, expected %zu\n", __func__, name.data(), ggml_nbytes(tensor), nelements*bpe); return false; } if (ggml_backend_buffer_is_host(tensor->buffer)) { // for the CPU and Metal backend, we can read directly into the tensor loader->read(loader->context, tensor->data, ggml_nbytes(tensor)); BYTESWAP_TENSOR(tensor); } else { // read into a temporary buffer first, then copy to device memory read_buf.resize(ggml_nbytes(tensor)); loader->read(loader->context, read_buf.data(), read_buf.size()); ggml_backend_tensor_set(tensor, read_buf.data(), 0, ggml_nbytes(tensor)); } total_size += ggml_nbytes(tensor); n_loaded++; } PARAKEET_LOG_INFO("%s: model size = %7.2f MB\n", __func__, total_size/1e6); if (n_loaded == 0) { PARAKEET_LOG_WARN("%s: WARN no tensors loaded from model file - assuming empty model for testing\n", __func__); } else if (n_loaded != (int) tensors_map.size()) { PARAKEET_LOG_ERROR("%s: ERROR not all tensors loaded from model file - expected %zu, got %d\n", __func__, tensors_map.size(), n_loaded); return false; } } auto & buffers = wctx.model.buffers; for (auto & buf : buffers) { ggml_backend_buffer_set_usage(buf, GGML_BACKEND_BUFFER_USAGE_WEIGHTS); } wctx.t_load_us = ggml_time_us() - t_start_us; return true; } // conv subsampling + conformer encoder static struct ggml_cgraph * parakeet_build_graph_encode(parakeet_context & pctx, parakeet_state & pstate) { const auto & model = pctx.model; const auto & hparams = model.hparams; const int n_mel_time = pstate.n_audio_ctx > 0 ? pstate.n_audio_ctx : hparams.n_audio_ctx; const int n_mels = hparams.n_mels; const int n_layer = hparams.n_audio_layer; const int n_state = hparams.n_audio_state; const float fc_factor = 0.5f; struct ggml_init_params params = { /*.mem_size =*/ pstate.sched_encode.meta.size(), /*.mem_buffer =*/ pstate.sched_encode.meta.data(), /*.no_alloc =*/ true, }; struct ggml_context * ctx0 = ggml_init(params); ggml_cgraph * gf = ggml_new_graph_custom(ctx0, PARAKEET_MAX_NODES, false); // Conv subsampling // [freq, time] struct ggml_tensor * mel = ggml_new_tensor_4d(ctx0, GGML_TYPE_F32, n_mels, n_mel_time, 1, 1); ggml_set_name(mel, "mel"); ggml_set_input(mel); // [freq, time, channels, batch] struct ggml_tensor * cur = ggml_conv_2d(ctx0, model.enc_pre_conv_0_w, mel, 2, 2, 1, 1, 1, 1); cur = ggml_add(ctx0, cur, model.enc_pre_conv_0_b); ggml_set_name(cur, "pre_conv_0"); cur = ggml_relu(ctx0, cur); ggml_set_name(cur, "pre_conv_0_relu"); // [freq, time, channels, batch] cur = ggml_conv_2d_dw_direct(ctx0, model.enc_pre_conv_2_w, cur, 2, 2, 1, 1, 1, 1); cur = ggml_add(ctx0, cur, model.enc_pre_conv_2_b); ggml_set_name(cur, "pre_conv_2"); // [freq, time, channels, batch] cur = ggml_conv_2d(ctx0, model.enc_pre_conv_3_w, cur, 1, 1, 0, 0, 1, 1); cur = ggml_add(ctx0, cur, model.enc_pre_conv_3_b); ggml_set_name(cur, "pre_conv_3"); cur = ggml_relu(ctx0, cur); ggml_set_name(cur, "pre_conv_3_relu"); // [freq, time, channels, batch] cur = ggml_conv_2d_dw_direct(ctx0, model.enc_pre_conv_5_w, cur, 2, 2, 1, 1, 1, 1); ggml_set_name(cur, "pre_conv_5_direct"); cur = ggml_add(ctx0, cur, model.enc_pre_conv_5_b); ggml_set_name(cur, "pre_conv_5"); // [freq, time, channels, batch] cur = ggml_conv_2d(ctx0, model.enc_pre_conv_6_w, cur, 1, 1, 0, 0, 1, 1); cur = ggml_add(ctx0, cur, model.enc_pre_conv_6_b); ggml_set_name(cur, "pre_conv_6"); cur = ggml_relu(ctx0, cur); ggml_set_name(cur, "pre_conv_6_relu"); // [freq, time, chan] cur = ggml_permute(ctx0, cur, 0, 2, 1, 3); // [freq, chan, time] cur = ggml_cont(ctx0, cur); const int n_freq = cur->ne[0]; // 16 const int n_chan = cur->ne[1]; // 256 const int n_frames = cur->ne[2]; // time // [freq, time, chan, batch] -> [(freq * chan), time] cur = ggml_reshape_2d(ctx0, cur, n_freq * n_chan, n_frames); cur = ggml_mul_mat(ctx0, model.enc_pre_out_w, cur); cur = ggml_add(ctx0, cur, model.enc_pre_out_b); ggml_set_name(cur, "pre_enc_out"); // Encoder // cur: [n_state, n_enc_time] const int n_time = cur->ne[1]; const bool local_attn = n_time > PARAKEET_LOCAL_ATTN_THRESHOLD; const int att_left = local_attn ? PARAKEET_LOCAL_ATTN_WINDOW : n_time - 1; const int att_right = local_attn ? PARAKEET_LOCAL_ATTN_WINDOW : n_time - 1; const int window_size = local_attn ? att_left + att_right + 1 : 2 * n_time - 1; const int d_half = n_state / 2; const int mask_dim = local_attn ? window_size : n_time; // mask [key, n_time] struct ggml_tensor * attn_mask = ggml_new_tensor_2d(ctx0, GGML_TYPE_F32, mask_dim, n_time); ggml_set_name(attn_mask, "attn_mask"); ggml_set_input(attn_mask); struct ggml_tensor * local_mask = nullptr; if (local_attn) { const int chunk = att_left + att_right; local_mask = ggml_new_tensor_2d(ctx0, GGML_TYPE_F32, chunk + window_size - 1, chunk); ggml_set_name(local_mask, "local_mask"); ggml_set_input(local_mask); } struct ggml_tensor * pos_freqs = ggml_new_tensor_1d(ctx0, GGML_TYPE_F32, d_half); ggml_set_name(pos_freqs, "pos_freqs"); ggml_set_input(pos_freqs); struct ggml_tensor * rel_positions = ggml_new_tensor_2d(ctx0, GGML_TYPE_F32, 1, window_size); ggml_set_name(rel_positions, "rel_positions"); ggml_set_input(rel_positions); struct ggml_tensor * freqs = ggml_repeat_4d(ctx0, pos_freqs, d_half, window_size, 1, 1); struct ggml_tensor * theta = ggml_mul(ctx0, freqs, rel_positions); struct ggml_tensor * sin_t = ggml_reshape_3d(ctx0, ggml_sin(ctx0, theta), 1, d_half, window_size); struct ggml_tensor * cos_t = ggml_reshape_3d(ctx0, ggml_cos(ctx0, theta), 1, d_half, window_size); // [n_state, window_size] struct ggml_tensor * pos_emb = ggml_reshape_2d(ctx0, ggml_cont(ctx0, ggml_concat(ctx0, sin_t, cos_t, 0)), n_state, window_size); ggml_set_name(pos_emb, "pos_emb"); for (int il = 0; il < n_layer; ++il) { const auto & layer = model.layers[il]; // FFN1 { struct ggml_tensor * residual = cur; ggml_format_name(cur, "enc_%d_res", il); // norm cur = ggml_norm(ctx0, cur, hparams.eps); cur = ggml_add(ctx0, ggml_mul(ctx0, cur, layer.norm_ff1_w), layer.norm_ff1_b); ggml_format_name(cur, "enc_%d_ffn_norm_1", il); // ffn_1 cur = ggml_mul_mat(ctx0, layer.ff1_linear1_w, cur); cur = ggml_silu(ctx0, cur); ggml_format_name(cur, "enc_%d_silu", il); cur = ggml_mul_mat(ctx0, layer.ff1_linear2_w, cur); ggml_format_name(cur, "enc_%d_ffn_1", il); cur = ggml_add(ctx0, residual, ggml_scale(ctx0, cur, fc_factor)); ggml_format_name(cur, "enc_%d_res_ffn", il); } // self attention block using relative positional encoding computed in graph. { // [feat, time_frames, 1, 1] struct ggml_tensor * residual = cur; cur = ggml_norm(ctx0, cur, hparams.eps); cur = ggml_add(ctx0, ggml_mul(ctx0, cur, layer.norm_attn_w), layer.norm_attn_b); ggml_format_name(cur, "enc_%d_attn_norm", il); const int n_head = hparams.n_audio_head; const int d_head = n_state / n_head; // [feat, time_frames, 1, 1] struct ggml_tensor * Q_cur = ggml_mul_mat(ctx0, layer.attn_q_w, cur); struct ggml_tensor * K_cur = ggml_mul_mat(ctx0, layer.attn_k_w, cur); struct ggml_tensor * V_cur = ggml_mul_mat(ctx0, layer.attn_v_w, cur); Q_cur = ggml_reshape_3d(ctx0, Q_cur, d_head, n_head, n_time); K_cur = ggml_reshape_3d(ctx0, K_cur, d_head, n_head, n_time); V_cur = ggml_reshape_3d(ctx0, V_cur, d_head, n_head, n_time); struct ggml_tensor * pos = ggml_mul_mat(ctx0, layer.attn_pos_w, pos_emb); pos = ggml_reshape_3d(ctx0, pos, d_head, n_head, window_size); pos = ggml_cont(ctx0, ggml_permute(ctx0, pos, 0, 2, 1, 3)); if (local_attn) { const int chunk = att_left + att_right; const int n_group = (n_time + chunk - 1) / chunk; const int n_time_padded = n_group * chunk; const int n_kv_chunk = chunk + window_size - 1; const int n_kv_dense = n_kv_chunk * n_group; const bool need_padding = n_time_padded > n_time; Q_cur = ggml_cont(ctx0, ggml_permute(ctx0, Q_cur, 0, 2, 1, 3)); K_cur = ggml_cont(ctx0, ggml_permute(ctx0, K_cur, 0, 2, 1, 3)); V_cur = ggml_cont(ctx0, ggml_permute(ctx0, V_cur, 0, 2, 1, 3)); // content bias struct ggml_tensor * bias_u = ggml_reshape_3d(ctx0, layer.attn_pos_bias_u, d_head, 1, n_head); struct ggml_tensor * Q_u = ggml_add(ctx0, Q_cur, bias_u); // position bias struct ggml_tensor * bias_v = ggml_reshape_3d(ctx0, layer.attn_pos_bias_v, d_head, 1, n_head); struct ggml_tensor * Q_v = ggml_add(ctx0, Q_cur, bias_v); // right pad the time_frame. struct ggml_tensor * Q_u_padded = need_padding ? ggml_pad_ext(ctx0, Q_u, 0, 0, 0, n_time_padded - n_time, 0, 0, 0, 0) : Q_u; Q_u_padded = ggml_reshape_4d(ctx0, Q_u_padded, d_head, chunk, n_group, n_head); // Add padding to front and back (for the first timeframe and the last timeframe). struct ggml_tensor * K_padded = ggml_pad_ext(ctx0, K_cur, 0, 0, att_left, att_right, 0, 0, 0, 0); // pad time axis to match n_kv_dense if needed. if (n_kv_dense > K_padded->ne[1]) { K_padded = ggml_pad_ext(ctx0, K_padded, 0, 0, 0, n_kv_dense - K_padded->ne[1], 0, 0, 0, 0); } // Create a 4d tensor where each group spans a wide window of // 512 keys (n_kv_chunk), but moving to the next group (nb[2]) // only jumps forward by 256 frames (chunk * nb[1]). This creates // a 256 frame overlap, shared keys in RAM without copies. struct ggml_tensor * K_chunk = ggml_view_4d(ctx0, K_padded, d_head, n_kv_chunk, n_group, n_head, K_padded->nb[1], (size_t) chunk * K_padded->nb[1], K_padded->nb[2], 0); K_chunk = ggml_cont(ctx0, K_chunk); struct ggml_tensor * content_scores = ggml_mul_mat(ctx0, K_chunk, Q_u_padded); // The above mul_mat operation, combined with K_chunk's overlapping // frames, produces a dense matrix. But some of the results in // this matrix were computed for keys that aren't part of that // query's window. So we shift each row to keep only the results // that we want. content_scores = ggml_view_4d(ctx0, content_scores, window_size, chunk, n_group, n_head, (size_t) (chunk + window_size) * content_scores->nb[0], content_scores->nb[2], content_scores->nb[3], 0); content_scores = ggml_cont(ctx0, content_scores); // ungrouping. content_scores = ggml_reshape_3d(ctx0, content_scores, window_size, n_time_padded, n_head); // remove padding if padding was applied (truncating to n_time). if (need_padding) { content_scores = ggml_view_3d(ctx0, content_scores, window_size, n_time, n_head, content_scores->nb[1], content_scores->nb[2], 0); } struct ggml_tensor * rel_pos_scores = ggml_mul_mat(ctx0, pos, Q_v); // attention_score = content similarity + relative position scores struct ggml_tensor * attn_scores = ggml_add(ctx0, content_scores, rel_pos_scores); attn_scores = ggml_soft_max_ext(ctx0, attn_scores, attn_mask, 1.0f / std::sqrt(d_head), 0.0f); // right pad the probabilites. struct ggml_tensor * probs_padded = need_padding ? ggml_pad_ext(ctx0, attn_scores, 0, 0, 0, n_time_padded - n_time, 0, 0, 0, 0) : attn_scores; probs_padded = ggml_reshape_4d(ctx0, probs_padded, window_size, chunk, n_group, n_head); probs_padded = ggml_pad_ext(ctx0, probs_padded, 0, chunk, 0, 0, 0, 0, 0, 0); probs_padded = ggml_view_4d(ctx0, probs_padded, n_kv_chunk, chunk, n_group, n_head, (size_t) n_kv_chunk * probs_padded->nb[0], probs_padded->nb[2], probs_padded->nb[3], 0); probs_padded = ggml_cont(ctx0, probs_padded); probs_padded = ggml_mul(ctx0, probs_padded, local_mask); // Add padding to front and back (for the first timeframe and the last timeframe). struct ggml_tensor * V_padded = ggml_pad_ext(ctx0, V_cur, 0, 0, att_left, att_right, 0, 0, 0, 0); // pad time axis to match n_kv_dense if needed. if (n_kv_dense > V_padded->ne[1]) { V_padded = ggml_pad_ext(ctx0, V_padded, 0, 0, 0, n_kv_dense - V_padded->ne[1], 0, 0, 0, 0); } V_padded = ggml_cont(ctx0, ggml_transpose(ctx0, V_padded)); struct ggml_tensor * V_chunk = ggml_view_4d(ctx0, V_padded, n_kv_chunk, d_head, n_group, n_head, V_padded->nb[1], (size_t) chunk * V_padded->nb[0], V_padded->nb[2], 0); V_chunk = ggml_cont(ctx0, V_chunk); cur = ggml_mul_mat(ctx0, V_chunk, probs_padded); // ungroup. cur = ggml_reshape_3d(ctx0, cur, d_head, n_time_padded, n_head); // unpad if (need_padding) { cur = ggml_view_3d(ctx0, cur, d_head, n_time, n_head, cur->nb[1], cur->nb[2], 0); } cur = ggml_cont(ctx0, ggml_permute(ctx0, cur, 0, 2, 1, 3)); cur = ggml_reshape_2d(ctx0, cur, n_state, n_time); cur = ggml_mul_mat(ctx0, layer.attn_out_w, cur); } else { struct ggml_tensor * Q_u = ggml_add(ctx0, Q_cur, layer.attn_pos_bias_u); ggml_format_name(Q_u, "enc_%d_attn_q_u", il); struct ggml_tensor * K_prep = ggml_permute(ctx0, K_cur, 0, 2, 1, 3); struct ggml_tensor * Q_prep = ggml_permute(ctx0, Q_u, 0, 2, 1, 3); struct ggml_tensor * content_scores = ggml_mul_mat(ctx0, K_prep, Q_prep); ggml_format_name(content_scores, "enc_%d_attn_content_scores", il); struct ggml_tensor * Q_v = ggml_add(ctx0, Q_cur, layer.attn_pos_bias_v); ggml_format_name(Q_v, "enc_%d_attn_q_v", il); Q_v = ggml_permute(ctx0, Q_v, 0, 2, 1, 3); Q_v = ggml_cont(ctx0, Q_v); ggml_format_name(Q_v, "enc_%d_attn_q_v_perm", il); struct ggml_tensor * rel_pos_scores = ggml_mul_mat(ctx0, pos, Q_v); ggml_format_name(rel_pos_scores, "enc_%d_attn_rel_pos", il); // Relative position shifting is performed in the following block. // Some more details on the operations performed below can be found here: // https://github.com/danbev/learning-ai/blob/main/notes/whisper/parakeet.md#relative-position-shift { const auto pos_window = rel_pos_scores->ne[0]; const auto n_frame = rel_pos_scores->ne[1]; const auto n_head_cur = rel_pos_scores->ne[2]; rel_pos_scores = ggml_pad(ctx0, rel_pos_scores, 1, 0, 0, 0); rel_pos_scores = ggml_roll(ctx0, rel_pos_scores, 1, 0, 0, 0); rel_pos_scores = ggml_reshape_3d(ctx0, rel_pos_scores, n_frame, pos_window + 1, n_head_cur); ggml_format_name(rel_pos_scores, "enc_%d_attn_rel_pos_reshaped", il); int center = pos_window / 2; size_t offset = rel_pos_scores->nb[0] * (center+1); rel_pos_scores = ggml_view_3d(ctx0, rel_pos_scores, n_frame, pos_window, n_head_cur, (pos_window) * 4, rel_pos_scores->nb[2], offset); ggml_format_name(rel_pos_scores, "enc_%d_attn_rel_pos_shifted", il); rel_pos_scores = ggml_view_3d(ctx0, rel_pos_scores, content_scores->ne[0], content_scores->ne[1], rel_pos_scores->ne[2], rel_pos_scores->nb[1], rel_pos_scores->nb[2], 0); rel_pos_scores = ggml_cont(ctx0, rel_pos_scores); ggml_format_name(rel_pos_scores, "enc_%d_attn_rel_pos_shifted_view", il); } struct ggml_tensor * attn_scores = ggml_add(ctx0, content_scores, rel_pos_scores); ggml_format_name(attn_scores, "enc_%d_attn_scores", il); attn_scores = ggml_scale(ctx0, attn_scores, 1.0f / std::sqrt(d_head)); attn_scores = ggml_add(ctx0, attn_scores, attn_mask); ggml_format_name(attn_scores, "enc_%d_attn_scores_scaled", il); struct ggml_tensor * probs = ggml_soft_max(ctx0, attn_scores); ggml_format_name(probs, "enc_%d_attn_probs", il); V_cur = ggml_cont(ctx0, ggml_permute(ctx0, V_cur, 1, 2, 0, 3)); ggml_format_name(V_cur, "enc_%d_attn_v_cur", il); cur = ggml_mul_mat(ctx0, probs, V_cur); ggml_format_name(cur, "enc_%d_attn_inp", il); cur = ggml_permute(ctx0, cur, 2, 0, 1, 3); cur = ggml_cont_2d(ctx0, cur, n_state, n_time); cur = ggml_mul_mat(ctx0, layer.attn_out_w, cur); } ggml_format_name(cur, "enc_%d_attn_out", il); cur = ggml_add(ctx0, residual, cur); ggml_format_name(cur, "enc_%d_attn_res", il); } // Convolution { struct ggml_tensor * residual = cur; ggml_format_name(cur, "enc_%d_residual_conv", il); cur = ggml_norm(ctx0, cur, hparams.eps); cur = ggml_add(ctx0, ggml_mul(ctx0, cur, layer.norm_conv_w), layer.norm_conv_b); ggml_format_name(cur, "enc_%d_norm_conv", il); // pointwise 1d convolution: [1024, 138] -> [2048, 138] cur = ggml_mul_mat(ctx0, layer.conv_pw1_w, cur); ggml_format_name(cur, "enc_%d_conv_pw1", il); { int64_t d = cur->ne[0] / 2; struct ggml_tensor * signal = ggml_view_2d(ctx0, cur, d, cur->ne[1], cur->nb[1], 0); struct ggml_tensor * gate = ggml_view_2d(ctx0, cur, d, cur->ne[1], cur->nb[1], d * cur->nb[0]); cur = ggml_mul(ctx0, signal, ggml_sigmoid(ctx0, gate)); ggml_format_name(cur, "enc_%d_conv_glu", il); } cur = ggml_cont(ctx0, ggml_transpose(ctx0, cur)); // use ggml_ssm_conv for f32 precision const int dw_pad = (hparams.n_conv_kernel - 1) / 2; cur = ggml_pad(ctx0, cur, dw_pad, 0, 0, 0); cur = ggml_roll(ctx0, cur, dw_pad, 0, 0, 0); cur = ggml_pad(ctx0, cur, dw_pad, 0, 0, 0); ggml_format_name(cur, "enc_%d_conv_dw_pad", il); cur = ggml_ssm_conv(ctx0, cur, layer.conv_dw_w); ggml_format_name(cur, "enc_%d_conv_1d_dw", il); cur = ggml_sub(ctx0, cur, layer.conv_bn_mean); struct ggml_tensor * std = ggml_sqrt(ctx0, layer.conv_bn_var); cur = ggml_div(ctx0, cur, std); cur = ggml_add(ctx0, ggml_mul(ctx0, cur, layer.conv_bn_w), layer.conv_bn_b); ggml_format_name(cur, "enc_%d_conv_bn", il); cur = ggml_silu(ctx0, cur); ggml_format_name(cur, "enc_%d_conv_silu", il); cur = ggml_mul_mat(ctx0, layer.conv_pw2_w, cur); ggml_format_name(cur, "enc_%d_conv_pw2", il); cur = ggml_add(ctx0, residual, cur); ggml_format_name(cur, "enc_%d_conv_res", il); } // FFN2 { struct ggml_tensor * residual = cur; cur = ggml_norm(ctx0, cur, hparams.eps); cur = ggml_add(ctx0, ggml_mul(ctx0, cur, layer.norm_ff2_w), layer.norm_ff2_b); ggml_format_name(cur, "enc_%d_ffn_norm_2", il); cur = ggml_mul_mat(ctx0, layer.ff2_linear1_w, cur); cur = ggml_silu(ctx0, cur); cur = ggml_mul_mat(ctx0, layer.ff2_linear2_w, cur); cur = ggml_add(ctx0, residual, ggml_scale(ctx0, cur, 0.5)); ggml_format_name(cur, "enc_%d_ffn_res", il); } cur = ggml_norm(ctx0, cur, hparams.eps); cur = ggml_add(ctx0, ggml_mul(ctx0, cur, layer.norm_out_w), layer.norm_out_b); } ggml_set_name(cur, "encoder_out"); pstate.n_frames = cur->ne[1]; struct ggml_tensor * enc_out_view = ggml_view_2d(ctx0, pstate.enc_out, n_state, pstate.n_frames, pstate.enc_out->nb[1], 0); ggml_build_forward_expand(gf, ggml_cpy(ctx0, cur, enc_out_view)); ggml_free(ctx0); return gf; } static bool parakeet_encode_internal( parakeet_context & pctx, parakeet_state & pstate, const int mel_offset, const int n_threads, ggml_abort_callback abort_callback, void * abort_callback_data) { const int64_t t_start_us = ggml_time_us(); auto & sched = pstate.sched_encode.sched; ggml_cgraph * gf = parakeet_build_graph_encode(pctx, pstate); if (!ggml_backend_sched_alloc_graph(sched, gf)) { // should never happen as we pre-allocate the memory return false; } // set mel input { struct ggml_tensor * mel = ggml_graph_get_tensor(gf, "mel"); const auto & mel_inp = pstate.mel; const int n_ctx = pstate.n_audio_ctx > 0 ? pstate.n_audio_ctx : pctx.model.hparams.n_audio_ctx; assert(mel->type == GGML_TYPE_F32); assert(mel_inp.n_mel == pctx.model.hparams.n_mels); pstate.inp_mel.resize(ggml_nelements(mel)); float * dst = pstate.inp_mel.data(); memset(dst, 0, ggml_nbytes(mel)); const int i0 = std::min(mel_offset, mel_inp.n_len); const int i1 = std::min(mel_offset + n_ctx, mel_inp.n_len); memcpy(dst, mel_inp.data.data() + i0 * mel_inp.n_mel, (i1 - i0) * mel_inp.n_mel * sizeof(float)); ggml_backend_tensor_set(mel, pstate.inp_mel.data(), 0, ggml_nelements(mel)*sizeof(float)); } // set attention mask { struct ggml_tensor * attn_mask = ggml_graph_get_tensor(gf, "attn_mask"); const int n_q = attn_mask->ne[1]; const int n_k = attn_mask->ne[0]; const int32_t subsampl_factor = pctx.model.hparams.subsampling_factor; const int n_tokens_real = (pstate.mel.n_len_org + subsampl_factor - 1) / subsampl_factor; std::vector mask_data(n_q * n_k); const float mask_value = -1e30f; if (n_k == n_q) { // full attention for (int q = 0; q < n_q; ++q) { for (int k = 0; k < n_k; ++k) { mask_data[q * n_k + k] = (k >= n_tokens_real) ? mask_value : 0.0f; } } } else { // local attention const int att_left = n_k / 2; for (int q = 0; q < n_q; ++q) { for (int k = 0; k < n_k; ++k) { const int key = q - att_left + k; mask_data[q * n_k + k] = (key >= 0 && key < n_tokens_real) ? 0.0f : mask_value; } } } ggml_backend_tensor_set(attn_mask, mask_data.data(), 0, mask_data.size() * sizeof(float)); } // set local attention skew mask if (struct ggml_tensor * local_mask = ggml_graph_get_tensor(gf, "local_mask")) { const int n_k = local_mask->ne[0]; const int n_q = local_mask->ne[1]; std::vector mask_data(n_q * n_k); const int window_size = n_k - n_q + 1; for (int q = 0; q < n_q; ++q) { for (int k = 0; k < n_k; ++k) { const int rel = k - q; mask_data[q * n_k + k] = (rel >= 0 && rel < window_size) ? 1.0f : 0.0f; } } ggml_backend_tensor_set(local_mask, mask_data.data(), 0, mask_data.size() * sizeof(float)); } // set positional frequency { struct ggml_tensor * pos_freqs_t = ggml_graph_get_tensor(gf, "pos_freqs"); const int d_half = pos_freqs_t->ne[0]; const int n_state = pctx.model.hparams.n_audio_state; const float log_10000 = logf(10000.0f); std::vector freqs(d_half); for (int k = 0; k < d_half; ++k) { freqs[k] = expf(-(float(k * 2) * log_10000 / float(n_state))); } ggml_backend_tensor_set(pos_freqs_t, freqs.data(), 0, freqs.size() * sizeof(float)); } // set relative position offsets { struct ggml_tensor * rel_pos_t = ggml_graph_get_tensor(gf, "rel_positions"); const int window_size = rel_pos_t->ne[1]; std::vector pos(window_size); if (window_size == PARAKEET_LOCAL_ATTN_WINDOW * 2 + 1) { for (int t = 0; t < window_size; ++t) { pos[t] = float(PARAKEET_LOCAL_ATTN_WINDOW - t); } } else { const int n_time = (window_size + 1) / 2; for (int t = 0; t < window_size; ++t) { pos[t] = float(n_time - 1 - t); } } ggml_backend_tensor_set(rel_pos_t, pos.data(), 0, pos.size() * sizeof(float)); } if (!ggml_graph_compute_helper(sched, gf, n_threads)) { return false; } pstate.t_encode_us += ggml_time_us() - t_start_us; pstate.n_encode++; return !(abort_callback && abort_callback(abort_callback_data)); } static bool parakeet_ensure_encode_sched( parakeet_context & pctx, parakeet_state & pstate, int n_audio_ctx) { if (pstate.sched_encode.sched && pstate.sched_encode_n_audio_ctx == n_audio_ctx) { return true; } parakeet_sched_free(pstate.sched_encode); const int32_t prev_n_audio_ctx = pstate.n_audio_ctx; pstate.n_audio_ctx = n_audio_ctx; const int subsampl_factor = pctx.model.hparams.subsampling_factor; const int n_frames_max = (n_audio_ctx + subsampl_factor - 1) / subsampl_factor; if (n_frames_max > pstate.enc_out->ne[1]) { ggml_backend_buffer_free(pstate.enc_out_buffer); pstate.enc_out_buffer = nullptr; pstate.enc_out = nullptr; if (!parakeet_enc_state_init(pstate, pstate.backends[0], pctx.model.hparams.n_audio_state, n_frames_max)) { pstate.sched_encode_n_audio_ctx = 0; pstate.n_audio_ctx = prev_n_audio_ctx; return false; } } const bool ok = parakeet_sched_graph_init(pstate.sched_encode, pstate.backends, [&]() { return parakeet_build_graph_encode(pctx, pstate); }); if (!ok) { pstate.sched_encode_n_audio_ctx = 0; pstate.n_audio_ctx = prev_n_audio_ctx; return false; } pstate.sched_encode_n_audio_ctx = n_audio_ctx; return true; } static struct ggml_tensor * parakeet_build_graph_lstm_layer( struct ggml_context * ctx0, struct ggml_cgraph * gf, struct ggml_tensor * x_t, // the current input token embedding struct ggml_tensor * w_ih, // input to hidden weights (4 weight tensors packed) struct ggml_tensor * w_hh, // hidden to hidden weights (4 weight tensors packed) struct ggml_tensor * b_h, // folded ih+hh bias (4 bias tensors packed) struct ggml_tensor * h_state, // this layers hidden state struct ggml_tensor * c_state, // this layers cell state int li) { // layer index (for tensor naming) ggml_format_name(x_t, "lstm_layer_%d_x_t", li); ggml_format_name(h_state, "lstm_layer_%d_h_state", li); ggml_format_name(c_state, "lstm_layer_%d_c_state", li); // The 4 gates (i, f, o, c) are packed in the same weight tensor. struct ggml_tensor * inp_gates = ggml_mul_mat(ctx0, w_ih, x_t); // Hidden-to-Hidden Projections are also packed in the same weight tensor. // b_h holds the folded ih+hh bias (see parakeet_model_load), so it is // the only bias that needs to be added here. struct ggml_tensor * hid_gates = ggml_mul_mat(ctx0, w_hh, h_state); hid_gates = ggml_add(ctx0, hid_gates, b_h); // Combine the input and hidden contributions of the gates. struct ggml_tensor * gates = ggml_add(ctx0, inp_gates, hid_gates); ggml_format_name(gates, "lstm_layer_%d_gates", li); const int h_dim = h_state->ne[0]; const size_t row_size = ggml_row_size(gates->type, h_dim); // The gates are packed as [i, f, o, c] (reordered at convert time, see // parakeet_model_load), so the three sigmoid-gated outputs (i, f, o) are // contiguous and can be computed with a single ggml_sigmoid call. struct ggml_tensor * ifo = ggml_sigmoid(ctx0, ggml_view_1d(ctx0, gates, 3 * h_dim, 0)); ggml_format_name(ifo, "lstm_layer_%d_ifo", li); // 1. Input Gate at time t. struct ggml_tensor * i_t = ggml_view_1d(ctx0, ifo, h_dim, 0 * row_size); ggml_format_name(i_t, "lstm_layer_%d_i_t", li); // Forget gate. struct ggml_tensor * f_t = ggml_view_1d(ctx0, ifo, h_dim, 1 * row_size); ggml_format_name(f_t, "lstm_layer_%d_f_t", li); // Output gate. struct ggml_tensor * o_t = ggml_view_1d(ctx0, ifo, h_dim, 2 * row_size); ggml_format_name(o_t, "lstm_layer_%d_o_t", li); // Cell gate. struct ggml_tensor * c_t = ggml_tanh(ctx0, ggml_view_1d(ctx0, gates, h_dim, 3 * row_size)); ggml_format_name(c_t, "lstm_layer_%d_c_t", li); // Calculate the new cell state. struct ggml_tensor * c_new = ggml_add(ctx0, ggml_mul(ctx0, f_t, c_state), // apply forget gate to cell state. ggml_mul(ctx0, i_t, c_t)); // apply input gate to cell gate. ggml_build_forward_expand(gf, ggml_cpy(ctx0, c_new, c_state)); // Calculate the new hidden state. struct ggml_tensor * h_new = ggml_mul(ctx0, o_t, ggml_tanh(ctx0, c_new)); ggml_set_output(h_new); ggml_format_name(h_new, "lstm_layer_%d_h_new", li); ggml_build_forward_expand(gf, ggml_cpy(ctx0, h_new, h_state)); return h_new; } static struct ggml_cgraph * parakeet_build_graph_prediction( parakeet_context & pctx, parakeet_state & pstate, const parakeet_batch & batch, bool worst_case) { GGML_UNUSED(worst_case); const auto & model = pctx.model; const auto & hparams = model.hparams; const int n_tokens = batch.n_tokens; struct ggml_init_params params = { /*.mem_size =*/ pstate.sched_decode.meta.size(), /*.mem_buffer =*/ pstate.sched_decode.meta.data(), /*.no_alloc =*/ true, }; struct ggml_context * ctx0 = ggml_init(params); ggml_cgraph * gf = ggml_new_graph_custom(ctx0, PARAKEET_MAX_NODES, false); // Prediction Network struct ggml_tensor * token = ggml_new_tensor_1d(ctx0, GGML_TYPE_I32, n_tokens); ggml_set_name(token, "token_inp"); ggml_set_input(token); struct ggml_tensor * token_embd = ggml_get_rows(ctx0, model.prediction.embed_w, token); struct ggml_tensor * inpL = token_embd; for (int il = 0; il < hparams.n_pred_layers; ++il) { inpL = parakeet_build_graph_lstm_layer(ctx0, gf, inpL, model.prediction.lstm_layer[il].ih_w, model.prediction.lstm_layer[il].hh_w, model.prediction.lstm_layer[il].b_h, pstate.lstm_state.layer[il].h_state, pstate.lstm_state.layer[il].c_state, il); } struct ggml_tensor * pred_out = inpL; ggml_format_name(pred_out, "lstm_pred_out"); // Project the prediction network output to the joint network hidden dimension. struct ggml_tensor * pred = ggml_mul_mat(ctx0, model.joint.pred_w, pred_out); pred = ggml_add(ctx0, pred, model.joint.pred_b); ggml_set_name(pred, "h_pred"); ggml_build_forward_expand(gf, ggml_cpy(ctx0, pred, pstate.pred_out)); ggml_free(ctx0); return gf; } static struct ggml_cgraph * parakeet_build_graph_joint( parakeet_context & pctx, parakeet_state & pstate, const parakeet_batch & batch, bool worst_case) { GGML_UNUSED(worst_case); const auto & model = pctx.model; const auto & hparams = model.hparams; struct ggml_init_params params = { /*.mem_size =*/ pstate.sched_decode.meta.size(), /*.mem_buffer =*/ pstate.sched_decode.meta.data(), /*.no_alloc =*/ true, }; struct ggml_context * ctx0 = ggml_init(params); ggml_cgraph * gf = ggml_new_graph_custom(ctx0, PARAKEET_MAX_NODES, false); struct ggml_tensor * pred = pstate.pred_out; ggml_format_name(pred, "pred"); const int t_idx = batch.i_time[0]; struct ggml_tensor * enc_out = ggml_view_1d(ctx0, pstate.enc_out, hparams.n_audio_state, (size_t) t_idx * pstate.enc_out->nb[1]); ggml_format_name(enc_out, "enc_out_view"); // Project the encoder output to the joint network hidden dimension. struct ggml_tensor * enc = ggml_mul_mat(ctx0, model.joint.enc_w, enc_out); enc = ggml_add(ctx0, enc, model.joint.enc_b); ggml_set_name(enc, "enc"); struct ggml_tensor * joint = ggml_add(ctx0, enc, pred); ggml_set_name(joint, "joint"); joint = ggml_relu(ctx0, joint); struct ggml_tensor * logits = ggml_mul_mat(ctx0, model.joint.net_w, joint); logits = ggml_add(ctx0, logits, model.joint.net_b); ggml_set_output(logits); ggml_set_name(logits, "logits"); struct ggml_tensor * probs = ggml_soft_max(ctx0, logits); struct ggml_tensor * log_probs = ggml_log(ctx0, probs); ggml_set_output(log_probs); ggml_format_name(log_probs, "log_probs"); ggml_build_forward_expand(gf, log_probs); ggml_free(ctx0); return gf; } static bool parakeet_predict( parakeet_context & pctx, parakeet_state & pstate, const parakeet_batch & batch, const int n_threads, ggml_abort_callback abort_callback, void * abort_callback_data) { const int n_tokens = batch.n_tokens; const int64_t t_start_us = ggml_time_us(); { auto & sched = pstate.sched_decode.sched; const int64_t t_build_start_us = ggml_time_us(); ggml_cgraph * gf = parakeet_build_graph_prediction(pctx, pstate, batch, false); pstate.t_predict_build_us += ggml_time_us() - t_build_start_us; const int64_t t_alloc_start_us = ggml_time_us(); if (!ggml_backend_sched_alloc_graph(sched, gf)) { // should never happen as we pre-allocate the memory return false; } pstate.t_predict_alloc_us += ggml_time_us() - t_alloc_start_us; // set the inputs { struct ggml_tensor * token_inp = ggml_graph_get_tensor(gf, "token_inp"); ggml_backend_tensor_set(token_inp, batch.token, 0, n_tokens * ggml_element_size(token_inp)); } const int64_t t_compute_start_us = ggml_time_us(); if (!ggml_graph_compute_helper(sched, gf, n_threads)) { return false; } pstate.t_predict_compute_us += ggml_time_us() - t_compute_start_us; } pstate.t_predict_us += ggml_time_us() - t_start_us; pstate.n_predict++; return !(abort_callback && abort_callback(abort_callback_data)); } static bool parakeet_joint( parakeet_context & pctx, parakeet_state & pstate, const parakeet_batch & batch, const int n_threads, ggml_abort_callback abort_callback, void * abort_callback_data) { const int64_t t_start_us = ggml_time_us(); const auto & model = pctx.model; const auto & hparams = model.hparams; const int n_tokens = batch.n_tokens; auto & logits_out = pstate.logits; struct ggml_tensor * logits; { auto & sched = pstate.sched_decode.sched; ggml_cgraph * gf = parakeet_build_graph_joint(pctx, pstate, batch, false); if (!ggml_backend_sched_alloc_graph(sched, gf)) { // should never happen as we pre-allocate the memory return false; } logits = ggml_graph_node(gf, -1); if (!ggml_graph_compute_helper(sched, gf, n_threads)) { return false; } } const int n_logits = hparams.n_vocab + hparams.n_tdt_durations + 1; // one for the blank token logits_out.resize(n_tokens * n_logits); for (int i = 0; i < n_tokens; i++) { if (batch.logits[i] == 0) { continue; } ggml_backend_tensor_get(logits, logits_out.data() + (n_logits*i), sizeof(float)*(n_logits*i), sizeof(float)*n_logits); } if (batch.n_tokens == 1) { pstate.t_decode_us += ggml_time_us() - t_start_us; pstate.n_decode++; } return !(abort_callback && abort_callback(abort_callback_data)); } static bool is_word_start_token(parakeet_vocab & vocab, parakeet_token token_id) { const std::string & token_str = vocab.id_to_token[token_id]; // check if it starts with the SentencePiece meta-space "▁" (U+2581) or 3-byte UTF-8 character: 0xE2 0x96 0x81 if (!token_str.empty()) { if (token_str.find("\xE2\x96\x81") == 0 || token_str[0] == '_') { return true; } } return false; } static bool is_punctuation_token(parakeet_vocab & vocab, parakeet_token token_id) { const std::string & token_str = vocab.id_to_token[token_id]; static const std::string punct_chars = ".,!?;:'\"-()[]{}"; if (token_str.empty()) { return false; } std::string clean_token = token_str; if (clean_token.find("\xE2\x96\x81") == 0) { clean_token = clean_token.substr(3); // Remove the 3-byte UTF-8 character } else if (clean_token[0] == '_') { clean_token = clean_token.substr(1); } return clean_token.length() == 1 && punct_chars.find(clean_token[0]) != std::string::npos; } // Collapse punctuation timestamps to match the original Parakeet model. // Punctuations symbols like ',', '.' and others are not spoken words but the // model will still produce a duration for these tokens. But since these are // non-spoken we collapse the timestamps so that they don't have an time duration. static void refine_timestamps_tdt(parakeet_vocab & vocab, std::vector & tokens) { if (tokens.empty()) { return; } int64_t last_non_punct_t1 = -1; for (size_t i = 0; i < tokens.size(); ++i) { if (is_punctuation_token(vocab, tokens[i].id)) { if (last_non_punct_t1 >= 0) { tokens[i].t0 = last_non_punct_t1; tokens[i].t1 = last_non_punct_t1; } } else { last_non_punct_t1 = tokens[i].t1; } } } static parakeet_token_data create_token_data( parakeet_context & pctx, parakeet_state & pstate, parakeet_token token_id, int duration_idx, int duration_value, int frame_index, float token_logit, int n_vocab_logits) { float token_sum = 0.0f; for (int i = 0; i < n_vocab_logits; ++i) { token_sum += expf(pstate.logits[i]); } float token_p = expf(token_logit) / token_sum; parakeet_token_data token_data; token_data.id = token_id; token_data.duration_idx = duration_idx; token_data.duration_value = duration_value; token_data.frame_index = frame_index; token_data.p = token_p; token_data.plog = token_logit; token_data.t0 = frame_index * pctx.model.hparams.subsampling_factor; token_data.t1 = (frame_index + duration_value) * pctx.model.hparams.subsampling_factor; token_data.is_word_start = is_word_start_token(pctx.vocab, token_id); return token_data; } static bool parakeet_decode( parakeet_context & pctx, parakeet_state & pstate, parakeet_batch & batch, const int n_threads, const parakeet_full_params * params = nullptr) { const auto & hparams = pctx.model.hparams; const auto & tdt_durations = pctx.model.tdt_durations; const int n_tdt_durations = hparams.n_tdt_durations; const int n_frames = pstate.n_frames; const int blank_id = pctx.vocab.token_blank; const int n_vocab_logits = blank_id + 1; const int max_tokens_per_timestep = hparams.n_max_tokens; // time index into the encoder frame (current time frame) int t = 0; // number of symbols emitted for the current time frame int tokens_emitted = 0; // Start with the blank token (8192) parakeet_token last_token = blank_id; PARAKEET_LOG_DEBUG("parakeet_decode: starting decode with n_frames=%d\n", n_frames); batch.n_tokens = 1; batch.token[0] = last_token; batch.logits[0] = 1; batch.i_time[0] = 0; // run the prediction network for the initial blank token. This will // initialize the LSTM state and produce an initial hidden state that can // be used in the joint network below. if (!parakeet_predict(pctx, pstate, batch, n_threads, params ? params->abort_callback : nullptr, params ? params->abort_callback_user_data : nullptr)) { return false; } // process all time frames of the encoder output while (t < n_frames) { batch.n_tokens = 1; batch.i_time[0] = t; batch.logits[0] = 1; // Use the current encoder frame (t) and the output of the prediction to // generate probabilities for the next token and duration. batch.i_time // is used in to select the correct frame from the encoder output. // The joint network outputs logits for all the tokens in the vocabulary // plus the blank token, and also n_duration logits for the duration // tokens which contain information about how many frames to skip/advance forward. if (!parakeet_joint(pctx, pstate, batch, n_threads, params ? params->abort_callback : nullptr, params ? params->abort_callback_user_data : nullptr)) { return false; } const int64_t t_start_sample_us = ggml_time_us(); // find the best token (greedy). // TODO: implement beam search? int best_token = 0; float max_logit = -1e10f; for (int i = 0; i < n_vocab_logits; ++i) { if (pstate.logits[i] > max_logit) { max_logit = pstate.logits[i]; best_token = i; } } // find the max index of the duration logits, and look up that index // value in the tdt_durations array to get the actual duration value. int best_duration_idx = 0; float best_duration_logit = -1e10f; for (int i = 0; i < n_tdt_durations; ++i) { if (pstate.logits[n_vocab_logits + i] > best_duration_logit) { best_duration_logit = pstate.logits[n_vocab_logits + i]; best_duration_idx = i; } } // look up that max duration index value in the tdt_durations array to // get the actual duration value. int duration = tdt_durations[best_duration_idx]; if (best_token == blank_id) { if (duration == 0) { duration = 1; } // skip forward by duration time frames. t += duration; // reset symbols emitted counter tokens_emitted = 0; // continue without predicting. continue; } // Emit non-blank token at current frame t. pstate.decoded_tokens.push_back(best_token); pstate.t_sample_us += ggml_time_us() - t_start_sample_us; pstate.n_sample++; parakeet_token_data token_data = create_token_data( pctx, pstate, best_token, best_duration_idx, duration, t, max_logit, n_vocab_logits); pstate.decoded_token_data.push_back(token_data); // Call token callback if registered (for real-time streaming) if (params && params->new_token_callback) { params->new_token_callback(&pctx, &pstate, &token_data, params->new_token_callback_user_data); } last_token = best_token; // advance predictor for the non-blank token. batch.token[0] = last_token; if (!parakeet_predict(pctx, pstate, batch, n_threads, params ? params->abort_callback : nullptr, params ? params->abort_callback_user_data : nullptr)) { return false; } // if duration greater than 0, continue looping over the encoder frames // and skip to the updated time frame (t). if (duration > 0) { t += duration; tokens_emitted = 0; continue; } // if duration is zero we stay on the current time frame. tokens_emitted++; if (tokens_emitted >= max_tokens_per_timestep) { t += 1; // forced blank/time advance behavior tokens_emitted = 0; } } return true; } // 500 -> 00:05.000 // 6000 -> 01:00.000 // naive Discrete Fourier Transform // input is real-valued // output is complex-valued static void dft(const float* in, int N, float* out, const parakeet_mel_cache & cache) { const int sin_cos_step = cache.n_fft / N; for (int k = 0; k < N; k++) { float re = 0; float im = 0; for (int n = 0; n < N; n++) { int idx = (k * n * sin_cos_step) % cache.n_fft; // t = 2*M_PI*k*n/N re += in[n]*cache.cos_vals[idx]; // cos(t) im -= in[n]*cache.sin_vals[idx]; // sin(t) } out[k*2 + 0] = re; out[k*2 + 1] = im; } } // Cooley-Tukey FFT // poor man's implementation - use something better // input is real-valued // output is complex-valued static void fft(float* in, int N, float* out, const parakeet_mel_cache & cache) { if (N == 1) { out[0] = in[0]; out[1] = 0; return; } const int half_N = N / 2; if (N - half_N*2 == 1) { dft(in, N, out, cache); return; } float* even = in + N; for (int i = 0; i < half_N; ++i) { even[i]= in[2*i]; } float* even_fft = out + 2 * N; fft(even, half_N, even_fft, cache); float* odd = even; for (int i = 0; i < half_N; ++i) { odd[i] = in[2*i + 1]; } float* odd_fft = even_fft + N; fft(odd, half_N, odd_fft, cache); const int sin_cos_step = cache.n_fft / N; for (int k = 0; k < half_N; k++) { int idx = k * sin_cos_step; // t = 2*M_PI*k/N float re = cache.cos_vals[idx]; // cos(t) float im = -cache.sin_vals[idx]; // sin(t) float re_odd = odd_fft[2*k + 0]; float im_odd = odd_fft[2*k + 1]; out[2*k + 0] = even_fft[2*k + 0] + re*re_odd - im*im_odd; out[2*k + 1] = even_fft[2*k + 1] + re*im_odd + im*re_odd; out[2*(k + half_N) + 0] = even_fft[2*k + 0] - re*re_odd + im*im_odd; out[2*(k + half_N) + 1] = even_fft[2*k + 1] - re*im_odd - im*re_odd; } } struct mel_worker_params { int ith; int window_size; int n_samples; int frame_size; int frame_step; int n_threads; }; static void log_mel_spectrogram_worker_thread( mel_worker_params params, const float * window_func, const std::vector & samples, const parakeet_filters & filters, parakeet_mel & mel, const parakeet_mel_cache & cache) { std::vector fft_in(params.frame_size * 2, 0.0); std::vector fft_out(params.frame_size * 2 * 2 * 2); int n_fb = filters.n_fb; // number of frequency bins int i = params.ith; // make sure n_fb == 1 + (frame_size / 2), bin_0 to bin_nyquist assert(n_fb == 1 + (params.frame_size / 2)); const double eps = 5.960464477539063e-08; // calculate FFT only when fft_in are not all zero for (; i < std::min(params.n_samples / params.frame_step + 1, mel.n_len); i += params.n_threads) { const int offset = i * params.frame_step; const int window_pad_left = (params.frame_size - params.window_size) / 2; // Zero-pad left std::fill(fft_in.begin(), fft_in.begin() + window_pad_left, 0.0f); // Apply windowed samples in the center const int n_to_process = std::min({params.window_size, params.n_samples - offset}); for (int j = 0; j < n_to_process; j++) { fft_in[window_pad_left + j] = window_func[j] * samples[offset + window_pad_left + j]; } // Zero-pad right (and any samples we didn't have) std::fill(fft_in.begin() + window_pad_left + n_to_process, fft_in.begin() + params.frame_size, 0.0f); // FFT fft(fft_in.data(), params.frame_size, fft_out.data(), cache); // Calculate modulus^2 of complex numbers // Use pow(fft_out[2 * j + 0], 2) + pow(fft_out[2 * j + 1], 2) causes inference quality problem? Interesting. for (int j = 0; j < n_fb; j++) { fft_out[j] = (fft_out[2 * j + 0] * fft_out[2 * j + 0] + fft_out[2 * j + 1] * fft_out[2 * j + 1]); } // mel spectrogram for (int j = 0; j < mel.n_mel; j++) { double sum = 0.0; // unroll loop (suggested by GH user @lunixbochs) int k = 0; for (k = 0; k < n_fb - 3; k += 4) { sum += fft_out[k + 0] * filters.data[j * n_fb + k + 0] + fft_out[k + 1] * filters.data[j * n_fb + k + 1] + fft_out[k + 2] * filters.data[j * n_fb + k + 2] + fft_out[k + 3] * filters.data[j * n_fb + k + 3]; } // handle n_fb remainder for (; k < n_fb; k++) { sum += fft_out[k] * filters.data[j * n_fb + k]; } mel.data[i * mel.n_mel + j] = std::log(sum + eps); } } // Otherwise fft_out are all zero - use log(eps) for consistency const double empty_sum = std::log(eps); for (; i < mel.n_len; i += params.n_threads) { for (int j = 0; j < mel.n_mel; j++) { mel.data[i * mel.n_mel + j] = empty_sum; } } } static bool log_mel_spectrogram( parakeet_state & wstate, const float * samples, const int n_samples, const int /*sample_rate*/, const int frame_size, const int frame_step, const int n_mel, const int n_threads, const parakeet_filters & filters, const bool debug, parakeet_mel & mel, const parakeet_mel_cache & cache) { const int64_t t_start_us = ggml_time_us(); const float * window_func = cache.window.empty() ? cache.hann_window.data() : cache.window.data(); const int window_size = cache.window.empty() ? cache.n_fft : cache.window.size(); std::vector samples_preprocessed(samples, samples + n_samples); // Apply preemphasis filter (high-pass): x[i] = x[i] - 0.97 * x[i-1] { const float preemph = 0.97f; for (int i = n_samples - 1; i > 0; i--) { samples_preprocessed[i] = samples_preprocessed[i] - preemph * samples_preprocessed[i - 1]; } } // Parakeet Pytorch implementation uses centered contant padding. const size_t pad = (size_t)(frame_size / 2); std::vector samples_padded(n_samples + 2 * pad, 0.0f); std::copy(samples_preprocessed.begin(), samples_preprocessed.end(), samples_padded.begin() + pad); mel.n_mel = n_mel; mel.n_len = (samples_padded.size() - frame_size) / frame_step + 1; mel.n_len_org = mel.n_len; mel.data.resize(mel.n_mel * mel.n_len); // Worker Threads (STFT + Mel + Natural Log) { std::vector workers(n_threads - 1); const mel_worker_params mel_params { 0, window_size, (int)samples_padded.size(), frame_size, frame_step, n_threads }; for (int iw = 0; iw < n_threads - 1; ++iw) { mel_worker_params params = mel_params; params.ith = iw + 1; workers[iw] = std::thread(log_mel_spectrogram_worker_thread, params, window_func, std::cref(samples_padded), std::cref(filters), std::ref(mel), std::cref(cache)); } log_mel_spectrogram_worker_thread( mel_params, window_func, samples_padded, filters, mel, cache); for (int iw = 0; iw < n_threads - 1; ++iw) { workers[iw].join(); } } { const double eps = 1e-5; int valid_frames = n_samples / frame_step; for (int j = 0; j < mel.n_mel; j++) { double sum = 0.0; double sq_diff_sum = 0.0; // Calculate Mean ONLY on valid audio frames for (int i = 0; i < valid_frames; i++) { sum += (double)mel.data[i * mel.n_mel + j]; } double mean = sum / valid_frames; // Calculate Variance ONLY on valid audio frames for (int i = 0; i < valid_frames; i++) { double diff = (double)mel.data[i * mel.n_mel + j] - mean; sq_diff_sum += diff * diff; } double std_dev = std::sqrt(sq_diff_sum / (valid_frames - 1.0)); double denominator = std_dev + eps; // Apply to ALL frames (including the padded ones) for (int i = 0; i < mel.n_len; i++) { mel.data[i * mel.n_mel + j] = (float)((mel.data[i * mel.n_mel + j] - mean) / denominator); } } } wstate.t_mel_us += ggml_time_us() - t_start_us; if (debug) { std::ofstream outFile("log_mel_spectrogram.json"); outFile << "["; for (uint64_t i = 0; i < mel.data.size() - 1; i++) { outFile << mel.data[i] << ", "; } outFile << mel.data[mel.data.size() - 1] << "]"; outFile.close(); } return true; } static std::vector tokenize(const parakeet_vocab & vocab, const std::string & text) { std::vector tokens; const std::string normalized = sentencepiece_normalize(text); size_t i = 0; while (i < normalized.size()) { const size_t remaining = normalized.size() - i; const size_t max_len = std::min(vocab.max_token_length, remaining); bool found = false; for (size_t len = max_len; len > 0; --len) { const auto it = vocab.token_to_id.find(normalized.substr(i, len)); if (it != vocab.token_to_id.end() && !is_sentencepiece_control(it->first)) { tokens.push_back(it->second); i += len; found = true; break; } } if (!found) { if (vocab.token_unk >= 0) { tokens.push_back(vocab.token_unk); } const unsigned char c = static_cast(normalized[i]); i += utf8_codepoint_len(c); } } return tokens; } // // interface implementation // struct parakeet_state * parakeet_init_state(parakeet_context * ctx) { parakeet_state * state = new parakeet_state; state->backends = parakeet_backend_init(ctx->params); if (state->backends.empty()) { PARAKEET_LOG_ERROR("%s: parakeet_backend_init() failed\n", __func__); parakeet_free_state(state); return nullptr; } const int batch_size = ctx->model.hparams.n_audio_ctx; state->logits.reserve(ctx->vocab.n_vocab * batch_size); state->batch = parakeet_batch_init(batch_size); { const int n_audio_state = ctx->model.hparams.n_audio_state; const int subsampl_factor = ctx->model.hparams.subsampling_factor; const int n_frames_max = (batch_size + subsampl_factor - 1) / subsampl_factor; if (!parakeet_enc_state_init(*state, state->backends[0], n_audio_state, n_frames_max)) { PARAKEET_LOG_ERROR("%s: parakeet_enc_state_init() failed\n", __func__); parakeet_free_state(state); return nullptr; } const size_t mem_enc_ctx = state->enc_out_buf.size(); const size_t mem_enc_out_buf = ggml_backend_buffer_get_size(state->enc_out_buffer); PARAKEET_LOG_INFO("%s: enc_out state: %7.2f MB (meta) + %7.2f MB (data)\n", __func__, mem_enc_ctx / 1024.0 / 1024.0, mem_enc_out_buf / 1024.0 / 1024.0); } // conv/encoder allocator bool ok = parakeet_sched_graph_init(state->sched_encode, state->backends, [&]() { return parakeet_build_graph_encode(*ctx, *state); }); if (!ok) { PARAKEET_LOG_ERROR("%s: failed to init encode allocator\n", __func__); parakeet_free_state(state); return nullptr; } state->sched_encode_n_audio_ctx = state->n_audio_ctx > 0 ? state->n_audio_ctx : ctx->model.hparams.n_audio_ctx; if (!parakeet_lstm_state_init(*state, state->backends[0], ctx->model.hparams.n_pred_layers, ctx->model.hparams.n_pred_dim)) { PARAKEET_LOG_ERROR("%s: parakeet_lstm_states_init () failed\n", __func__); parakeet_free_state(state); return nullptr; } { const size_t mem_lstm_ctx = state->lstm_state.ctx_buf.size(); const size_t mem_lstm_buf = ggml_backend_buffer_get_size(state->lstm_state.buffer); PARAKEET_LOG_INFO("%s: lstm state: %7.2f MB (meta) + %7.2f MB (data)\n", __func__, mem_lstm_ctx / 1024.0 / 1024.0, mem_lstm_buf / 1024.0 / 1024.0); } if (!parakeet_pred_state_init(*state, state->backends[0], ctx->model.hparams.n_pred_dim)) { PARAKEET_LOG_ERROR("%s: parakeet_pred_state_init() failed\n", __func__); parakeet_free_state(state); return nullptr; } { const size_t mem_pred_ctx = state->pred_out_buf.size(); const size_t mem_pred_out_buf = ggml_backend_buffer_get_size(state->pred_out_buffer); PARAKEET_LOG_INFO("%s: pred state: %7.2f MB (meta) + %7.2f MB (data)\n", __func__, mem_pred_ctx / 1024.0 / 1024.0, mem_pred_out_buf / 1024.0 / 1024.0); } PARAKEET_LOG_INFO("%s: compute buffer (encode) = %7.2f MB\n", __func__, parakeet_sched_size(state->sched_encode) / 1e6); { bool ok = parakeet_sched_graph_init(state->sched_decode, state->backends, [&]() { const auto & hparams = ctx->model.hparams; const int n_tokens = hparams.n_audio_ctx; // Use audio ctx for Parakeet parakeet_batch_prep_legacy(state->batch, nullptr, n_tokens, 0, 0); return parakeet_build_graph_prediction(*ctx, *state, state->batch, true); }); if (!ok) { PARAKEET_LOG_ERROR("%s: failed to init decoder allocator\n", __func__); parakeet_free_state(state); return nullptr; } PARAKEET_LOG_INFO("%s: compute buffer (decode) = %7.2f MB\n", __func__, parakeet_sched_size(state->sched_decode) / 1e6); } return state; } struct parakeet_context_params parakeet_context_default_params() { struct parakeet_context_params result = { /*.use_gpu =*/ true, /*.gpu_device =*/ 0, }; return result; } struct parakeet_context * parakeet_init_from_file_with_params_no_state(const char * path_model, struct parakeet_context_params params) { PARAKEET_LOG_INFO("%s: loading model from '%s'\n", __func__, path_model); #ifdef _MSC_VER // Convert UTF-8 path to wide string (UTF-16) for Windows, resolving character encoding issues. std::wstring_convert> converter; std::wstring path_model_wide = converter.from_bytes(path_model); auto fin = std::ifstream(path_model_wide, std::ios::binary); #else auto fin = std::ifstream(path_model, std::ios::binary); #endif if (!fin) { PARAKEET_LOG_ERROR("%s: failed to open '%s'\n", __func__, path_model); return nullptr; } parakeet_model_loader loader = {}; loader.context = &fin; loader.read = [](void * ctx, void * output, size_t read_size) { std::ifstream * fin = (std::ifstream*)ctx; fin->read((char *)output, read_size); return read_size; }; loader.eof = [](void * ctx) { std::ifstream * fin = (std::ifstream*)ctx; return fin->eof(); }; loader.close = [](void * ctx) { std::ifstream * fin = (std::ifstream*)ctx; fin->close(); }; auto ctx = parakeet_init_with_params_no_state(&loader, params); if (ctx) { ctx->path_model = path_model; } return ctx; } struct parakeet_context * parakeet_init_from_buffer_with_params_no_state(void * buffer, size_t buffer_size, struct parakeet_context_params params) { struct buf_context { uint8_t* buffer; size_t size; size_t current_offset; }; buf_context ctx = { reinterpret_cast(buffer), buffer_size, 0 }; PARAKEET_LOG_INFO("%s: loading model from buffer\n", __func__); parakeet_model_loader loader = {}; loader.context = &ctx; loader.read = [](void * ctx, void * output, size_t read_size) { buf_context * buf = reinterpret_cast(ctx); size_t size_to_copy = buf->current_offset + read_size < buf->size ? read_size : buf->size - buf->current_offset; memcpy(output, buf->buffer + buf->current_offset, size_to_copy); buf->current_offset += size_to_copy; return size_to_copy; }; loader.eof = [](void * ctx) { buf_context * buf = reinterpret_cast(ctx); return buf->current_offset >= buf->size; }; loader.close = [](void * /*ctx*/) { }; return parakeet_init_with_params_no_state(&loader, params); } struct parakeet_context * parakeet_init_with_params_no_state(struct parakeet_model_loader * loader, struct parakeet_context_params params) { ggml_time_init(); PARAKEET_LOG_INFO("%s: use gpu = %d\n", __func__, params.use_gpu); PARAKEET_LOG_INFO("%s: gpu_device = %d\n", __func__, params.gpu_device); PARAKEET_LOG_INFO("%s: devices = %zu\n", __func__, ggml_backend_dev_count()); PARAKEET_LOG_INFO("%s: backends = %zu\n", __func__, ggml_backend_reg_count()); parakeet_context * ctx = new parakeet_context; ctx->params = params; bool model_loaded = false; try { model_loaded = parakeet_model_load(loader, *ctx); } catch (const std::exception & e) { PARAKEET_LOG_ERROR("%s: exception during model load: %s\n", __func__, e.what()); } catch (...) { PARAKEET_LOG_ERROR("%s: unknown exception during model load\n", __func__); } if (!model_loaded) { loader->close(loader->context); PARAKEET_LOG_ERROR("%s: failed to load model\n", __func__); delete ctx; return nullptr; } loader->close(loader->context); // Initialize mel cache with model's FFT size ctx->mel_cache.init(ctx->model.hparams.n_fft); PARAKEET_LOG_INFO("%s: initialized mel cache with n_fft = %d\n", __func__, ctx->model.hparams.n_fft); return ctx; } struct parakeet_context * parakeet_init_from_file_with_params(const char * path_model, struct parakeet_context_params params) { parakeet_context * ctx = parakeet_init_from_file_with_params_no_state(path_model, params); if (!ctx) { return nullptr; } ctx->state = parakeet_init_state(ctx); if (!ctx->state) { parakeet_free(ctx); return nullptr; } return ctx; } struct parakeet_context * parakeet_init_from_buffer_with_params(void * buffer, size_t buffer_size, struct parakeet_context_params params) { parakeet_context * ctx = parakeet_init_from_buffer_with_params_no_state(buffer, buffer_size, params); if (!ctx) { return nullptr; } ctx->state = parakeet_init_state(ctx); if (!ctx->state) { parakeet_free(ctx); return nullptr; } return ctx; } struct parakeet_context * parakeet_init_with_params(struct parakeet_model_loader * loader, struct parakeet_context_params params) { parakeet_context * ctx = parakeet_init_with_params_no_state(loader, params); if (!ctx) { return nullptr; } ctx->state = parakeet_init_state(ctx); if (!ctx->state) { parakeet_free(ctx); return nullptr; } return ctx; } void parakeet_free_state(struct parakeet_state * state) { if (state) { ggml_backend_buffer_free(state->lstm_state.buffer); ggml_backend_buffer_free(state->pred_out_buffer); ggml_backend_buffer_free(state->enc_out_buffer); parakeet_batch_free(state->batch); parakeet_sched_free(state->sched_encode); parakeet_sched_free(state->sched_decode); for (auto & backend : state->backends) { ggml_backend_free(backend); } delete state; } } void parakeet_free(struct parakeet_context * ctx) { if (ctx) { for (ggml_context * context : ctx->model.ctxs) { ggml_free(context); } for (ggml_backend_buffer_t buf : ctx->model.buffers) { ggml_backend_buffer_free(buf); } parakeet_free_state(ctx->state); delete ctx; } } void parakeet_free_context_params(struct parakeet_context_params * params) { if (params) { delete params; } } void parakeet_free_params(struct parakeet_full_params * params) { if (params) { delete params; } } int parakeet_pcm_to_mel_with_state(struct parakeet_context * ctx, struct parakeet_state * state, const float * samples, int n_samples, int n_threads) { if (!log_mel_spectrogram(*state, samples, n_samples, PARAKEET_SAMPLE_RATE, ctx->model.hparams.n_fft, PARAKEET_HOP_LENGTH, ctx->model.filters.n_mel, n_threads, ctx->model.filters, false, // debug state->mel, ctx->mel_cache)) { PARAKEET_LOG_ERROR("%s: failed to compute mel spectrogram\n", __func__); return -1; } return 0; } int parakeet_pcm_to_mel(struct parakeet_context * ctx, const float * samples, int n_samples, int n_threads) { return parakeet_pcm_to_mel_with_state(ctx, ctx->state, samples, n_samples, n_threads); } int parakeet_set_mel_with_state( struct parakeet_context * ctx, struct parakeet_state * state, const float * data, int n_len, int n_mel) { if (n_mel != ctx->model.filters.n_mel) { PARAKEET_LOG_ERROR("%s: invalid number of mel bands: %d (expected %d)\n", __func__, n_mel, ctx->model.filters.n_mel); return -1; } state->mel.n_len = n_len; state->mel.n_len_org = n_len; state->mel.n_mel = n_mel; state->mel.data.resize(n_len*n_mel); memcpy(state->mel.data.data(), data, n_len*n_mel*sizeof(float)); return 0; } int parakeet_set_mel( struct parakeet_context * ctx, const float * data, int n_len, int n_mel) { return parakeet_set_mel_with_state(ctx, ctx->state, data, n_len, n_mel); } int parakeet_encode_with_state(struct parakeet_context * ctx, struct parakeet_state * state, int offset, int n_threads) { if (!parakeet_encode_internal(*ctx, *state, offset, n_threads, nullptr, nullptr)) { PARAKEET_LOG_ERROR("%s: failed to eval\n", __func__); return -1; } return 0; } int parakeet_encode(struct parakeet_context * ctx, int offset, int n_threads) { if (!parakeet_encode_internal(*ctx, *ctx->state, offset, n_threads, nullptr, nullptr)) { PARAKEET_LOG_ERROR("%s: failed to eval\n", __func__); return -1; } return 0; } int parakeet_tokenize(struct parakeet_context * ctx, const char * text, parakeet_token * tokens, int n_max_tokens) { const auto res = tokenize(ctx->vocab, text); if (n_max_tokens < (int) res.size()) { PARAKEET_LOG_ERROR("%s: too many resulting tokens: %d (max %d)\n", __func__, (int) res.size(), n_max_tokens); return -(int) res.size(); } for (int i = 0; i < (int) res.size(); i++) { tokens[i] = res[i]; } return res.size(); } int parakeet_token_count(struct parakeet_context * ctx, const char * text) { return -parakeet_tokenize(ctx, text, NULL, 0); } int parakeet_model_n_vocab(struct parakeet_context * ctx) { return ctx->model.hparams.n_vocab; } int parakeet_model_n_audio_ctx(struct parakeet_context * ctx) { return ctx->model.hparams.n_audio_ctx; } int parakeet_model_n_audio_state(struct parakeet_context * ctx) { return ctx->model.hparams.n_audio_state; } int parakeet_model_n_audio_head(struct parakeet_context * ctx) { return ctx->model.hparams.n_audio_head; } int parakeet_model_n_audio_layer(struct parakeet_context * ctx) { return ctx->model.hparams.n_audio_layer; } int parakeet_model_n_mels(struct parakeet_context * ctx) { return ctx->model.hparams.n_mels; } int parakeet_model_ftype(struct parakeet_context * ctx) { return ctx->model.hparams.ftype; } int parakeet_n_len_from_state(struct parakeet_state * state) { return state->mel.n_len_org; } int parakeet_n_len(struct parakeet_context * ctx) { return ctx->state->mel.n_len_org; } int parakeet_n_vocab(struct parakeet_context * ctx) { return ctx->vocab.n_vocab; } int parakeet_n_audio_ctx(struct parakeet_context * ctx) { return ctx->model.hparams.n_audio_ctx; } float * parakeet_get_logits(struct parakeet_context * ctx) { return ctx->state->logits.data(); } float * parakeet_get_logits_from_state(struct parakeet_state * state) { return state->logits.data(); } const char * parakeet_token_to_str(struct parakeet_context * ctx, parakeet_token token) { return ctx->vocab.id_to_token.at(token).c_str(); } int parakeet_token_to_text(const char * token_str, bool is_first, char * output, int max_len) { std::string text = sentencepiece_piece_to_text(token_str, is_first); if (output == nullptr) { return text.size(); } int bytes_to_copy = std::min((int)text.size(), max_len - 1); if (bytes_to_copy > 0) { memcpy(output, text.c_str(), bytes_to_copy); output[bytes_to_copy] = '\0'; } else if (max_len > 0) { output[0] = '\0'; } return text.size(); } parakeet_token parakeet_token_bos(struct parakeet_context * ctx) { return ctx->vocab.token_bos; } parakeet_token parakeet_token_unk(struct parakeet_context * ctx) { return ctx->vocab.token_unk; } parakeet_token parakeet_token_blank(struct parakeet_context * ctx) { return ctx->vocab.token_blank; } struct parakeet_timings * parakeet_get_timings(struct parakeet_context * ctx) { if (ctx->state == nullptr) { return nullptr; } parakeet_timings * timings = new parakeet_timings; timings->sample_ms = 1e-3f * ctx->state->t_sample_us / std::max(1, ctx->state->n_sample); timings->encode_ms = 1e-3f * ctx->state->t_encode_us / std::max(1, ctx->state->n_encode); timings->decode_ms = 1e-3f * ctx->state->t_decode_us / std::max(1, ctx->state->n_decode); return timings; } void parakeet_print_timings(struct parakeet_context * ctx) { const int64_t t_end_us = ggml_time_us(); PARAKEET_LOG_INFO("\n"); PARAKEET_LOG_INFO("%s: load time = %8.2f ms\n", __func__, ctx->t_load_us / 1000.0f); if (ctx->state != nullptr) { const int32_t n_sample = std::max(1, ctx->state->n_sample); const int32_t n_encode = std::max(1, ctx->state->n_encode); const int32_t n_decode = std::max(1, ctx->state->n_decode); const int32_t n_predict = std::max(1, ctx->state->n_predict); PARAKEET_LOG_INFO("%s: fallbacks = %3d p / %3d h\n", __func__, ctx->state->n_fail_p, ctx->state->n_fail_h); PARAKEET_LOG_INFO("%s: mel time = %8.2f ms\n", __func__, ctx->state->t_mel_us / 1000.0f); PARAKEET_LOG_INFO("%s: sample time = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_sample_us, n_sample, 1e-3f * ctx->state->t_sample_us / n_sample); PARAKEET_LOG_INFO("%s: encode time = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_encode_us, n_encode, 1e-3f * ctx->state->t_encode_us / n_encode); PARAKEET_LOG_INFO("%s: decode time = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_decode_us, n_decode, 1e-3f * ctx->state->t_decode_us / n_decode); PARAKEET_LOG_INFO("%s: predict time = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_predict_us, n_predict, 1e-3f * ctx->state->t_predict_us / n_predict); PARAKEET_LOG_INFO("%s: - build = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_predict_build_us, n_predict, 1e-3f * ctx->state->t_predict_build_us / n_predict); PARAKEET_LOG_INFO("%s: - alloc = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_predict_alloc_us, n_predict, 1e-3f * ctx->state->t_predict_alloc_us / n_predict); PARAKEET_LOG_INFO("%s: - compute = %8.2f ms / %5d runs ( %8.2f ms per run)\n", __func__, 1e-3f * ctx->state->t_predict_compute_us, n_predict, 1e-3f * ctx->state->t_predict_compute_us / n_predict); } PARAKEET_LOG_INFO("%s: total time = %8.2f ms\n", __func__, (t_end_us - ctx->t_start_us)/1000.0f); } void parakeet_reset_timings(struct parakeet_context * ctx) { ctx->t_start_us = ggml_time_us(); if (ctx->state != nullptr) { ctx->state->t_mel_us = 0; ctx->state->t_sample_us = 0; ctx->state->t_encode_us = 0; ctx->state->t_decode_us = 0; ctx->state->t_predict_us = 0; ctx->state->t_predict_build_us = 0; ctx->state->t_predict_alloc_us = 0; ctx->state->t_predict_compute_us = 0; ctx->state->n_sample = 0; ctx->state->n_encode = 0; ctx->state->n_decode = 0; ctx->state->n_predict = 0; } } const char * parakeet_print_system_info(void) { static std::string s; s = ""; s += "PARAKEET : "; for (size_t i = 0; i < ggml_backend_reg_count(); i++) { auto * reg = ggml_backend_reg_get(i); auto * get_features_fn = (ggml_backend_get_features_t) ggml_backend_reg_get_proc_address(reg, "ggml_backend_get_features"); if (get_features_fn) { ggml_backend_feature * features = get_features_fn(reg); s += ggml_backend_reg_name(reg); s += " : "; for (; features->name; features++) { s += features->name; s += " = "; s += features->value; s += " | "; } } } return s.c_str(); } struct parakeet_context_params * parakeet_context_default_params_by_ref(void) { struct parakeet_context_params params = parakeet_context_default_params(); struct parakeet_context_params* result = new parakeet_context_params(); *result = params; return result; } struct parakeet_full_params * parakeet_full_default_params_by_ref(enum parakeet_sampling_strategy strategy) { struct parakeet_full_params params = parakeet_full_default_params(strategy); struct parakeet_full_params* result = new parakeet_full_params(); *result = params; return result; } struct parakeet_full_params parakeet_full_default_params(enum parakeet_sampling_strategy strategy) { struct parakeet_full_params result = { /*.strategy =*/ strategy, /*.n_threads =*/ std::min(4, (int32_t) std::thread::hardware_concurrency()), /*.offset_ms =*/ 0, /*.duration_ms =*/ 0, /*.no_context =*/ true, /*.audio_ctx =*/ 0, /*.new_token_callback =*/ nullptr, /*.new_token_callback_user_data =*/ nullptr, /*.new_segment_callback =*/ nullptr, /*.new_segment_callback_user_data =*/ nullptr, /*.progress_callback =*/ nullptr, /*.progress_callback_user_data =*/ nullptr, /*.encoder_begin_callback =*/ nullptr, /*.encoder_begin_callback_user_data =*/ nullptr, /*.abort_callback =*/ nullptr, /*.abort_callback_user_data =*/ nullptr, }; return result; } static void parakeet_reset_state(struct parakeet_state * state) { state->decoded_tokens.clear(); state->decoded_token_data.clear(); if (state->lstm_state.buffer) { ggml_backend_buffer_clear(state->lstm_state.buffer, 0); } } // Encode and decode the mel spectrogram already in state, without recomputing it. static int parakeet_chunk_with_state( struct parakeet_context * ctx, struct parakeet_state * state, struct parakeet_full_params params) { return parakeet_chunk(ctx, state, params, nullptr, 0); } int parakeet_full_with_state( struct parakeet_context * ctx, struct parakeet_state * state, struct parakeet_full_params params, const float * samples, int n_samples) { state->result_all.clear(); if (params.no_context) { parakeet_reset_state(state); } if (n_samples > 0) { if (parakeet_pcm_to_mel_with_state(ctx, state, samples, n_samples, params.n_threads) != 0) { PARAKEET_LOG_ERROR("%s: failed to compute log mel spectrogram\n", __func__); return -2; } } const int n_mel_total = state->mel.n_len; const int n_audio_ctx = ctx->model.hparams.n_audio_ctx; if (n_mel_total <= n_audio_ctx) { if (params.progress_callback) { params.progress_callback(ctx, state, 0, params.progress_callback_user_data); } return parakeet_chunk_with_state(ctx, state, params); } PARAKEET_LOG_DEBUG("%s: audio too long (%d mel > n_audio_ctx=%d), using dynamic encoder graph\n", __func__, n_mel_total, n_audio_ctx); if (params.encoder_begin_callback) { if (!params.encoder_begin_callback(ctx, state, params.encoder_begin_callback_user_data)) { PARAKEET_LOG_ERROR("%s: encoder_begin_callback returned false\n", __func__); return -6; } } if (params.progress_callback) { params.progress_callback(ctx, state, 0, params.progress_callback_user_data); } if (!parakeet_ensure_encode_sched(*ctx, *state, n_mel_total)) { PARAKEET_LOG_ERROR("%s: failed to allocate dynamic encoder graph for %d mel frames\n", __func__, n_mel_total); return -6; } state->n_audio_ctx = n_mel_total; if (!parakeet_encode_internal(*ctx, *state, 0, params.n_threads, params.abort_callback, params.abort_callback_user_data)) { PARAKEET_LOG_ERROR("%s: failed to encode\n", __func__); return -6; } if (params.progress_callback) { params.progress_callback(ctx, state, 100, params.progress_callback_user_data); } const size_t tokens_before = state->decoded_tokens.size(); if (!parakeet_decode(*ctx, *state, state->batch, params.n_threads, ¶ms)) { PARAKEET_LOG_ERROR("%s: failed to decode\n", __func__); return -7; } const size_t tokens_after = state->decoded_tokens.size(); const size_t new_token_count = tokens_after - tokens_before; if (new_token_count > 0) { std::string text; std::vector result_tokens; for (size_t i = tokens_before; i < tokens_after; i++) { const auto token_id = state->decoded_tokens[i]; const char * tok_str = parakeet_token_to_str(ctx, token_id); if (tok_str) { const bool is_first = (tokens_before == 0) && text.empty(); text += sentencepiece_piece_to_text(tok_str, is_first); } result_tokens.push_back(state->decoded_token_data[i]); } refine_timestamps_tdt(ctx->vocab, result_tokens); if (!text.empty()) { parakeet_segment seg; seg.t0 = 0; seg.t1 = state->n_frames; seg.text = text; seg.tokens = result_tokens; state->result_all.push_back(std::move(seg)); if (params.new_segment_callback) { params.new_segment_callback(ctx, state, 1, params.new_segment_callback_user_data); } } } return 0; } int parakeet_full( struct parakeet_context * ctx, struct parakeet_full_params params, const float * samples, int n_samples) { return parakeet_full_with_state(ctx, ctx->state, params, samples, n_samples); } int parakeet_chunk( struct parakeet_context * ctx, struct parakeet_state * state, struct parakeet_full_params params, const float * samples, int n_samples) { if (params.no_context) { parakeet_reset_state(state); } if (n_samples > 0) { if (parakeet_pcm_to_mel_with_state(ctx, state, samples, n_samples, params.n_threads) != 0) { PARAKEET_LOG_ERROR("%s: failed to compute log mel spectrogram\n", __func__); return -2; } } if (params.audio_ctx == 0) { const int total_len = parakeet_n_len_from_state(state); const int model_max_ctx = parakeet_n_audio_ctx(ctx); params.audio_ctx = std::min(total_len, model_max_ctx); PARAKEET_LOG_DEBUG("Processing audio: total_frames=%d, chunk_size=%d\n", total_len, params.audio_ctx); } state->n_audio_ctx = params.audio_ctx; const int n_frames = parakeet_n_len_from_state(state); if (!parakeet_ensure_encode_sched(*ctx, *state, state->n_audio_ctx)) { PARAKEET_LOG_ERROR("%s: failed to allocate encoder graph for %d mel frames\n", __func__, state->n_audio_ctx); return -6; } if (params.encoder_begin_callback) { if (!params.encoder_begin_callback(ctx, state, params.encoder_begin_callback_user_data)) { PARAKEET_LOG_ERROR("%s: encoder_begin_callback returned false - aborting\n", __func__); return -6; } } if (!parakeet_encode_internal(*ctx, *state, 0, params.n_threads, params.abort_callback, params.abort_callback_user_data)) { PARAKEET_LOG_ERROR("%s: failed to encode\n", __func__); return -6; } const size_t tokens_before = state->decoded_tokens.size(); if (!parakeet_decode(*ctx, *state, state->batch, params.n_threads, ¶ms)) { PARAKEET_LOG_ERROR("%s: failed to decode\n", __func__); return -7; } const size_t tokens_after = state->decoded_tokens.size(); const size_t new_token_count = tokens_after - tokens_before; if (new_token_count > 0) { std::string text; std::vector result_tokens; for (size_t i = tokens_before; i < tokens_after; i++) { const auto token_id = state->decoded_tokens[i]; const char * token_str = parakeet_token_to_str(ctx, token_id); if (token_str) { const bool is_first_piece = (tokens_before == 0) && text.empty(); text += sentencepiece_piece_to_text(token_str, is_first_piece); } // Use the stored token data from parakeet_decode result_tokens.push_back(state->decoded_token_data[i]); } refine_timestamps_tdt(ctx->vocab, result_tokens); if (!text.empty()) { parakeet_segment segment; segment.t0 = 0; // Caller tracks timing segment.t1 = n_frames; segment.text = text; segment.tokens = result_tokens; state->result_all.push_back(std::move(segment)); if (params.new_segment_callback) { params.new_segment_callback(ctx, state, 1, params.new_segment_callback_user_data); } } } return 0; } int parakeet_full_n_segments_from_state(struct parakeet_state * state) { return state->result_all.size(); } int parakeet_full_n_segments(struct parakeet_context * ctx) { return ctx->state->result_all.size(); } int64_t parakeet_full_get_segment_t0_from_state(struct parakeet_state * state, int i_segment) { return state->result_all[i_segment].t0; } int64_t parakeet_full_get_segment_t1_from_state(struct parakeet_state * state, int i_segment) { return state->result_all[i_segment].t1; } int64_t parakeet_full_get_segment_t0(struct parakeet_context * ctx, int i_segment) { return parakeet_full_get_segment_t0_from_state(ctx->state, i_segment); } int64_t parakeet_full_get_segment_t1(struct parakeet_context * ctx, int i_segment) { return parakeet_full_get_segment_t1_from_state(ctx->state, i_segment); } const char * parakeet_full_get_segment_text_from_state(struct parakeet_state * state, int i_segment) { return state->result_all[i_segment].text.c_str(); } const char * parakeet_full_get_segment_text(struct parakeet_context * ctx, int i_segment) { return ctx->state->result_all[i_segment].text.c_str(); } int parakeet_full_n_tokens_from_state(struct parakeet_state * state, int i_segment) { return state->result_all[i_segment].tokens.size(); } int parakeet_full_n_tokens(struct parakeet_context * ctx, int i_segment) { return ctx->state->result_all[i_segment].tokens.size(); } const char * parakeet_full_get_token_text_from_state(struct parakeet_context * ctx, struct parakeet_state * state, int i_segment, int i_token) { return ctx->vocab.id_to_token[state->result_all[i_segment].tokens[i_token].id].c_str(); } const char* parakeet_full_get_token_text(struct parakeet_context * ctx, int i_segment, int i_token) { return ctx->vocab.id_to_token[ctx->state->result_all[i_segment].tokens[i_token].id].c_str(); } parakeet_token parakeet_full_get_token_id_from_state(struct parakeet_state * state, int i_segment, int i_token) { return state->result_all[i_segment].tokens[i_token].id; } parakeet_token parakeet_full_get_token_id(struct parakeet_context * ctx, int i_segment, int i_token) { return ctx->state->result_all[i_segment].tokens[i_token].id; } struct parakeet_token_data parakeet_full_get_token_data_from_state(struct parakeet_state * state, int i_segment, int i_token) { return state->result_all[i_segment].tokens[i_token]; } struct parakeet_token_data parakeet_full_get_token_data(struct parakeet_context * ctx, int i_segment, int i_token) { return ctx->state->result_all[i_segment].tokens[i_token]; } float parakeet_full_get_token_p_from_state(struct parakeet_state * state, int i_segment, int i_token) { return state->result_all[i_segment].tokens[i_token].p; } float parakeet_full_get_token_p(struct parakeet_context * ctx, int i_segment, int i_token) { return ctx->state->result_all[i_segment].tokens[i_token].p; } void parakeet_log_set(ggml_log_callback log_callback, void * user_data) { g_state.log_callback = log_callback ? log_callback : parakeet_log_callback_default; g_state.log_callback_user_data = user_data; ggml_log_set(g_state.log_callback, g_state.log_callback_user_data); } const char * parakeet_version(void) { return PARAKEET_VERSION; } GGML_ATTRIBUTE_FORMAT(2, 3) static void parakeet_log_internal(ggml_log_level level, const char * format, ...) { va_list args; va_start(args, format); char buffer[1024]; int len = vsnprintf(buffer, 1024, format, args); if (len < 1024) { g_state.log_callback(level, buffer, g_state.log_callback_user_data); } else { char* buffer2 = new char[len+1]; vsnprintf(buffer2, len+1, format, args); buffer2[len] = 0; g_state.log_callback(level, buffer2, g_state.log_callback_user_data); delete[] buffer2; } va_end(args); } static void parakeet_log_callback_default(ggml_log_level level, const char * text, void * user_data) { (void) level; (void) user_data; #ifndef PARAKEET_DEBUG if (level == GGML_LOG_LEVEL_DEBUG) { return; } #endif fputs(text, stderr); fflush(stderr); }