tiktoken is a fast BPE tokeniser for use with OpenAI's models

Project description

⏳ tiktoken

tiktoken is a fast BPE tokeniser for use with OpenAI's models.

import tiktoken
enc = tiktoken.get_encoding("cl100k_base")
assert enc.decode(enc.encode("hello world")) == "hello world"

# To get the tokeniser corresponding to a specific model in the OpenAI API:
enc = tiktoken.encoding_for_model("gpt-4")

The open source version of tiktoken can be installed from PyPI:

pip install tiktoken

The tokeniser API is documented in tiktoken/core.py.

Example code using tiktoken can be found in the OpenAI Cookbook.

Performance

tiktoken is between 3-6x faster than a comparable open source tokeniser:

Performance measured on 1GB of text using the GPT-2 tokeniser, using GPT2TokenizerFast from tokenizers==0.13.2, transformers==4.24.0 and tiktoken==0.2.0.

Getting help

Please post questions in the issue tracker.

If you work at OpenAI, make sure to check the internal documentation or feel free to contact @shantanu.

Extending tiktoken

You may wish to extend tiktoken to support new encodings. There are two ways to do this.

Create your Encoding object exactly the way you want and simply pass it around.

cl100k_base = tiktoken.get_encoding("cl100k_base")

# In production, load the arguments directly instead of accessing private attributes
# See openai_public.py for examples of arguments for specific encodings
enc = tiktoken.Encoding(
    # If you're changing the set of special tokens, make sure to use a different name
    # It should be clear from the name what behaviour to expect.
    name="cl100k_im",
    pat_str=cl100k_base._pat_str,
    mergeable_ranks=cl100k_base._mergeable_ranks,
    special_tokens={
        **cl100k_base._special_tokens,
        "<|im_start|>": 100264,
        "<|im_end|>": 100265,
    }
)

Use the tiktoken_ext plugin mechanism to register your Encoding objects with tiktoken.

This is only useful if you need tiktoken.get_encoding to find your encoding, otherwise prefer option 1.

To do this, you'll need to create a namespace package under tiktoken_ext.

Layout your project like this, making sure to omit the tiktoken_ext/__init__.py file:

my_tiktoken_extension
├── tiktoken_ext
│   └── my_encodings.py
└── setup.py

my_encodings.py should be a module that contains a variable named ENCODING_CONSTRUCTORS. This is a dictionary from an encoding name to a function that takes no arguments and returns arguments that can be passed to tiktoken.Encoding to construct that encoding. For an example, see tiktoken_ext/openai_public.py. For precise details, see tiktoken/registry.py.

Your setup.py should look something like this:

from setuptools import setup, find_namespace_packages

setup(
    name="my_tiktoken_extension",
    packages=find_namespace_packages(include=['tiktoken_ext*']),
    install_requires=["tiktoken"],
    ...
)

Then simply pip install ./my_tiktoken_extension and you should be able to use your custom encodings! Make sure not to use an editable install.

Project details

Release history Release notifications | RSS feed

0.8.0

Oct 3, 2024

0.7.0

May 13, 2024

0.6.0

Feb 9, 2024

0.5.2

Dec 3, 2023

0.5.1

Sep 13, 2023

0.5.0

Sep 12, 2023

This version

0.4.0

May 7, 2023

0.3.3

Mar 28, 2023

0.3.2

Mar 17, 2023

0.3.1

Mar 13, 2023

0.3.0

Mar 2, 2023

0.2.0

Feb 3, 2023

0.1.2

Jan 3, 2023

0.1.1

Dec 15, 2022

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tiktoken-0.4.0.tar.gz (25.5 kB view details)

Uploaded May 7, 2023 Source

Built Distributions

tiktoken-0.4.0-cp311-cp311-win_amd64.whl (635.3 kB view details)

Uploaded May 7, 2023 CPython 3.11 Windows x86-64

tiktoken-0.4.0-cp311-cp311-musllinux_1_1_x86_64.whl (1.8 MB view details)

Uploaded May 7, 2023 CPython 3.11 musllinux: musl 1.1+ x86-64

tiktoken-0.4.0-cp311-cp311-musllinux_1_1_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.11 musllinux: musl 1.1+ ARM64

tiktoken-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.11 manylinux: glibc 2.17+ x86-64

tiktoken-0.4.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.11 manylinux: glibc 2.17+ ARM64

tiktoken-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (761.4 kB view details)

Uploaded May 7, 2023 CPython 3.11 macOS 11.0+ ARM64

tiktoken-0.4.0-cp311-cp311-macosx_10_9_x86_64.whl (797.9 kB view details)

Uploaded May 7, 2023 CPython 3.11 macOS 10.9+ x86-64

