TiktokenSharp 1.1.2
See the version list below for details.
dotnet add package TiktokenSharp --version 1.1.2
NuGet\Install-Package TiktokenSharp -Version 1.1.2
<PackageReference Include="TiktokenSharp" Version="1.1.2" />
paket add TiktokenSharp --version 1.1.2
#r "nuget: TiktokenSharp, 1.1.2"
// Install TiktokenSharp as a Cake Addin #addin nuget:?package=TiktokenSharp&version=1.1.2 // Install TiktokenSharp as a Cake Tool #tool nuget:?package=TiktokenSharp&version=1.1.2
TiktokenSharp
Due to the lack of a C# version of cl100k_base
encoding (gpt-3.5-turbo), I have implemented a basic solution with encoding and decoding methods based on the official Rust implementation.
Currently, cl100k_base
p50k_base
has been implemented. Other encodings will be added in future submissions. If you encounter any issues or have questions, please feel free to submit them on the lssues
."
If you want to use the ChatGPT C# library that integrates this repository and implements context-based conversation, please visit ChatGPTSharp.
Getting Started
TiktokenSharp is available as NuGet package.
using TiktokenSharp;
//use model name
TikToken tikToken = TikToken.EncodingForModel("gpt-3.5-turbo");
var i = tikToken.Encode("hello world"); //[15339, 1917]
var d = tikToken.Decode(i); //hello world
//use encoding name
TikToken tikToken = TikToken.GetEncoding("cl100k_base");
var i = tikToken.Encode("hello world"); //[15339, 1917]
var d = tikToken.Decode(i); //hello world
When using a new encoder for the first time, the required tiktoken files for the encoder will be downloaded from the internet. This may take some time. Once the download is successful, subsequent uses will not require downloading again. You can set TikToken.PBEFileDirectory
before using the encoder to modify the storage path of the downloaded tiktoken files, or you can pre-download the files to avoid network issues causing download failures.
Why are the tiktoken files not integrated into the package? On one hand, this would make the package size larger. On the other hand, I want to stay as consistent as possible with OpenAI's official Python code.
If you are deploying cloud functions, such as "Azure App Service," which cannot read/write local files, please package tiktoken files(PBE Dir) with the publish files.
Below are the file download links: p50k_base.tiktoken cl100k_base.tiktoken
Benchmark Test
I noticed that some users would like to get a comparison of efficiency. Here, I use SharpToken as the basic comparison, with the encoder cl100k_base, on the .Net 6.0 in Debug mode.
- TiktokenSharp Version: 1.1.0
- SharpToken Version: 2.0.1
<details> <summary>Code:</summary>
private GptEncoding _sharpToken = GptEncoding.GetEncoding("cl100k_base");
private TikToken _tikToken = TikToken.GetEncoding("cl100k_base");
private string _kLongText = "King Lear, one of Shakespeare's darkest and most savage plays, tells the story of the foolish and Job-like Lear, who divides his kingdom, as he does his affections, according to vanity and whim. Lear’s failure as a father engulfs himself and his world in turmoil and tragedy.";
[Benchmark]
public int SharpToken()
{
var sum = 0;
for (var i = 0; i < 10000; i++)
{
var encoded = _sharpToken.Encode(_kLongText);
var decoded = _sharpToken.Decode(encoded);
sum += decoded.Length;
}
return sum;
}
[Benchmark]
public int TiktokenSharp()
{
var sum = 0;
for (var i = 0; i < 10000; i++)
{
var encoded = _tikToken.Encode(_kLongText);
var decoded = _tikToken.Decode(encoded);
sum += decoded.Length;
}
return sum;
}
</details>
Method | Job | Runtime | Mean | Error | StdDev | Gen0 | Allocated |
---|---|---|---|---|---|---|---|
SharpToken | .NET 8.0 | .NET 8.0 | 116.38 ms | 1.026 ms | 0.909 ms | 2000.0000 | 23201696 B |
TiktokenSharp | .NET 8.0 | .NET 8.0 | 98.34 ms | 0.198 ms | 0.176 ms | 9833.3333 | 82321080 B |
Update
1.1.0 20240408
- Optimize algorithm efficiency.
1.0.9 20240208
- Adding support for new OpenAI embeddings. by @winzig
1.0.7 20231010
- Corrected the issue where some new models could not properly obtain the encoder.
1.0.7 20231010
- Corrected the issue where some new models could not properly obtain the encoder.
1.0.6 20230625
- Replace WebClient with HttpClient, add async methods.
1.0.5 20230508
- New support for .Net Standard 2.0 has been added, making TiktokenSharp usable in the .Net Framework.
1.0.4 20230424
- Add method TikToken.GetEncoding(encodingName).
1.0.3 20230321
- GetEncodingSetting now supports the model of gpt-4 and also allows for encoding names to be directly passed in.
1.0.2 20230317
- add method TikToken.PBEFileDirectory to allow for custom storage directory of bpe files. the path needs to be set before TikToken.EncodingForModel().
1.0.1 20230313
- p50k_base encoding algorithm that supports the text-davinci-003 model.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- IndexRange (>= 1.0.2)
- System.Memory (>= 4.5.3)
-
.NETStandard 2.1
- No dependencies.
-
net7.0
- No dependencies.
-
net8.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on TiktokenSharp:
Package | Downloads |
---|---|
ChatGPTSharp
Supports gpt-4o, o1 models; auto-calculates tokens; enables continuous dialogues with conversationId; now includes Vision model image sending. |
GitHub repositories (2)
Showing the top 2 popular GitHub repositories that depend on TiktokenSharp:
Repository | Stars |
---|---|
dmitry-brazhenko/SharpToken
SharpToken is a C# library for tokenizing natural language text. It's based on the tiktoken Python library and designed to be fast and accurate.
|
|
MayDay-wpf/AIBotPublic
AIBot PRO 是一个基于.NET 6 的 AI聚合客户端 to C 弱 to B 可以集成众多AI产品(ChatGPT,Gemini,Claude,文心一言,通义千问,讯飞星火),无感切换对话,支持知识库、插件开发、AI流程引擎(workflow)、以及开放平台对外输出定制化的特色AI API
|
Version | Downloads | Last updated | |
---|---|---|---|
1.1.6 | 61 | 12/24/2024 | |
1.1.5 | 5,470 | 10/8/2024 | |
1.1.4 | 37,363 | 5/14/2024 | |
1.1.2 | 450 | 5/14/2024 | |
1.1.1 | 110 | 5/14/2024 | |
1.1.0 | 7,057 | 4/8/2024 | |
1.0.9 | 13,471 | 2/8/2024 | |
1.0.8 | 14,659 | 12/27/2023 | |
1.0.7 | 25,839 | 10/10/2023 | |
1.0.6 | 66,212 | 6/25/2023 | |
1.0.5 | 51,226 | 5/8/2023 | |
1.0.4 | 2,082 | 4/24/2023 | |
1.0.3 | 2,345 | 3/21/2023 | |
1.0.2 | 610 | 3/17/2023 | |
1.0.1 | 1,414 | 3/13/2023 | |
1.0.0 | 621 | 3/7/2023 |