Lodestar.Embeddings 0.7.0. This page is frozen at that release. Read the current documentation for what main says now. A link to a decision or a migration page follows main, and leaves the archive.

TokenizerJsonLoader.LoadUnigramAsync

Reads the Unigram model a tokenizer.json declares, asynchronously.

public static Task<SentencePieceVocabulary> LoadUnigramAsync(Stream source, ArtifactLoadOptions options = null, CancellationToken cancellationToken = default)

Parameters — source is a readable stream, never disposed here; path is the file to read. options bounds what will be accepted and defaults to ArtifactLoadOptions's own defaults. cancellationToken cancels the read.

Returns — Task<SentencePieceVocabulary>, completing with the loaded vocabulary.

Exceptions — ArgumentNullException for a null source or path. InvalidDataException when the file declares a different model, declares a pipeline this package does not reproduce, or exceeds a bound in options — the message names what was refused and why. OperationCanceledException when cancellationToken is signalled.

Example — the same load, awaited.

using Lodestar.Embeddings.Persistence;
using Lodestar.Embeddings.Tokenization;

static async Task<SentencePieceVocabulary> LoadAsync() =>
    await TokenizerJsonLoader.LoadUnigramAsync(File.OpenRead("tokenizer.json"));

SentencePieceVocabulary vocab = LoadAsync().GetAwaiter().GetResult();

Remarks — Same file, same reads and the same refusals as LoadUnigram, including the wrong-model-kind failure a Llama-2 file produces here; only the I/O is asynchronous.

Applies to — net10.0, netstandard2.0.

See also — TokenizerJsonLoader.LoadUnigram, TokenizerJsonLoader, the persistence index.