tiktoken-0.4.0-cp310-cp310-win_amd64.whl (635.3 kB view details)

Uploaded May 7, 2023 CPython 3.10 Windows x86-64

tiktoken-0.4.0-cp310-cp310-musllinux_1_1_x86_64.whl (1.8 MB view details)

Uploaded May 7, 2023 CPython 3.10 musllinux: musl 1.1+ x86-64

tiktoken-0.4.0-cp310-cp310-musllinux_1_1_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.10 musllinux: musl 1.1+ ARM64

tiktoken-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.10 manylinux: glibc 2.17+ x86-64

tiktoken-0.4.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.10 manylinux: glibc 2.17+ ARM64

tiktoken-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (761.4 kB view details)

Uploaded May 7, 2023 CPython 3.10 macOS 11.0+ ARM64

tiktoken-0.4.0-cp310-cp310-macosx_10_9_x86_64.whl (798.0 kB view details)

Uploaded May 7, 2023 CPython 3.10 macOS 10.9+ x86-64

tiktoken-0.4.0-cp39-cp39-win_amd64.whl (635.6 kB view details)

Uploaded May 7, 2023 CPython 3.9 Windows x86-64

tiktoken-0.4.0-cp39-cp39-musllinux_1_1_x86_64.whl (1.8 MB view details)

Uploaded May 7, 2023 CPython 3.9 musllinux: musl 1.1+ x86-64

tiktoken-0.4.0-cp39-cp39-musllinux_1_1_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.9 musllinux: musl 1.1+ ARM64

tiktoken-0.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.9 manylinux: glibc 2.17+ x86-64

tiktoken-0.4.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.9 manylinux: glibc 2.17+ ARM64

tiktoken-0.4.0-cp39-cp39-macosx_11_0_arm64.whl (761.7 kB view details)

Uploaded May 7, 2023 CPython 3.9 macOS 11.0+ ARM64

tiktoken-0.4.0-cp39-cp39-macosx_10_9_x86_64.whl (798.2 kB view details)

Uploaded May 7, 2023 CPython 3.9 macOS 10.9+ x86-64

tiktoken-0.4.0-cp38-cp38-win_amd64.whl (635.3 kB view details)

Uploaded May 7, 2023 CPython 3.8 Windows x86-64

tiktoken-0.4.0-cp38-cp38-musllinux_1_1_x86_64.whl (1.8 MB view details)

Uploaded May 7, 2023 CPython 3.8 musllinux: musl 1.1+ x86-64

tiktoken-0.4.0-cp38-cp38-musllinux_1_1_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.8 musllinux: musl 1.1+ ARM64

tiktoken-0.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.8 manylinux: glibc 2.17+ x86-64

tiktoken-0.4.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB view details)

Uploaded May 7, 2023 CPython 3.8 manylinux: glibc 2.17+ ARM64

tiktoken-0.4.0-cp38-cp38-macosx_11_0_arm64.whl (761.6 kB view details)

Uploaded May 7, 2023 CPython 3.8 macOS 11.0+ ARM64

tiktoken-0.4.0-cp38-cp38-macosx_10_9_x86_64.whl (798.4 kB view details)

Uploaded May 7, 2023 CPython 3.8 macOS 10.9+ x86-64

File details

Details for the file tiktoken-0.4.0.tar.gz.

File metadata

Download URL: tiktoken-0.4.0.tar.gz
Upload date: May 7, 2023
Size: 25.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.2 CPython/3.10.9

File hashes

Hashes for tiktoken-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`59b20a819969735b48161ced9b92f05dc4519c17be4015cfb73b65270a243620`
MD5	`b8594d0c143ee43a4d634b9e9b344dff`
BLAKE2b-256	`9f8877a86f915a81449156375b7538c94105a34bebf00838462c9d3fced490e9`

Algorithm	Hash digest
SHA256	`08efa59468dbe23ed038c28893e2a7158d8c211c3dd07f2bbc9a30e012512f1d`
MD5	`252d0cbdfdaba2da86bb5a63b4bf1d72`
BLAKE2b-256	`7a9b721c512a1f1d011ab122b15231eaa5448abfc664068527ed5ebf01cbe6b4`

Algorithm	Hash digest
SHA256	`b1a038cee487931a5caaef0a2e8520e645508cde21717eacc9af3fbda097d8bb`
MD5	`0b3143ea5885b5882a629f49898354c6`
BLAKE2b-256	`cb6a0f6a998fc270c0deec44120f024f625b12cfcce6b8f38b0b5454beb33476`

