Darkspyre.Inference.Tensor.Embedding.Gemma
11.20.0
Prefix Reserved
dotnet add package Darkspyre.Inference.Tensor.Embedding.Gemma --version 11.20.0
NuGet\Install-Package Darkspyre.Inference.Tensor.Embedding.Gemma -Version 11.20.0
<PackageReference Include="Darkspyre.Inference.Tensor.Embedding.Gemma" Version="11.20.0" />
<PackageVersion Include="Darkspyre.Inference.Tensor.Embedding.Gemma" Version="11.20.0" />
<PackageReference Include="Darkspyre.Inference.Tensor.Embedding.Gemma" />
paket add Darkspyre.Inference.Tensor.Embedding.Gemma --version 11.20.0
#r "nuget: Darkspyre.Inference.Tensor.Embedding.Gemma, 11.20.0"
#:package Darkspyre.Inference.Tensor.Embedding.Gemma@11.20.0
#addin nuget:?package=Darkspyre.Inference.Tensor.Embedding.Gemma&version=11.20.0
#tool nuget:?package=Darkspyre.Inference.Tensor.Embedding.Gemma&version=11.20.0
Darkspyre.Inference.Tensor.Embedding.Gemma
Text and image embeddings with EmbeddingGemma 2 inside the application's process, through ONNX Runtime on WebGPU or
CPU. The engine implements Common's IEmbeddingInference and returns 768-dimensional unit-length vectors.
Install
dotnet add package Darkspyre.Inference.Tensor.Embedding.Gemma --prerelease
Register
Construct GemmaEmbeddingInference over a TensorModelPackManager, or call AddTensorEngines() from
Darkspyre.Inference.Tensor.Registry, which registers GemmaEmbeddingEngineProvider.
GemmaEmbeddingModels.EmbeddingGemma2 is the built-in pack definition.
Example
Install the selected pack through TensorModelPackManager.InstallAsync when the person chooses to acquire it. The
following load assumes GemmaEmbeddingModels.EmbeddingGemma2 is installed in packDirectory.
TensorModelPackDefinition gemma = GemmaEmbeddingModels.EmbeddingGemma2;
using var packs = new TensorModelPackManager(new TensorModelCatalog([gemma]), packDirectory);
await using var embeddings = new GemmaEmbeddingInference(packs);
await embeddings.StartAsync();
await embeddings.LoadAsync(gemma.Key); // Accepts loading, not completion.
Subscribe to EngineStatusChanged before loading. After it reports Loaded, make requests; handle Failed instead of
sending a request after a failed load. Awaiting LoadAsync alone does not wait for Loaded.
EmbeddingResult result = await embeddings.EmbedAsync(new EmbeddingRequest
{
ModelId = gemma.Key.ModelId,
Inputs = [new TextEmbeddingInput("The meeting moved to Thursday.", Title: "Calendar")]
});
A MediaEmbeddingInput carries PNG or JPEG bytes the caller owns until the call completes.
Settings
GemmaEmbeddingSetup.CreateSettingsManager opens the engine's settings: the model with its install state, "Runs on",
and the download, check, load and backend-check actions.
Limits
- Automatic backend selection uses WebGPU. CPU is an explicit choice; a missing GPU is reported as
BackendUnavailable, with no silent CPU fallback. - The input limit is 8,192 tokens, formatting included. Truncation is explicit and reports the inputs it cut.
- A query request runs before waiting document requests.
- Vectors with different
ModelFingerprintvalues are not comparable.
The Darkspyre.Inference packages
This package is one library of the Darkspyre.Inference family. The family runs AI inference from .NET applications through typed, provider-neutral contracts.
Darkspyre.Inference.Commonholds the contracts every other package shares: requests, results, capabilities, failures and the provider setup model.Darkspyre.Inference.Connect.Commonholds the conversation and embedding services. Each Connect provider package adds one provider, andAddLlmConnect()discovers every provider package the application references.- The Tensor packages load and run models inside the application's own process.
- The UI.Settings packages provide the setup editors a host places in its own window or page.
Every package of the family carries the same version. Reference all of them at the same version: each package depends on the exact version of the family packages it uses.
The packages are licensed under the MIT license. LICENSE.md in each package holds the license text.
| Package | Holds |
|---|---|
| Darkspyre.Inference.Common | Shared contracts for Connect and Tensor |
| Darkspyre.Inference.Connect | Image, speech and audio connectors |
| Darkspyre.Inference.Connect.Common | Conversation and embedding services and provider discovery |
| Darkspyre.Inference.Connect.Codex | Conversations on a ChatGPT subscription |
| Darkspyre.Inference.Connect.Claude | Conversations on a Claude subscription through the Claude CLI |
| Darkspyre.Inference.Connect.HostTools | The host-tools local service and its client |
| Darkspyre.Inference.Connect.Antigravity | Conversations on a Google subscription through the Antigravity CLI |
| Darkspyre.Inference.Connect.Grok | Conversations on a Grok subscription |
| Darkspyre.Inference.Connect.Anthropic | Conversations through the Anthropic API with an API key, with hosted web search |
| Darkspyre.Inference.Connect.OpenAiApi | Conversations and embeddings through the OpenAI API |
| Darkspyre.Inference.Connect.SelfHost | Conversations and embeddings on engines the application runs |
| Darkspyre.Inference.Tensor.Common | Model packs, the model lifecycle and the Tensor capability interfaces |
| Darkspyre.Inference.Tensor.Decision.Laya | Laya typed decisions through ONNX Runtime |
| Darkspyre.Inference.Tensor.Embedding | Text embeddings from GGUF sentence encoders |
| Darkspyre.Inference.Tensor.Embedding.Gemma | EmbeddingGemma text and image embeddings |
| Darkspyre.Inference.Tensor.Ggml | The process's GGML and MLX native runtime |
| Darkspyre.Inference.Tensor.Image.Supra | Supra2-IMG image generation |
| Darkspyre.Inference.Tensor.LLM.Qwen | Qwen GGUF text generation |
| Darkspyre.Inference.Tensor.Registry | Registration and discovery of the Tensor engines |
| Darkspyre.Inference.Tensor.STT.Whisper | Whisper speech transcription |
| Darkspyre.Inference.UI.Settings.Core | Editor state and host contracts both setup editors share |
| Darkspyre.Inference.UI.Settings.Avalonia | The Avalonia setup editor |
| Darkspyre.Inference.UI.Settings.Blazor | The Blazor setup editor |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
-
net11.0
- Darkspyre.Inference.Tensor.Common (= 11.20.0)
- Microsoft.ML.OnnxRuntime (>= 1.30.0)
- Microsoft.ML.OnnxRuntime.EP.WebGpu (>= 0.4.0)
- StbImageSharp (>= 2.30.15)
- TensorSharp.Runtime (>= 2026.10.11)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Darkspyre.Inference.Tensor.Embedding.Gemma:
| Package | Downloads |
|---|---|
|
Darkspyre.Inference.Tensor.Registry
Registration, validation and ordered discovery of the Darkspyre Tensor engine implementations. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 11.20.0 | 110 | 11/15/2026 |
| 11.19.4-rc.3 | 91 | 11/6/2026 |
| 11.19.3-rc.3 | 62 | 11/5/2026 |
| 11.19.3-rc.2 | 84 | 10/31/2026 |
| 11.17.3-rc.2 | 89 | 10/26/2026 |