README.md

GenAi-Tokenizer 🧠

An interactive tokenizer playground to explore how text breaks into tokens, how unique token IDs are assigned, and how decoding works - all powered by a custom tokenizer with a clean UI built on DaisyUI and Tailwind CSS.

Demo

Video Demo on cap.so/s/pn6qm0pxwkjfet9

Features

• Corpus Learning: Type or paste large paragraphs to learn vocabulary explicitly.
• Dynamic Vocabulary Growth: Vocabulary updates both when learning corpus and dynamically as you type in the Encoding input.
• Persistent Vocabulary: Vocabulary is stored centrally in React Context and persisted to a Github Gist for accessibility of vocabulary across devices.
• Encoding: Instantly see tokens and their assigned IDs for any text input.
• Decoding: Decode by entering comma-separated token IDs, showing the original text.
• Token Visualization: View tokens with color-coded types (words, punctuation, whitespace, etc.).
• Custom Tokenizer Logic: Pure JavaScript tokenizer with no external dependencies, designed for transparency and customization.

Tech Stack

• React + TypeScript + Vite.
• Tailwind CSS + DaisyUI for responsive, accessible styling.
• React Context + Hooks for centralized vocabulary state management.
• Github Gist API to persistent storage of vocabulary.

Getting Started

Prerequisites: Node.js 18+ and npm.

git clone https://github.com/n4ryn/genai-tokenizer.git
cd genai-tokenizer
npm install
npm run dev

To build and preview:

npm run build
npm run preview

Usage Tips

• Corpus: Use the default corpus or type your own text — click "Learn Vocabulary" to update the vocabulary from the corpus explicitly.
• Encoding: Enter any text prompt to see tokenization live; vocabulary updates dynamically as you type here as well.
• Decoding: Input comma-separated token IDs to see the corresponding decoded text.
• Clear & Reset: Clear inputs as needed; vocabulary is managed centrally and reflects updates across all components.

Tokenizer Details

• Token Types Recognized: words, numbers, punctuation, whitespace, special tokens.
• Vocabulary Management: Centralized via React Context, updated from corpus or encoding inputs, and persisted to vocab.json on Github Gist.
• Encoding: Assigns incremental numeric IDs per unique token, merging new tokens into existing vocabulary.
• Decoding: Maps numeric IDs back to tokens; unknown IDs render as [UNK].
• Performance: Vocabulary updates are batched and memoized to prevent unnecessary recomputations and UI re-renders.

Contributing & Support

• Open an issue or feature request on GitHub Issues.
• Reach out on Twitter or LinkedIn.

Badges