mayatok 2.1.4

High performance BPE tokenizer written in Rust with Python bindings

MayaTok

MayaTok is a Byte-Pair Encoding (BPE) tokenizer written in Rust. Built with performance and extensibility in mind. I made this project just because I wanted to study how Byte Pair Encoding Works.

Version: 2.1.4

⚡️ Features (More optimizations in Progress)

• Multithreaded training for fast vocab generation

• Persistent merges

• Checkpoint saving

• Focus on raw speed — built for performance benchmarking

🚀 Installation

Prerequisites

• Rust (required)
• Python 3.9+ (for Python bindings)

PIP Installation

pip install mayatok

From Source

git clone https://github.com/AlgoBrother/MayaTok-BPE.git
cd mayatok-bpe

Use maturin for building wheels.

pip install maturin
maturin build --release
pip install target/wheels/*.whl

Quick Start

Using with Python

To use MayaTok with Python:

import mayatok as bpe

my_tokenizer =  bpe.get_tokenizer("v2-100k") # or 'mayatok-base' if you wish to use v1 tokenizer
test = "Hello, world!"
tokens = my_tokenizer.encode(test)
print(tokens)
decoded_text = my_tokenizer.decode(tokens)
print(decoded_text)

Output of the sample code above

[11608, 77, 3641, 62]
Hello, world!

If you want to create your own Vocab

If you are using HuggingFace Datasets, refer to this for creating your own vocab.

If your dataset is in your local machine

Make sure you have forked/cloned the rust tokenizer code and have built the /target/wheels as mentioned in previous steps

stream method - If you have a large dataset and want to stream your data in chunks to not overload your machine. Use this.

non-stream method - If you have a dataset which your RAM can handle after being loaded, use this for much faster training.

📈 Benchmarks

Batch Encoding

Tokenizer	Tokens/sec	Avg Compression Ratio
MayaTok-BPE	6,757,698	2.75
tiktoken-cl100k	262,016	3.36
tiktoken-p50k	288,657	3.27
GPT2	1,940,899	2.94
Falcon-7B	1,554,393	3.26

Normal Encoding

Tokenizer	Tokens/sec	Compression Ratio
MayaTok	1,249,426	2.75
tiktoken-cl100k	2,318,683	3.36
tiktoken-p50k	2,670,190	3.27
GPT2	519,369	2.94
Falcon-7B	346,040	3.26

Note: Performance optimizations are ongoing (MAY CHANGE SINCE I AM APPLYING NEW BENCHMARK METHOD.)

💽 Corpus Used for V2

cosmopedia-v2

c4-english

wikipedia

openwebtext

github-top-code

arxiv-papers

Check dataset_training/train.py for more details

🙌 Contributing

Pull requests and suggestions are welcome! Feel free to open issues for bugs, feature requests, or optimizations.

📄 License

Apache-2.0

Future Targets [COMPLETED]

• [✓] PyPI package distribution

• [✓] the examples folder has lot of python implementation. Will experiment to integrate this in rust side of code and make python side of code more smaller and easier for users.

• [✓] Enhanced CPU utilization and faster merging algorithms

• [✓] Improved merge quality and compression ratios

• [✓] Bincode support for faster model loading

• [✓] New Line Format support