Algorithm	Hash digest
SHA256	`329f548a821a2f339adc9fbcfd9fc12602e4b3f8598df5593cfc09839e9ae5e4`
MD5	`532a55f886ec80ff90f8003cc5621ea0`
BLAKE2b-256	`f5d204516a997061a580b103c0fdf991c69103bb2b376bb9e6004d0939bcc8e8`

Algorithm	Hash digest
SHA256	`4d980fa066e962ef0f4dad0222e63a484c0c993c7a47c7dafda844ca5aded1f3`
MD5	`6c0e739afc5c9a862ac467e15d0ab643`
BLAKE2b-256	`14aac408e1da953e1207fff2cd8a783081b7eaf12dcd3083cacbc170009cfc18`

Algorithm	Hash digest
SHA256	`3dc3df19ddec79435bb2a94ee46f4b9560d0299c23520803d851008445671197`
MD5	`38852ade0d058cbc88afbd0a012f25b2`
BLAKE2b-256	`4887167df39189db7f91ab2ada94e482d7b079cfd3d736cda9a4f62520915c77`

Algorithm	Hash digest
SHA256	`2ca30367ad750ee7d42fe80079d3092bd35bb266be7882b79c3bd159b39a17b0`
MD5	`a9a69be0fa20233e4107085f76dcb60f`
BLAKE2b-256	`af24d4ed04ca66a17fcc11f49f952bd96295c2b0eff201cd71b2484789e576f9`

Algorithm	Hash digest
SHA256	`bb2341836b725c60d0ab3c84970b9b5f68d4b733a7bcb80fb25967e5addb9920`
MD5	`0d1c8f828393fff97c70235d12ba9c4c`
BLAKE2b-256	`cd189fd4000bbbf47f0e683fba343aeed655dbab27edda6a6bfc3bcf57be02bd`

Algorithm	Hash digest
SHA256	`1e8fa13cf9889d2c928b9e258e9dbbbf88ab02016e4236aae76e3b4f82dd8288`
MD5	`c29afec0ed5354de2eab69d7e7e29320`
BLAKE2b-256	`25791000f42adb9616193ae7e3620285747fecc3c7b17a2a24fc2d2296e4183d`

Algorithm	Hash digest
SHA256	`9ec161e40ed44e4210d3b31e2ff426b4a55e8254f1023e5d2595cb60044f8ea6`
MD5	`6253268d8fe7205a8d067bf9c53522ed`
BLAKE2b-256	`6d25d90f8e0c78d0f33d2373165421c534526127065acf2d605442df7aa8c6f1`

Algorithm	Hash digest
SHA256	`c06cd92b09eb0404cedce3702fa866bf0d00e399439dad3f10288ddc31045422`
MD5	`d4d8778b2267c895f28d258df6bef5d6`
BLAKE2b-256	`a69f6dcb693858bd12bed0d7e0c19dd450f7e7b7ca7a8897dd184ba9240c1d52`

Algorithm	Hash digest
SHA256	`5727d852ead18b7927b8adf558a6f913a15c7766725b23dbe21d22e243041b28`
MD5	`56a7216cbe85b3ec6e64d05a6b2b2606`
BLAKE2b-256	`5f3693115cf8bdb62284dd64c01893b208ac46e586cb6e01ad34bbe0784b90f4`

Algorithm	Hash digest
SHA256	`00d662de1e7986d129139faf15e6a6ee7665ee103440769b8dedf3e7ba6ac37f`
MD5	`85ec2abb3d8d07221fe090f897b07825`
BLAKE2b-256	`1e77772fe6a9219e937d49f527a8ae1758e7b6637e27ed5d2180138a7fea1000`

Algorithm	Hash digest
SHA256	`450d504892b3ac80207700266ee87c932df8efea54e05cefe8613edc963c1285`
MD5	`f20d206a4061af5bb4aa7ec310bde3e0`
BLAKE2b-256	`db4ae264d72875dcf8b286174d6657d7c1b7ea43011d993e38918c79e0e92703`

Algorithm	Hash digest
SHA256	`176cad7f053d2cc82ce7e2a7c883ccc6971840a4b5276740d0b732a2b2011f8a`
MD5	`7085c90149e91fa6e31a151f177b51a7`
BLAKE2b-256	`a8a0278261d2902e335845742ef219ab2435a353a77a140d43a46b65a525801d`

Algorithm	Hash digest
SHA256	`c835d0ee1f84a5aa04921717754eadbc0f0a56cf613f78dfc1cf9ad35f6c3fea`
MD5	`95d823e0824ebd6588b20bb3794075c5`
BLAKE2b-256	`313ca29e7e9f147e479c856844f0f28ae14419b47b3f9cc34a2ffaa12adc9569`

