guttedgarden/tiktoken

PHP 7.4 version of tiktoken

1.2.1 2025-04-17 09:32 UTC

Requires

• php: >=7.4

MIT

• tokenizer
• encode
• decode
• bpe
• openai
• tiktoken

README

Yethee's tiktoken library port for PHP 7.4 without the Symfony package

Installation

$ composer require guttedgarden/tiktoken

Usage

use guttedgarden\Tiktoken\EncoderProvider;

$provider = new EncoderProvider();

$encoder = $provider->getForModel('gpt-3.5-turbo-0301');
$tokens = $encoder->encode('Hello world!');
print_r($tokens);
// OUT: [9906, 1917, 0]

$encoder = $provider->get('p50k_base');
$tokens = $encoder->encode('Hello world!');
print_r($tokens);
// OUT: [15496, 995, 0]

Cache

The encoder uses an external vocabularies, so caching is used by default to avoid performance issues.

By default, the directory for temporary files is used. You can override the directory for cache via environment variable TIKTOKEN_CACHE_DIR or use EncoderProvider::setVocabCache():

use guttedgarden\Tiktoken\EncoderProvider;

$encProvider = new EncoderProvider();
$encProvider->setVocabCache('/path/to/cache');

// Using the provider

Disable cache

You can disable the cache, if there are reasons for this, in one of the following ways:

• Set an empty string for the environment variable TIKTOKEN_CACHE_DIR.
• Programmatically:

use guttedgarden\Tiktoken\EncoderProvider;

$encProvider = new EncoderProvider();
$encProvider->setVocabCache(null); // disable the cache

Limitations

• Encoding for GPT-2 is not supported.
• Special tokens (like <|endofprompt|>) are not supported.

License

MIT