// Copyright 2024 Google LLC // SPDX-License-Identifier: Apache-2.0 // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Lightweight C++ implementation of the gemma model. // Compiles this file for multiple architectures via "foreach_target.h", to // which we pass the filename via macro 'argument'. #undef HWY_TARGET_INCLUDE #define HWY_TARGET_INCLUDE "gemma/gemma.cc" // NOLINT #include "hwy/foreach_target.h" // IWYU pragma: keep // Must come after foreach_target.h to avoid redefinition errors. #include "compression/compress-inl.h" #include "gemma/ops.h" #include "hwy/contrib/matvec/matvec-inl.h" #include "hwy/highway.h" // Non-SIMD includes and types. Note that HWY_ONCE is only true on the last // compile pass, whereas we want this defined in the first. #ifndef GEMMA_ONCE #define GEMMA_ONCE #include // sqrtf #include #include #include #include #include #include #include #include #include #include #include #include // NOLINT #include #include #include #include "compression/compress.h" #include "compression/io.h" // Path #include "gemma/configs.h" #include "gemma/gemma.h" #include "hwy/aligned_allocator.h" #include "hwy/base.h" #include "hwy/contrib/thread_pool/thread_pool.h" #include "hwy/profiler.h" #include "hwy/timer.h" // copybara:import_next_line:sentencepiece #include "src/sentencepiece_processor.h" // Setting this to true disables fread() calls that read the model file. constexpr bool kDryRunFread = false; // Setting this to false will load and use uncompressed weights. constexpr bool kWeightsAreCompressed = true; // Set this to true to debug tokenizer tokens. constexpr bool kShowTokenization = false; namespace gcpp { template struct Layer { Layer() = default; static constexpr size_t kHeads = TConfig::kHeads; static constexpr size_t kKVHeads = TConfig::kKVHeads; static constexpr size_t kModelDim = TConfig::kModelDim; static constexpr size_t kQKVDim = TConfig::kQKVDim; static constexpr size_t kFFHiddenDim = TConfig::kFFHiddenDim; static constexpr size_t kAttVecEinsumWSize = kHeads * kQKVDim * kModelDim; static constexpr size_t kQKVEinsumWSize = (kHeads + 2 * kKVHeads) * kQKVDim * kModelDim; // 2x for (gelu gating vector, gated vector) static constexpr size_t kGatingEinsumWSize = 2 * kFFHiddenDim * kModelDim; static constexpr size_t kConv1dWidth = TConfig::kConv1dWidth; static constexpr bool kFFBiases = TConfig::kFFBiases; static constexpr size_t kAOBiasDim = TConfig::kSoftmaxAttnOutputBiases ? kModelDim : 0; static constexpr size_t kGriffinDim = TConfig::kGriffinLayers > 0 ? kModelDim : 0; template using ArrayT = std::array; union { struct { ArrayT attn_vec_einsum_w; ArrayT qkv_einsum_w; ArrayT attention_output_biases; }; struct { ArrayT linear_x_w; ArrayT linear_x_biases; ArrayT linear_y_w; ArrayT linear_y_biases; ArrayT linear_out_w; ArrayT linear_out_biases; ArrayT conv_w; ArrayT conv_biases; ArrayT gate_w; ArrayT gate_biases; ArrayT a; } griffin; }; ArrayT gating_einsum_w; ArrayT linear_w; ArrayT pre_attention_norm_scale; ArrayT pre_ffw_norm_scale; ArrayT ffw_gating_biases; ArrayT ffw_output_biases; }; float ScaleWeights(float* data, size_t len) { float maxabs = 0.0; for (size_t i = 0; i < len; ++i) { maxabs = std::max(maxabs, std::abs(data[i])); } const float kMaxRange = 1.875f; if (maxabs <= kMaxRange) { return 1.0f; } const float scale = maxabs / kMaxRange; const float inv_scale = 1.0f / scale; for (size_t i = 0; i < len; ++i) { data[i] *= inv_scale; } return scale; } // Array instead of single large allocation for parallel mem init. Split out of // Weights so that only these pointers are initialized. template struct LayerPointers { explicit LayerPointers(hwy::ThreadPool& pool) { pool.Run(0, TConfig::kLayers, [this](uint64_t task, size_t /*thread*/) { this->layers[task] = hwy::AllocateAligned>(1); }); } using TLayer = Layer; std::array, TConfig::kLayers> layers; }; template struct Weights { // No ctor/dtor, allocated via AllocateAligned. std::array embedder_input_embedding; std::array final_norm_scale; LayerPointers layer_ptrs; std::array scales; const Layer* GetLayer(size_t layer) const { return layer_ptrs.layers[layer].get(); } Layer* GetLayer(size_t layer) { return layer_ptrs.layers[layer].get(); } }; template hwy::AlignedFreeUniquePtr LoadWeights( const Path& checkpoint, hwy::ThreadPool& pool, bool scale_for_compression = false) { PROFILER_ZONE("Startup.LoadWeights"); if (!checkpoint.Exists()) { HWY_ABORT("The model weights file '%s' does not exist.", checkpoint.path.c_str()); } using TWeights = Weights; hwy::AlignedFreeUniquePtr weights_u8 = hwy::AllocateAligned(sizeof(TWeights)); TWeights* weights = reinterpret_cast(weights_u8.get()); new (&weights->layer_ptrs) LayerPointers(pool); size_t scale_pos = 0; FILE* fptr; if constexpr (kDryRunFread) { fprintf(stderr, "Dry-Run, not reading model-file.\n"); } else { fptr = fopen(checkpoint.path.c_str(), "rb"); if (fptr == nullptr) { HWY_ABORT("Failed to open model file %s - does it exist?", checkpoint.path.c_str()); } } bool ok = true; uint64_t total_size = 0; auto do_fread = [&](void* var, int layer, const char* name, size_t size) { if (layer == -1) { fprintf(stderr, "Loading Parameters (size %zu): %s\n", size, name); } else { fprintf(stderr, "Loading Parameters (layer=%d, size %zu): %s\n", layer, size, name); } if constexpr (!kDryRunFread) { ok &= 1 == fread(var, size, 1, fptr); total_size += size; } }; do_fread(&(weights->embedder_input_embedding), -1, "embedder_input_embedding", sizeof(weights->embedder_input_embedding)); do_fread(&(weights->final_norm_scale), -1, "final_norm_scale", sizeof(weights->final_norm_scale)); for (size_t layer = 0; layer < TConfig::kLayers; ++layer) { auto type = TConfig::kLayerConfig[layer]; Layer* layer_view = weights->GetLayer(layer); #define READ_WEIGHTS(name) \ do { \ do_fread(&(layer_view->name), layer, #name, sizeof(layer_view->name)); \ } while (0) #define SCALE_WEIGHTS(name) \ do { \ if (ok && !kDryRunFread && scale_for_compression) { \ weights->scales[scale_pos++] = \ ScaleWeights(layer_view->name.data(), layer_view->name.size()); \ } \ } while (0) // Make sure we don't have uninitialized memory. hwy::ZeroBytes(layer_view, sizeof(*layer_view)); if (type == LayerAttentionType::kGemma) { READ_WEIGHTS(attn_vec_einsum_w); READ_WEIGHTS(qkv_einsum_w); SCALE_WEIGHTS(attn_vec_einsum_w); SCALE_WEIGHTS(qkv_einsum_w); } else { READ_WEIGHTS(griffin.linear_x_w); READ_WEIGHTS(griffin.linear_x_biases); READ_WEIGHTS(griffin.linear_y_w); READ_WEIGHTS(griffin.linear_y_biases); READ_WEIGHTS(griffin.linear_out_w); READ_WEIGHTS(griffin.linear_out_biases); READ_WEIGHTS(griffin.conv_w); READ_WEIGHTS(griffin.conv_biases); READ_WEIGHTS(griffin.gate_w); READ_WEIGHTS(griffin.gate_biases); READ_WEIGHTS(griffin.a); SCALE_WEIGHTS(griffin.linear_x_w); SCALE_WEIGHTS(griffin.linear_y_w); SCALE_WEIGHTS(griffin.linear_out_w); SCALE_WEIGHTS(griffin.gate_w); } READ_WEIGHTS(gating_einsum_w); READ_WEIGHTS(linear_w); SCALE_WEIGHTS(gating_einsum_w); SCALE_WEIGHTS(linear_w); READ_WEIGHTS(pre_attention_norm_scale); READ_WEIGHTS(pre_ffw_norm_scale); if (TConfig::kFFBiases) { READ_WEIGHTS(ffw_gating_biases); READ_WEIGHTS(ffw_output_biases); } if (TConfig::kSoftmaxAttnOutputBiases && type == LayerAttentionType::kGemma) { READ_WEIGHTS(attention_output_biases); } #undef READ_WEIGHTS } if (!ok) { HWY_ABORT( "Failed to read from %s - might be a directory, or too small? " "expected size: %d kB", checkpoint.path.c_str(), static_cast(total_size >> 10)); } if (!kDryRunFread) { HWY_ASSERT(0 == fclose(fptr)); if (scale_for_compression) { HWY_ASSERT(scale_pos == TConfig::kNumTensorScales); } } return weights_u8; } template struct CompressedLayer { // No ctor/dtor, allocated via AllocateAligned. using TLayer = gcpp::Layer; using WeightT = typename TConfig::WeightT; static constexpr size_t kHeads = TLayer::kHeads; static constexpr size_t kKVHeads = TLayer::kKVHeads; static constexpr size_t kModelDim = TLayer::kModelDim; static constexpr size_t kQKVDim = TLayer::kQKVDim; static constexpr size_t kFFHiddenDim = TLayer::kFFHiddenDim; static constexpr size_t kAttVecEinsumWSize = TLayer::kAttVecEinsumWSize; static constexpr size_t kQKVEinsumWSize = TLayer::kQKVEinsumWSize; static constexpr size_t kGatingEinsumWSize = TLayer::kGatingEinsumWSize; static constexpr size_t kConv1dWidth = TLayer::kConv1dWidth; static constexpr bool kFFBiases = TLayer::kFFBiases; static constexpr size_t kAOBiasDim = TLayer::kAOBiasDim; static constexpr size_t kGriffinDim = TLayer::kGriffinDim; // Compressed Parameters template using ArrayT = CompressedArray; union { struct { ArrayT attn_vec_einsum_w; ArrayT qkv_einsum_w; ArrayT attention_output_biases; }; struct { ArrayT linear_x_w; ArrayT linear_x_biases; ArrayT linear_y_w; ArrayT linear_y_biases; ArrayT linear_out_w; ArrayT linear_out_biases; ArrayT conv_w; ArrayT conv_biases; ArrayT gate_w; ArrayT gate_biases; ArrayT a; } griffin; }; ArrayT gating_einsum_w; ArrayT linear_w; // We don't yet have an RMSNorm that accepts all WeightT. ArrayT pre_attention_norm_scale; ArrayT pre_ffw_norm_scale; ArrayT ffw_gating_biases; ArrayT ffw_output_biases; }; // Array instead of single large allocation for parallel mem init. Split out // of CompressedWeights so that only these pointers are initialized, not the // CompressedArray. template struct CompressedLayerPointers { explicit CompressedLayerPointers(hwy::ThreadPool& pool) { pool.Run(0, TConfig::kLayers, [this](uint64_t task, size_t /*thread*/) { this->c_layers[task] = hwy::AllocateAligned>(1); }); } using CLayer = CompressedLayer; std::array, TConfig::kLayers> c_layers; }; template struct CompressedWeights { // No ctor/dtor, allocated via AllocateAligned. CompressedArray embedder_input_embedding; CompressedArray final_norm_scale; // Must be last so that the other arrays remain aligned. CompressedLayerPointers c_layer_ptrs; const CompressedLayer* GetLayer(size_t layer) const { return c_layer_ptrs.c_layers[layer].get(); } CompressedLayer* GetLayer(size_t layer) { return c_layer_ptrs.c_layers[layer].get(); } }; template using WeightsT = hwy::If, Weights>; // Aligned. template struct Activations { static constexpr size_t kBatchSize = TBatchSize; using LayerConfig = Layer; static constexpr size_t kModelDim = TConfig::kModelDim; static constexpr size_t kQKVDim = TConfig::kQKVDim; static constexpr size_t kHeads = TConfig::kHeads; static constexpr size_t kKVHeads = TConfig::kKVHeads; static constexpr size_t kCachePosSize = TConfig::kGemmaLayers * kKVHeads * kQKVDim; static constexpr size_t kCacheLayerSize = kKVHeads * kQKVDim; std::array x; // input std::array pre_att_rms_out; std::array q; // query vector std::array att; // attention vector std::array att_out; // attention output std::array att_post1; // attention output after linear transformation, per head std::array att_post2; // accumulation of attention outputs over heads std::array bf_pre_ffw_rms_out; std::array ffw_hidden; // bf_ version can't be used until GeluMulToBF16 issue in FFW() is resolved. // std::array // bf_ffw_hidden; std::array ffw_out; std::array logits; // Griffin layer internal activations static constexpr size_t kGriffinDim = TConfig::kGriffinLayers > 0 ? kModelDim : 0; std::array griffin_x; std::array griffin_y; std::array griffin_gate_x; std::array griffin_multiplier; }; // GemmaImpl is a template and thus cannot be exposed in gemma.h, hence we // define an abstract base class. struct GemmaInterface { virtual ~GemmaInterface() = default; virtual const GemmaTokenizer* Tokenizer() const = 0; virtual void Generate(size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) = 0; virtual float ComputeCrossEntropy(size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) = 0; }; template KVCache CreateKVCacheT() { constexpr size_t kConv1dWidth = Config::kConv1dWidth; return CreateKVCache( Config::kGemmaLayers * Config::kKVHeads * Config::kQKVDim, Config::kSeqLen, Config::kGriffinLayers * (kConv1dWidth == 0 ? 0 : kConv1dWidth - 1) * Config::kModelDim, Config::kGriffinLayers * Config::kModelDim); } KVCache CreateKVCache(Model type) { switch (type) { case Model::GEMMA_2B: return CreateKVCacheT(); case Model::GEMMA_7B: return CreateKVCacheT(); case Model::GRIFFIN_2B: return CreateKVCacheT(); default: HWY_ABORT("Model type %d unknown.", static_cast(type)); } } class GemmaTokenizerImpl : public GemmaTokenizer { public: GemmaTokenizerImpl( std::unique_ptr&& impl) : impl_(std::move(impl)) {} bool Encode(const std::string& input, std::vector* pieces) const override { return impl_->Encode(input, pieces).ok(); } bool Encode(const std::string& input, std::vector* pieces) const override { if constexpr (kShowTokenization) { bool is_ok = impl_->Encode(input, pieces).ok(); for (int i = 0; i < static_cast(pieces->size()); i++) { fprintf(stderr, "%3d: %d\n", i, (*pieces)[i]); } return is_ok; } else { return impl_->Encode(input, pieces).ok(); } } // Given a sequence of ids, decodes it into a detokenized output. bool Decode(const std::vector& ids, std::string* detokenized) const override { return impl_->Decode(ids, detokenized).ok(); } private: std::unique_ptr impl_; }; namespace { template void DeleteLayersPtrs(CompressedWeights* c_weights) { c_weights->c_layer_ptrs.~CompressedLayerPointers(); } template void DeleteLayersPtrs(Weights* weights) { weights->layer_ptrs.~LayerPointers(); } } // namespace template struct GemmaImpl : public GemmaInterface { GemmaImpl(std::unique_ptr& tokenizer, hwy::AlignedFreeUniquePtr& weights_u8, hwy::ThreadPool& pool); ~GemmaImpl() { WeightsT* weights = reinterpret_cast*>(weights_u8.get()); DeleteLayersPtrs(weights); } const GemmaTokenizer* Tokenizer() const override { return &tokenizer; } void Generate(size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937&, int verbosity, LayersOutputT* layers_output) override; float ComputeCrossEntropy(size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) override; GemmaTokenizerImpl tokenizer; hwy::AlignedFreeUniquePtr weights_u8; hwy::AlignedUniquePtr> prefill; hwy::AlignedUniquePtr> state; }; template std::string TokenString(GemmaImpl& gemma, int token) { std::string token_str; gemma.Tokenizer()->Decode({token}, &token_str); return "'" + std::regex_replace(token_str, std::regex("\n"), "\\n") + "'"; } } // namespace gcpp #endif // GEMMA_ONCE // SIMD code, compiled once per target. HWY_BEFORE_NAMESPACE(); namespace gcpp { namespace HWY_NAMESPACE { template HWY_NOINLINE void GriffinRecurrent( size_t batch_start, size_t batch_idx, size_t layer, Activations& activations, const LayerT* layer_weights, KVCache& kv_cache, hwy::ThreadPool& pool) { PROFILER_ZONE("Gen.Griffin"); namespace hn = hwy::HWY_NAMESPACE; using D = hn::ScalableTag; HWY_DASSERT(batch_idx < kBatchSize); static constexpr size_t kModelDim = gcpp::Activations::kModelDim; static constexpr size_t kConv1dWidth = TConfig::kConv1dWidth; static constexpr size_t kHeads = TConfig::kHeads; const size_t batch_offset = batch_idx * kModelDim; const size_t pos = batch_start + batch_idx; // X / Y linear layers. float* HWY_RESTRICT y = activations.griffin_y.data() + batch_offset; float* HWY_RESTRICT x = activations.griffin_x.data() + batch_offset; TwoMatVecAdd( layer_weights->griffin.linear_x_w, layer_weights->griffin.linear_y_w, 0, activations.pre_att_rms_out.data() + batch_offset, /*add0=*/layer_weights->griffin.linear_x_biases.data(), /*add1=*/layer_weights->griffin.linear_y_biases.data(), /*out0=*/x, /*out1=*/y, pool); Gelu(y, kModelDim); // Conv1D. { HWY_FULL(float) df; HWY_DASSERT(kModelDim % Lanes(df) == 0); const size_t layer_offset = layer * kModelDim * (kConv1dWidth - 1); // cache[i] = input at time t-i. float* HWY_RESTRICT cache[HWY_MAX(kConv1dWidth, 1)]; cache[0] = x; for (size_t i = 1; i < kConv1dWidth; i++) { cache[i] = kv_cache.conv1d_cache.get() + layer_offset + ((pos + kConv1dWidth - 1 - i) % (kConv1dWidth - 1)) * kModelDim; } for (size_t i = 0; i < kModelDim; i += Lanes(df)) { auto xv = hn::Load(df, x + i); auto accum0 = hn::Load(df, layer_weights->griffin.conv_biases.data() + i); auto accum1 = hn::Zero(df); static_assert(kConv1dWidth % 2 == 0, "Conv width must be even"); for (size_t l = 0; 2 * l < kConv1dWidth; l++) { auto wv0 = hn::Load(df, layer_weights->griffin.conv_w.data() + (kConv1dWidth - 1 - 2 * l) * kModelDim + i); auto wv1 = hn::Load(df, layer_weights->griffin.conv_w.data() + (kConv1dWidth - 2 - 2 * l) * kModelDim + i); accum0 = hn::MulAdd(wv0, hn::Load(df, cache[l * 2] + i), accum0); accum1 = hn::MulAdd(wv1, hn::Load(df, cache[l * 2 + 1] + i), accum1); } hn::Store(hn::Add(accum0, accum1), df, x + i); hn::Store(xv, df, cache[HWY_MAX(kConv1dWidth, 1) - 1] + i); } } // RGLRU float* HWY_RESTRICT gate_x = activations.griffin_gate_x.data() + batch_offset; float* HWY_RESTRICT a = activations.griffin_multiplier.data() + batch_offset; float* HWY_RESTRICT rnn_state = kv_cache.rglru_cache.get() + layer * kModelDim; pool.Run(0, kHeads, [&](const uint64_t head, size_t /*thread*/) HWY_ATTR { constexpr size_t kHeadDim = kModelDim / kHeads; constexpr size_t kMatrixSize = kHeadDim * kHeadDim; size_t head_offset = head * kHeadDim; TwoOfsMatVecAddLoop( layer_weights->griffin.gate_w, kMatrixSize * head, kMatrixSize * (kHeads + head), x + head_offset, /*add0=*/layer_weights->griffin.gate_biases.data() + head_offset, /*add1=*/layer_weights->griffin.gate_biases.data() + kModelDim + head_offset, /*out0=*/gate_x + head_offset, /*out1=*/a + head_offset); Sigmoid(gate_x + head_offset, kHeadDim); Sigmoid(a + head_offset, kHeadDim); const auto fn_mul = [](D d, hn::Vec x, hn::Vec gate_x) HWY_ATTR { return hn::Mul(x, gate_x); }; hn::Transform1(D(), a + head_offset, kHeadDim, layer_weights->griffin.a.data() + head_offset, fn_mul); hn::Transform1(D(), x + head_offset, kHeadDim, gate_x + head_offset, fn_mul); // RNN scan HWY_FULL(float) df; HWY_DASSERT(kHeadDim % Lanes(df) == 0); for (size_t i = 0; i < kHeadDim; i += Lanes(df)) { auto log_a = hn::Load(df, a + head_offset + i); auto gated_x = hn::Load(df, x + head_offset + i); auto rnn = hn::Load(df, rnn_state + head_offset + i); auto a = hn::Exp(df, log_a); auto x_multiplier = hn::Sqrt(hn::NegMulAdd(a, a, hn::Set(df, 1.0))); if (pos == 0) { x_multiplier = hn::Set(df, 1.0); } auto new_x = hn::MulAdd(x_multiplier, gated_x, hn::Mul(a, rnn)); hn::Store(new_x, df, rnn_state + head_offset + i); // Join branches. auto yv = hn::Load(df, y + head_offset + i); auto pre_out = hn::Mul(yv, new_x); hn::Store(pre_out, df, x + head_offset + i); } }); // Final linear layer. float* out_ptr = activations.att_post2.data() + batch_idx * kModelDim; MatVecAdd( layer_weights->griffin.linear_out_w, 0, x, layer_weights->griffin.linear_out_biases.data(), out_ptr, pool); } template HWY_NOINLINE void Attention(size_t batch_start, size_t batch_idx, size_t layer, Activations& activations, const LayerT* layer_weights, KVCache& kv_cache, hwy::ThreadPool& pool) { PROFILER_ZONE("Gen.Attention"); const size_t pos = batch_start + batch_idx; HWY_DASSERT(batch_idx < kBatchSize); static constexpr size_t kQKVDim = gcpp::Activations::kQKVDim; static constexpr size_t kCachePosSize = gcpp::Activations::kCachePosSize; static constexpr size_t kCacheLayerSize = gcpp::Activations::kCacheLayerSize; static constexpr size_t kModelDim = gcpp::Activations::kModelDim; static constexpr size_t kHeads = TConfig::kHeads; static constexpr size_t kKVHeads = TConfig::kKVHeads; static const float kQueryScale = static_cast(1.0 / sqrt(static_cast(kQKVDim))); size_t cache_pos = pos; size_t cache_num = pos + 1; if constexpr (TConfig::kUseLocalAttention) { cache_pos %= TConfig::kSeqLen; cache_num = std::min(cache_num, static_cast(TConfig::kSeqLen)); } float* x = activations.pre_att_rms_out.data() + batch_idx * kModelDim; auto ProjQ = [&](uint64_t head, size_t head_offset) HWY_ATTR { float* HWY_RESTRICT q = activations.q.data() + head * kQKVDim + batch_idx * kHeads * kQKVDim; MatVecLoop(layer_weights->qkv_einsum_w, head_offset + 0 * kQKVDim * kModelDim, x, q); }; auto ProjKV = [&](size_t k_offset, size_t v_offset, size_t kv_offset) HWY_ATTR { float* HWY_RESTRICT k = kv_cache.key_cache.get() + kv_offset; float* HWY_RESTRICT v = kv_cache.value_cache.get() + kv_offset; TwoOfsMatVecLoop(layer_weights->qkv_einsum_w, k_offset, v_offset, x, k, v); Rope(k, TConfig::kUseHalfRope ? kQKVDim / 2 : kQKVDim, pos); }; auto Attn = [&](uint64_t head, size_t head_offset) HWY_ATTR { // Calculate scores float* HWY_RESTRICT q = activations.q.data() + head * kQKVDim + batch_idx * kHeads * kQKVDim; float* HWY_RESTRICT head_att = activations.att.data() + head * TConfig::kSeqLen + batch_idx * kHeads * kQKVDim; Rope(q, TConfig::kUseHalfRope ? kQKVDim / 2 : kQKVDim, pos); MulByConst(kQueryScale, q, kQKVDim); // Compute Q dot K scores for (size_t pos2 = 0; pos2 < cache_num; ++pos2) { const size_t cache_offset = pos2 * kCachePosSize + layer * kCacheLayerSize + head_offset; const float* HWY_RESTRICT k2 = kv_cache.key_cache.get() + cache_offset; const float score = Dot(q, k2, kQKVDim); head_att[pos2] = score; } Softmax(head_att, cache_num); // Weighted summation float* HWY_RESTRICT att_out = activations.att_out.data() + head * kQKVDim + batch_idx * kHeads * kQKVDim; hwy::ZeroBytes(att_out, kQKVDim * sizeof(*att_out)); for (size_t pos2 = 0; pos2 < cache_num; ++pos2) { const size_t cache_offset = pos2 * kCachePosSize + layer * kCacheLayerSize + head_offset; float* HWY_RESTRICT v2 = kv_cache.value_cache.get() + cache_offset; MulByConstAndAdd(head_att[pos2], v2, att_out, kQKVDim); } // linear projection from kQKVDim back to kModelDim, sum projections // across heads float* HWY_RESTRICT head_out = head == 0 ? activations.att_post2.data() + batch_idx * kModelDim : activations.att_post1.data() + head * kBatchSize * kModelDim; if (head == 0) { MatVecAddLoop( layer_weights->attn_vec_einsum_w, head * kModelDim * kQKVDim, att_out, layer_weights->attention_output_biases.data(), head_out); } else { MatVecLoop(layer_weights->attn_vec_einsum_w, head * kModelDim * kQKVDim, att_out, head_out); } }; if constexpr (kHeads == kKVHeads) { // Multi-Head Attention pool.Run(0, kHeads, [&](const uint64_t head, size_t /*thread*/) HWY_ATTR { // linear projections to QKV const size_t head_offset = TConfig::kInterleaveQKV ? 3 * kQKVDim * kModelDim : kQKVDim * kModelDim; const size_t mat_offset = TConfig::kInterleaveQKV ? kQKVDim * kModelDim : kModelDim * kModelDim; const size_t q_offset = head * head_offset + 0 * mat_offset; const size_t k_offset = head * head_offset + 1 * mat_offset; const size_t v_offset = head * head_offset + 2 * mat_offset; ProjQ(head, q_offset); const size_t kv_offset = cache_pos * kCachePosSize + layer * kCacheLayerSize + head * kQKVDim; ProjKV(k_offset, v_offset, kv_offset); Attn(head, head * kQKVDim); }); } else { // Multi-Query Attention constexpr const size_t q_offset = kHeads * kQKVDim * kModelDim; constexpr const size_t k_offset = q_offset + 0 * kQKVDim * kModelDim; constexpr const size_t v_offset = q_offset + 1 * kQKVDim * kModelDim; const size_t kv_offset = cache_pos * kCachePosSize + layer * kCacheLayerSize; ProjKV(k_offset, v_offset, kv_offset); pool.Run(0, kHeads, [&](const uint64_t head, size_t /*thread*/) HWY_ATTR { ProjQ(head, head * kQKVDim * kModelDim); Attn(head, 0); }); } // accumulate output across all heads into att_post2. head 0 already wrote // directly to att_post2. for (size_t head = 1; head < kHeads; ++head) { AddFrom(activations.att_post1.data() + head * kBatchSize * kModelDim, activations.att_post2.data() + batch_idx * kModelDim, kModelDim); } } template HWY_NOINLINE void FFW(Activations& activations, size_t batch_idx, const LayerT* layer_weights, hwy::ThreadPool& pool) { HWY_DASSERT(batch_idx < kBatchSize); static constexpr size_t kModelDim = TConfig::kModelDim; static constexpr size_t kFFHiddenDim = TConfig::kFFHiddenDim; const size_t hidden_offset = batch_idx * kFFHiddenDim * 2; { PROFILER_ZONE("Gen.FFW.GatedGELU"); const hwy::bfloat16_t* HWY_RESTRICT vec = activations.bf_pre_ffw_rms_out.data() + batch_idx * kModelDim; float* HWY_RESTRICT out = activations.ffw_hidden.data() + hidden_offset; float* HWY_RESTRICT out_mul = out + kFFHiddenDim; // Same matrix, first and second half of rows. Could fuse into one MatVec, // but separating them could help on NUMA e.g. multiple sockets. MatVecAdd( layer_weights->gating_einsum_w, kFFHiddenDim * kModelDim, vec, layer_weights->ffw_gating_biases.data() + kFFHiddenDim, out_mul, pool); // Gate, will go through the nonlinearity. MatVecAdd( layer_weights->gating_einsum_w, 0, vec, layer_weights->ffw_gating_biases.data(), out, pool); namespace hn = hwy::HWY_NAMESPACE; using DF = hn::ScalableTag; using VF = hn::Vec; hn::Transform1(DF(), out, kFFHiddenDim, out_mul, [](DF df, VF v, VF mul) HWY_ATTR { return hn::Mul(mul, Gelu(df, v)); }); } PROFILER_ZONE("Gen.FFW\\GatedGELU"); MatVecAdd( layer_weights->linear_w, 0, activations.ffw_hidden.data() + hidden_offset, layer_weights->ffw_output_biases.data(), activations.ffw_out.data() + batch_idx * kModelDim, pool); } // `EmbeddingScaling` can be constexpr only if `Sqrt` and `hwy::ConvertScalarTo` // are both constexpr #if HWY_COMPILER_GCC_ACTUAL #define GEMMA_CONSTEXPR_EMBSCALING HWY_BF16_CONSTEXPR #else #define GEMMA_CONSTEXPR_EMBSCALING #endif template GEMMA_CONSTEXPR_EMBSCALING float EmbeddingScaling() { // Round to bf16 to match Gemma's Embedder, which casts before mul. return hwy::ConvertScalarTo(hwy::ConvertScalarTo( Sqrt(static_cast(TConfig::kModelDim)))); } template HWY_NOINLINE void Prefill(const int* tokens, size_t num_tokens, size_t pos, const WeightArrayT& weights, Activations& activations, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool) { PROFILER_ZONE("Gen.Prefill\\Att\\FFW"); static constexpr size_t kModelDim = TConfig::kModelDim; GEMMA_CONSTEXPR_EMBSCALING const float kEmbScaling = EmbeddingScaling(); pool.Run( 0, num_tokens, [&](const uint64_t token_idx, size_t /*thread*/) HWY_ATTR { const int token = tokens[token_idx]; Decompress(weights.embedder_input_embedding, token * kModelDim, activations.x.data() + token_idx * kModelDim, kModelDim); MulByConst(kEmbScaling, activations.x.data() + token_idx * kModelDim, kModelDim); }); for (size_t layer = 0; layer < TConfig::kLayers; ++layer) { auto type = TConfig::kLayerConfig[layer]; const auto* layer_weights = weights.GetLayer(layer); size_t layer_of_type = NumLayersOfTypeBefore(TConfig::kLayerConfig, type, layer); for (size_t token_idx = 0; token_idx < num_tokens; ++token_idx) { RMSNorm(activations.x.data() + token_idx * kModelDim, layer_weights->pre_attention_norm_scale.data(), activations.pre_att_rms_out.data() + token_idx * kModelDim, kModelDim); if (type == LayerAttentionType::kGemma) { Attention(pos, token_idx, layer_of_type, activations, layer_weights, kv_cache, pool); } else { GriffinRecurrent(pos, token_idx, layer_of_type, activations, layer_weights, kv_cache, pool); } } // TODO: sink the loop into these functions, i.e. make them MatMul. pool.Run( 0, num_tokens, [&](const uint64_t token_idx, size_t thread_id) HWY_ATTR { AddFrom(activations.att_post2.data() + token_idx * kModelDim, activations.x.data() + token_idx * kModelDim, kModelDim); RMSNorm(activations.x.data() + token_idx * kModelDim, layer_weights->pre_ffw_norm_scale.data(), activations.bf_pre_ffw_rms_out.data() + token_idx * kModelDim, kModelDim); FFW(activations, token_idx, layer_weights, inner_pool); AddFrom(activations.ffw_out.data() + token_idx * kModelDim, activations.x.data() + token_idx * kModelDim, kModelDim); }); } // foreach layer pool.Run( 0, num_tokens, [&](const uint64_t token_idx, size_t /*thread*/) HWY_ATTR { RMSNormInplace(weights.final_norm_scale.data(), activations.x.data() + token_idx * kModelDim, kModelDim); }); } // n = 1 specialization template void Transformer(int token, size_t pos, const WeightArrayT& weights, Activations& activations, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, LayersOutputT* layers_output) { if (layers_output != nullptr) { float token_f = token; (*layers_output)(pos, "Tokens", &token_f, 1); } static constexpr size_t kModelDim = TConfig::kModelDim; Decompress(weights.embedder_input_embedding, token * kModelDim, activations.x.data(), kModelDim); GEMMA_CONSTEXPR_EMBSCALING const float kEmbScaling = EmbeddingScaling(); MulByConst(kEmbScaling, activations.x.data(), kModelDim); for (size_t layer = 0; layer < TConfig::kLayers; ++layer) { auto type = TConfig::kLayerConfig[layer]; const auto* layer_weights = weights.GetLayer(layer); size_t layer_of_type = NumLayersOfTypeBefore(TConfig::kLayerConfig, type, layer); RMSNorm(activations.x.data(), layer_weights->pre_attention_norm_scale.data(), activations.pre_att_rms_out.data(), kModelDim); if (type == LayerAttentionType::kGemma) { Attention<1>(pos, 0, layer_of_type, activations, layer_weights, kv_cache, pool); } else { GriffinRecurrent<1>(pos, 0, layer_of_type, activations, layer_weights, kv_cache, pool); } AddFrom(activations.att_post2.data(), activations.x.data(), kModelDim); RMSNorm(activations.x.data(), layer_weights->pre_ffw_norm_scale.data(), activations.bf_pre_ffw_rms_out.data(), kModelDim); FFW<1>(activations, /* batch_idx = */ 0, layer_weights, pool); AddFrom(activations.ffw_out.data(), activations.x.data(), kModelDim); if (layers_output != nullptr) { std::string block_name = "blocks." + std::to_string(layer); (*layers_output)(pos, block_name, activations.x.data(), kModelDim); } } RMSNormInplace(weights.final_norm_scale.data(), activations.x.data(), kModelDim); if (layers_output != nullptr) { (*layers_output)(pos, "final_norm", activations.x.data(), kModelDim); } } template void RangeChecks(size_t& max_tokens, size_t& max_generated_tokens, size_t& prompt_size) { if (!TConfig::kUseLocalAttention) { if (max_tokens > TConfig::kSeqLen) { fprintf(stderr, "WARNING: max_tokens %zu > kSeqLen %d, truncating.\n", max_tokens, TConfig::kSeqLen); max_tokens = static_cast(TConfig::kSeqLen); } } if (max_generated_tokens > max_tokens) { fprintf(stderr, "WARNING: max_generated_tokens %zu > max_tokens %zu, truncating.\n", max_generated_tokens, max_tokens); max_generated_tokens = max_tokens - 1; } if (!TConfig::kUseLocalAttention) { if (prompt_size + max_generated_tokens > max_tokens) { fprintf(stderr, "WARNING: prompt_size %zu + max_generated_tokens %zu > kSeqLen " "%d, truncating.\n", prompt_size, max_generated_tokens, TConfig::kSeqLen); prompt_size = max_tokens - max_generated_tokens; } } } template void GenerateImpl(GemmaImpl& gemma, size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { static constexpr size_t kVocabSize = TConfig::kVocabSize; Activations& activations = *gemma.state.get(); Activations& prefill_activations = *gemma.prefill.get(); const WeightsT& weights = *reinterpret_cast*>(gemma.weights_u8.get()); size_t prompt_size = prompt.size(); RangeChecks(max_tokens, max_generated_tokens, prompt_size); if (pos >= max_tokens) { fprintf(stderr, "Warning: pos %zu >= max_tokens %zu, aborting.\n", pos, max_tokens); return; } // pos indexes the KV cache. In the first turn of a chat, pos = 0. // // After the first turn, pos gets passed in with > 0 corresponding to the // current token position in the KV cache. // // pos_offset keeps track of the relative position within the turn, starting // at 0 each turn. During prefill, pos_offset corresponds to the index into // the prompt vector. // // In single-turn (non-chat) usage, pos and pos_offset start at 0 and are // always equal. size_t pos_offset = 0; // offset relative to pos const double prefill_start = hwy::platform::Now(); // Prefill stops before prompt_size - 1 since the last prompt token is the // first input token for generation. while (pos_offset < prompt_size - 1) { const size_t batch_size = std::min(kPrefillBatchSize, prompt_size - 1 - pos_offset); HWY_DASSERT(batch_size <= kPrefillBatchSize); HWY_DASSERT(pos_offset + batch_size <= prompt_size - 1); const int* batch_tokens = prompt.data() + pos_offset; Prefill(batch_tokens, batch_size, pos, weights, prefill_activations, kv_cache, pool, inner_pool); for (size_t idx = 0; idx < batch_size; ++idx) { stream_token(batch_tokens[idx], 0.0f); } pos += batch_size; pos_offset += batch_size; } if (verbosity >= 2) { // in the future this output should not occur in GenerateImpl but instead // should be available as observable state for frontend code to handle I/O. const double prefill_end = hwy::platform::Now(); const double prefill_tok_sec = static_cast(pos_offset) / (prefill_end - prefill_start); std::cout << "\n[ Prefill tokens / sec = " << prefill_tok_sec << " ]"; } const double gen_start = hwy::platform::Now(); HWY_DASSERT(pos_offset == prompt_size - 1); size_t pos_gen_start = pos_offset; int token = prompt.at(pos_offset); stream_token(token, 0); for (size_t generate_pos = 0; pos < max_tokens && generate_pos < max_generated_tokens; ++pos, ++pos_offset, ++generate_pos) { const bool is_generating_phase = pos_offset >= prompt_size - 1; Transformer(token, pos, weights, activations, kv_cache, pool, inner_pool, layers_output); float* final_activation = activations.x.data(); // The condition below is always true if we are doing Prefill above. // We keep it here for clarity so that the code is correct even if Prefill // is disabled. if (is_generating_phase) { PROFILER_ZONE("Gen.Embedding"); // Generation phase MatVec(weights.embedder_input_embedding, 0, final_activation, activations.logits.data(), pool); // Barrier: must have all logits so we can subtract max. Softmax(activations.logits.data(), kVocabSize); token = SampleTopK(activations.logits.data(), kVocabSize, gen, temperature, accept_token); if (!stream_token(token, activations.logits[token])) { token = EOS_ID; } } else { // We would take this branch if we were not doing Prefill but would // process the tokens of the prompt one at a time. token = prompt.at(pos_offset + 1); stream_token(token, 0); } if (token == EOS_ID) { if (verbosity >= 2) { const double gen_end = hwy::platform::Now(); const double gen_tok_sec = static_cast(pos_offset - pos_gen_start) / (gen_end - gen_start); std::cout << "\n[ Generation tokens / sec = " << gen_tok_sec << " ]\n"; } break; } } } #define TOKEN(token_id) TokenString(gemma, token_id).c_str() template void LogTopK(GemmaImpl& gemma, float* logits, float* dist, size_t len, size_t k) { std::vector> sorted(len); for (int i = 0; i < len; ++i) { sorted[i] = std::make_pair(dist[i], i); } std::sort(sorted.begin(), sorted.end(), [](const std::pair& a, const std::pair& b) { if (a.first != b.first) { return a.first > b.first; } return a.second < b.second; }); for (int i = 0; i < k; ++i) { printf(" [#%-2d token %6d = %-12s %.2e %f]\n", i + 1, sorted[i].second, TOKEN(sorted[i].second), sorted[i].first, logits[sorted[i].second]); } } template float ComputeCrossEntropyImpl(GemmaImpl& gemma, size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { static constexpr size_t kModelDim = TConfig::kModelDim; static constexpr size_t kVocabSize = TConfig::kVocabSize; Activations& activations = *gemma.state.get(); const WeightsT& weights = *reinterpret_cast*>(gemma.weights_u8.get()); std::vector logits(kVocabSize); Softmax(activations.logits.data(), kVocabSize); float total_entropy = 0.0f; for (size_t pos = 0; pos < max_tokens && pos < prompt.size(); ++pos) { if (verbosity >= 4) { LogTopK(gemma, logits.data(), activations.logits.data(), kVocabSize, 10); } const int token = prompt[pos]; const float prob = activations.logits[token]; if (verbosity >= 3) { printf("pos %4zu token %6d = %-12s %.10e %14.10f bits\n", pos, token, TOKEN(token), prob, -std::log(prob) / std::log(2.0)); } total_entropy -= std::max(std::log(prob), -64.0f); if (verbosity >= 2 && pos % 100 == 99) { printf("Processed %zu tokens, cross-entropy per token: %f\n", pos + 1, total_entropy / std::log(2.0) / (pos + 1)); } Transformer(token, pos, weights, activations, kv_cache, pool, inner_pool, /*layers_output=*/nullptr); MatVec(weights.embedder_input_embedding, 0, activations.x.data(), activations.logits.data(), pool); LogitsSoftCap(30.0f, activations.logits.data(), kVocabSize); memcpy(logits.data(), activations.logits.data(), kVocabSize * sizeof(logits[0])); Softmax(activations.logits.data(), kVocabSize); } return total_entropy / std::log(2.0); } #undef TOKEN void Generate2B(GemmaImpl& gemma, size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { GenerateImpl(gemma, max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); } void Generate7B(GemmaImpl& gemma, size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { GenerateImpl(gemma, max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); } void GenerateGriffin2B(GemmaImpl& gemma, size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { GenerateImpl(gemma, max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); } float ComputeCrossEntropy2B(GemmaImpl& gemma, size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { return ComputeCrossEntropyImpl(gemma, max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); } float ComputeCrossEntropy7B(GemmaImpl& gemma, size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { return ComputeCrossEntropyImpl(gemma, max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); } float ComputeCrossEntropyGriffin2B(GemmaImpl& gemma, size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { return ComputeCrossEntropyImpl(gemma, max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); } // Calls func(name, float*, CompressedArray&) for each tensor. float* is null // if weights = null, which happens during the first call where we attempt to // load from cache. // // This avoids repeating the list of tensors between loading and compressing. template void ForEachTensor(const Weights* weights, CompressedWeights& c_weights, Func& func) { func("c_embedding", weights ? weights->embedder_input_embedding.data() : nullptr, c_weights.embedder_input_embedding); func("c_final_norm", weights ? weights->final_norm_scale.data() : nullptr, c_weights.final_norm_scale); char name_buf[16]; for (int layer_idx = 0; layer_idx < TConfig::kLayers; ++layer_idx) { auto type = TConfig::kLayerConfig[layer_idx]; const size_t idx = static_cast(layer_idx); const Layer* layer = weights ? weights->GetLayer(idx) : nullptr; CompressedLayer* layer_weights = c_weights.GetLayer(idx); #define CALL_FUNC(name, member) \ snprintf(name_buf, sizeof(name_buf), name "_%d", layer_idx); \ func(name_buf, layer ? layer->member.data() : nullptr, layer_weights->member) CALL_FUNC("pre_ff_ns", pre_ffw_norm_scale); CALL_FUNC("gating_ein", gating_einsum_w); CALL_FUNC("linear_w", linear_w); if (type == LayerAttentionType::kGemma) { CALL_FUNC("qkv_ein", qkv_einsum_w); CALL_FUNC("att_ein", attn_vec_einsum_w); } else { CALL_FUNC("gr_lin_x_w", griffin.linear_x_w); CALL_FUNC("gr_lin_x_b", griffin.linear_x_biases); CALL_FUNC("gr_lin_y_w", griffin.linear_y_w); CALL_FUNC("gr_lin_y_b", griffin.linear_y_biases); CALL_FUNC("gr_lin_out_w", griffin.linear_out_w); CALL_FUNC("gr_lin_out_b", griffin.linear_out_biases); CALL_FUNC("gr_conv_w", griffin.conv_w); CALL_FUNC("gr_conv_b", griffin.conv_biases); CALL_FUNC("gr_gate_w", griffin.gate_w); CALL_FUNC("gr_gate_b", griffin.gate_biases); CALL_FUNC("gr_a", griffin.a); } CALL_FUNC("pre_att_ns", pre_attention_norm_scale); if (TConfig::kFFBiases) { CALL_FUNC("ffw_gat_b", ffw_gating_biases); CALL_FUNC("ffw_out_b", ffw_output_biases); } if (TConfig::kSoftmaxAttnOutputBiases && type == LayerAttentionType::kGemma) { CALL_FUNC("attn_ob", attention_output_biases); } #undef CALL_FUNC } } template hwy::AlignedFreeUniquePtr LoadCompressedWeights( const Path& weights, hwy::ThreadPool& pool) { PROFILER_ZONE("Startup.LoadCompressedWeights"); if (!weights.Exists()) { HWY_ABORT("The model weights file '%s' does not exist.", weights.path.c_str()); } // Allocate compressed weights. using CWeights = CompressedWeights; hwy::AlignedFreeUniquePtr c_weights_u8 = hwy::AllocateAligned(sizeof(CWeights)); CWeights* c_weights = reinterpret_cast(c_weights_u8.get()); new (&c_weights->c_layer_ptrs) CompressedLayerPointers(pool); std::array scales; CacheLoader loader(weights); ForEachTensor(nullptr, *c_weights, loader); loader.LoadScales(scales.data(), scales.size()); if (!loader.ReadAll(pool)) { HWY_ABORT("Failed to load model weights."); } if (TConfig::kNumTensorScales > 0) { size_t scale_pos = 0; for (int layer_idx = 0; layer_idx < TConfig::kLayers; ++layer_idx) { auto type = TConfig::kLayerConfig[layer_idx]; const size_t idx = static_cast(layer_idx); CompressedLayer* layer_weights = c_weights->GetLayer(idx); if (type == LayerAttentionType::kGemma) { layer_weights->attn_vec_einsum_w.set_scale(scales[scale_pos++]); layer_weights->qkv_einsum_w.set_scale(scales[scale_pos++]); } else { layer_weights->griffin.linear_x_w.set_scale(scales[scale_pos++]); layer_weights->griffin.linear_y_w.set_scale(scales[scale_pos++]); layer_weights->griffin.linear_out_w.set_scale(scales[scale_pos++]); layer_weights->griffin.gate_w.set_scale(scales[scale_pos++]); } layer_weights->gating_einsum_w.set_scale(scales[scale_pos++]); layer_weights->linear_w.set_scale(scales[scale_pos++]); } HWY_ASSERT(scale_pos == TConfig::kNumTensorScales); } return c_weights_u8; } // Type-erased because this function is called via a function pointer. hwy::AlignedFreeUniquePtr LoadCompressedWeightsT( gcpp::Model model, const Path& weights, hwy::ThreadPool& pool) { switch (model) { case Model::GEMMA_2B: return LoadCompressedWeights(weights, pool); case Model::GEMMA_7B: return LoadCompressedWeights(weights, pool); case Model::GRIFFIN_2B: return LoadCompressedWeights(weights, pool); default: HWY_ABORT("Model type %d unknown.", static_cast(model)); } } hwy::AlignedFreeUniquePtr LoadWeightsT(gcpp::Model model, const Path& weights, hwy::ThreadPool& pool) { switch (model) { case Model::GEMMA_2B: return LoadWeights(weights, pool); case Model::GEMMA_7B: return LoadWeights(weights, pool); case Model::GRIFFIN_2B: return LoadWeights(weights, pool); default: HWY_ABORT("Model type %d unknown.", static_cast(model)); } } template void CompressWeights(const Path& weights_path, const Path& compressed_weights_path, hwy::ThreadPool& pool) { if (!weights_path.Exists()) { HWY_ABORT("The model weights file '%s' does not exist.", weights_path.path.c_str()); } // Allocate compressed weights. using CWeights = CompressedWeights; hwy::AlignedFreeUniquePtr c_weights_u8 = hwy::AllocateAligned(sizeof(CWeights)); CWeights* c_weights = reinterpret_cast(c_weights_u8.get()); new (&c_weights->c_layer_ptrs) CompressedLayerPointers(pool); // Get weights, compress, and store. const bool scale_for_compression = TConfig::kNumTensorScales > 0; const hwy::AlignedFreeUniquePtr weights_u8 = LoadWeights(weights_path, pool, scale_for_compression); Weights* weights = reinterpret_cast*>(weights_u8.get()); Compressor compressor(pool); ForEachTensor(weights, *c_weights, compressor); compressor.AddScales(weights->scales.data(), weights->scales.size()); compressor.WriteAll(pool, compressed_weights_path); weights->layer_ptrs.~LayerPointers(); c_weights->c_layer_ptrs.~CompressedLayerPointers(); } void CompressWeightsT(gcpp::Model model, const Path& weights, const Path& compressed_weights, hwy::ThreadPool& pool) { switch (model) { case Model::GEMMA_2B: CompressWeights(weights, compressed_weights, pool); break; case Model::GEMMA_7B: CompressWeights(weights, compressed_weights, pool); break; case Model::GRIFFIN_2B: CompressWeights(weights, compressed_weights, pool); break; default: HWY_ABORT("Model type %d unknown.", static_cast(model)); } } } // namespace HWY_NAMESPACE } // namespace gcpp HWY_AFTER_NAMESPACE(); #if HWY_ONCE namespace gcpp { HWY_EXPORT(LoadCompressedWeightsT); HWY_EXPORT(LoadWeightsT); HWY_EXPORT(CompressWeightsT); HWY_EXPORT(Generate2B); HWY_EXPORT(Generate7B); HWY_EXPORT(GenerateGriffin2B); HWY_EXPORT(ComputeCrossEntropy2B); HWY_EXPORT(ComputeCrossEntropy7B); HWY_EXPORT(ComputeCrossEntropyGriffin2B); KVCache CreateKVCache(size_t size_cache_pos, size_t seq_len, size_t conv1d_cache_size, size_t rglru_cache_size) { KVCache kv_cache = {}; if (size_cache_pos != 0) { kv_cache.key_cache = hwy::AllocateAligned(seq_len * size_cache_pos); kv_cache.value_cache = hwy::AllocateAligned(seq_len * size_cache_pos); } if (conv1d_cache_size != 0) { kv_cache.conv1d_cache = hwy::AllocateAligned(conv1d_cache_size); hwy::ZeroBytes(kv_cache.conv1d_cache.get(), conv1d_cache_size * sizeof(kv_cache.conv1d_cache[0])); } if (rglru_cache_size != 0) { kv_cache.rglru_cache = hwy::AllocateAligned(rglru_cache_size); hwy::ZeroBytes(kv_cache.rglru_cache.get(), rglru_cache_size * sizeof(kv_cache.rglru_cache[0])); } return kv_cache; } template GemmaImpl::GemmaImpl( std::unique_ptr& tokenizer, hwy::AlignedFreeUniquePtr& weights_u8, hwy::ThreadPool& pool) : tokenizer(GemmaTokenizerImpl(std::move(tokenizer))), weights_u8(std::move(weights_u8)), prefill(hwy::MakeUniqueAligned>()), state(hwy::MakeUniqueAligned>()) {} template <> void GemmaImpl::Generate( size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { HWY_DYNAMIC_DISPATCH(Generate2B) (*this, max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); } template <> void GemmaImpl::Generate( size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { HWY_DYNAMIC_DISPATCH(Generate7B) (*this, max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); } template <> void GemmaImpl::Generate( size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { HWY_DYNAMIC_DISPATCH(GenerateGriffin2B) (*this, max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); } template <> float GemmaImpl::ComputeCrossEntropy( size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { return HWY_DYNAMIC_DISPATCH(ComputeCrossEntropy2B)( *this, max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); } template <> float GemmaImpl::ComputeCrossEntropy( size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { return HWY_DYNAMIC_DISPATCH(ComputeCrossEntropy7B)( *this, max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); } template <> float GemmaImpl::ComputeCrossEntropy( size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { return HWY_DYNAMIC_DISPATCH(ComputeCrossEntropyGriffin2B)( *this, max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); } Gemma::Gemma(const Path& tokenizer_path, const Path& weights, Model model_type, hwy::ThreadPool& pool) { std::unique_ptr tokenizer; { PROFILER_ZONE("Startup.tokenizer"); tokenizer = std::make_unique(); if (!tokenizer->Load(tokenizer_path.path).ok()) { HWY_ABORT("Failed to load the tokenizer file."); } } hwy::AlignedFreeUniquePtr weights_u8; if constexpr (kWeightsAreCompressed) { weights_u8 = HWY_DYNAMIC_DISPATCH(LoadCompressedWeightsT)(model_type, weights, pool); } else { weights_u8 = HWY_DYNAMIC_DISPATCH(LoadWeightsT)(model_type, weights, pool); } switch (model_type) { case Model::GEMMA_2B: impl_.reset(new GemmaImpl(tokenizer, weights_u8, pool)); break; case Model::GEMMA_7B: impl_.reset(new GemmaImpl(tokenizer, weights_u8, pool)); break; case Model::GRIFFIN_2B: impl_.reset(new GemmaImpl(tokenizer, weights_u8, pool)); break; default: HWY_ABORT("Model type %d unknown.", static_cast(model_type)); } } Gemma::~Gemma() = default; // after GemmaInterface is defined const GemmaTokenizer* Gemma::Tokenizer() const { return impl_->Tokenizer(); } void GenerateGemma(Gemma& gemma, size_t max_tokens, size_t max_generated_tokens, float temperature, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, const StreamFunc& stream_token, const AcceptFunc& accept_token, std::mt19937& gen, int verbosity, LayersOutputT* layers_output) { pool.SetWaitMode(hwy::PoolWaitMode::kSpin); gemma.impl_->Generate(max_tokens, max_generated_tokens, temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, accept_token, gen, verbosity, layers_output); pool.SetWaitMode(hwy::PoolWaitMode::kBlock); } void GenerateGemma(Gemma& gemma, RuntimeConfig runtime_config, const std::vector& prompt, size_t start_pos, KVCache& kv_cache, hwy::ThreadPool& pool, const StreamFunc& stream_token, std::mt19937& gen) { hwy::ThreadPool inner_pool(0); GenerateGemma( gemma, runtime_config.max_tokens, runtime_config.max_generated_tokens, runtime_config.temperature, prompt, start_pos, kv_cache, pool, inner_pool, stream_token, [](int) { return true; }, gen, runtime_config.verbosity, /*layers_output=*/nullptr); } void CompressWeights(gcpp::Model model, const Path& weights, const Path& compressed_weights, hwy::ThreadPool& pool) { HWY_DYNAMIC_DISPATCH(CompressWeightsT) (model, weights, compressed_weights, pool); } float ComputeCrossEntropy(Gemma& gemma, size_t max_tokens, const std::vector& prompt, KVCache& kv_cache, hwy::ThreadPool& pool, hwy::ThreadPool& inner_pool, int verbosity) { pool.SetWaitMode(hwy::PoolWaitMode::kSpin); const float result = gemma.impl_->ComputeCrossEntropy( max_tokens, prompt, kv_cache, pool, inner_pool, verbosity); pool.SetWaitMode(hwy::PoolWaitMode::kBlock); return result; } namespace { constexpr const char* kModelFlags[] = {"2b-pt", "7b-pt", "gr2b-pt", "2b-it", "7b-it", "gr2b-it"}; constexpr Model kModelTypes[] = {Model::GEMMA_2B, Model::GEMMA_7B, Model::GRIFFIN_2B, Model::GEMMA_2B, Model::GEMMA_7B, Model::GRIFFIN_2B}; constexpr ModelTraining kModelTraining[] = { ModelTraining::GEMMA_PT, ModelTraining::GEMMA_PT, ModelTraining::GEMMA_PT, ModelTraining::GEMMA_IT, ModelTraining::GEMMA_IT, ModelTraining::GEMMA_IT}; } // namespace const char* ParseModelTypeAndTraining(const std::string& model_flag, Model& model, ModelTraining& training) { constexpr size_t kNum = std::end(kModelFlags) - std::begin(kModelFlags); static char kErrorMessageBuffer[kNum * 8 + 1024] = "Invalid or missing model flag, need to specify one of "; for (size_t i = 0; i + 1 < kNum; i++) { strcat(kErrorMessageBuffer, kModelFlags[i]); // NOLINT strcat(kErrorMessageBuffer, ", "); // NOLINT } strcat(kErrorMessageBuffer, kModelFlags[kNum - 1]); // NOLINT strcat(kErrorMessageBuffer, "."); // NOLINT std::string model_type_lc = model_flag; std::transform(begin(model_type_lc), end(model_type_lc), begin(model_type_lc), [](unsigned char c) { return std::tolower(c); }); for (size_t i = 0; i < kNum; i++) { if (kModelFlags[i] == model_type_lc) { model = kModelTypes[i]; training = kModelTraining[i]; return nullptr; } } return kErrorMessageBuffer; } } // namespace gcpp #endif // HWY_ONCE