Algorithm	Hash digest
SHA256	`55e251b1da3c293432179cf7c452cfa35562da286786be5a8b1ee3405c2b0dd2`
MD5	`236f310a4c29bc8346086e662dd282eb`
BLAKE2b-256	`75bb472c684a29ef779c499bc86c305ef9793d90e7fdb7897330d151961b0cca`

Algorithm	Hash digest
SHA256	`dae2af6f03ecba5f679449fa66ed96585b2fa6accb7fd57d9649e9e398a94f44`
MD5	`5e530b43d38b8f71bd8975ff9a602a8d`
BLAKE2b-256	`0d0e38e92db130ce061bad473ea072163d592c6cb6befbe27512b0f387c86144`

Algorithm	Hash digest
SHA256	`d0394967d2236a60fd0aacef26646b53636423cc9c70c32f7c5124ebe86f3093`
MD5	`fb5c2b6328e3bbaa496a0fc3aa176614`
BLAKE2b-256	`70eaa560501876b5fda9fc164224dbec6482bb31d5539728a5a2d69a4c7600e3`

Algorithm	Hash digest
SHA256	`5a73286c35899ca51d8d764bc0b4d60838627ce193acb60cc88aea60bddec4fd`
MD5	`b44d6708156e12ddc86bafb53d2be693`
BLAKE2b-256	`d0a0de8bd6e95e72b6e8e70667f79d57389381693eacc1b76bff74da909a3002`

Algorithm	Hash digest
SHA256	`1b6bce7c68aa765f666474c7c11a7aebda3816b58ecafb209afa59c799b0dd2d`
MD5	`e50525e2d6377efdb4efce1adeb3b211`
BLAKE2b-256	`8bf9ca94b3bb737eaf3724fd715d6ce2d9968671ca27ade3612ea9ff7f3909a1`

tiktoken 0.4.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Project description

⏳ tiktoken

Performance

Getting help

Extending tiktoken

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

Algorithm	Hash digest
SHA256	`8d1d97f83697ff44466c6bef5d35b6bcdb51e0125829a9c0ed1e6e39fb9a08fb`
MD5	`aaad061d0f35227389aba071327a409d`
BLAKE2b-256	`51a74de4e2970483d6d666255cdca723757bfe983f6bd8170e7ce5a389d76ab8`

Algorithm	Hash digest
SHA256	`9c6dd439e878172dc163fced3bc7b19b9ab549c271b257599f55afc3a6a5edef`
MD5	`caedb2021177ca55cc9618496cca55e6`
BLAKE2b-256	`0969160de19b7846923d5e1357a9a61036228806fb2ba726bdd8ee930cbd4bf4`

Algorithm	Hash digest
SHA256	`e063b988b8ba8b66d6cc2026d937557437e79258095f52eaecfafb18a0a10c03`
MD5	`8033b3db54b83f66ec63d02cfcc0ed9c`
BLAKE2b-256	`8fe959aef87c5b95cbff1f46ff8211c81d71ffd40a59b49d6f5d6c7a56bca4ca`

Algorithm	Hash digest
SHA256	`e87751b54eb7bca580126353a9cf17a8a8eaadd44edaac0e01123e1513a33281`
MD5	`ebbb2f722904d2f4ee4fc3864a83cdbe`
BLAKE2b-256	`6d97f8b31485ec07b740714a981355e9b65f6e90bd365eab1fb91e199c970c4c`

Algorithm	Hash digest
SHA256	`64e1091c7103100d5e2c6ea706f0ec9cd6dc313e6fe7775ef777f40d8c20811e`
MD5	`21f4ab4089d3ba7f951319453fb19bce`
BLAKE2b-256	`357a444904f5969300e6bdd886102b499f3bcd80d49c25e46b176aebd262b223`

Algorithm	Hash digest
SHA256	`9c15d9955cc18d0d7ffcc9c03dc51167aedae98542238b54a2e659bd25fe77ed`
MD5	`0f89f11b74122b949fd15a6986a2fc5c`
BLAKE2b-256	`a493fe26dd01e3b598a7de26dab7d86f357561540e20cf9478bae32078e3ee32`

Algorithm	Hash digest
SHA256	`ba16698c42aad8190e746cd82f6a06769ac7edd415d62ba027ea1d99d958ed93`
MD5	`721f831852667a69efb0e49a49a610e5`
BLAKE2b-256	`3478a0ec01f1c82371f696e19e02174968b48214dd730468fe6004df7b23755e`

Algorithm	Hash digest
SHA256	`f3020350685e009053829c1168703c346fb32c70c57d828ca3742558e94827a9`
MD5	`b7aa0a842450963b97a39120e609eb64`
BLAKE2b-256	`e27c220af98622ae684c7fc1ad8c778dd7e961df30f74ac66e097d3d8d4ce79f`