diff options
| author | Onur Gündüz <ogunduz@gmail.com> | 2026-09-29 12:54:13 +0200 |
|---|---|---|
| committer | Onur Gündüz <ogunduz@gmail.com> | 2026-09-29 12:54:13 +0200 |
| commit | 91871be6ece9317c5d49353f6474583e7e28168d (patch) | |
| tree | 8cabf2546322a9e1b724bf8413f32de54378824f /libffwd/bpe.h | |
| parent | 35ab9c12ba4d396e6cba99d6ea947e26becedad4 (diff) | |
| download | langdet-91871be6ece9317c5d49353f6474583e7e28168d.tar.gz langdet-91871be6ece9317c5d49353f6474583e7e28168d.zip | |
Add native CPU language detection CLI
Diffstat (limited to 'libffwd/bpe.h')
| -rw-r--r-- | libffwd/bpe.h | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/libffwd/bpe.h b/libffwd/bpe.h new file mode 100644 index 0000000..5199fd0 --- /dev/null +++ b/libffwd/bpe.h @@ -0,0 +1,74 @@ +/* + * Qwen2/Qwen3 BPE tokenizer (GPT-2 byte-level). + * + * Supports: + * - decode token ID -> UTF-8 text + * - encode UTF-8 text -> token IDs (vocab.json + merges.txt) + */ + +#ifndef TOK_BPE_H +#define TOK_BPE_H + +typedef struct { + char **id_to_text; /* [vocab_size] decoded text strings */ + char **id_to_bpe; /* [vocab_size] raw BPE token strings from vocab.json */ + int vocab_size; + + /* Internal hash maps (opaque to callers) */ + void *vocab_map; + int vocab_map_cap; + void *merge_map; + int merge_map_cap; + /* Integer-pair BPE merge table: (left_id, right_id) -> (rank, merged_id). + * NULL when the vocab could not resolve every merge; encoding then falls + * back to the string-based merge loop. */ + void *int_merges; + int int_merges_cap; + /* Byte-level unicode codepoint -> single-character token id (512 slots), + * or NULL when any byte token is missing from the vocab. */ + int *cp_to_id; +} tok_bpe_t; + +typedef struct tok_bpe_workspace tok_bpe_workspace_t; + +/* Load tokenizer from vocab.json in model directory */ +tok_bpe_t *tok_bpe_load(const char *vocab_json_path); + +/* Decode a single token ID to text. Returns pointer to internal string. */ +const char *tok_bpe_decode(const tok_bpe_t *tok, int token_id); + +/* Look up the id of a raw vocab.json token string (e.g. "<|endoftext|>"). + * Returns -1 when the token is not in the vocab. */ +int tok_bpe_token_id(const tok_bpe_t *tok, const char *token); + +/* Encode UTF-8 text into token IDs using BPE. + * Returns malloc'd array of token IDs and sets *out_n_tokens. + * Returns NULL on error (and sets *out_n_tokens to 0). */ +int *tok_bpe_encode(const tok_bpe_t *tok, const char *text, int *out_n_tokens); + +/* Reusable scratch for allocation-light repeated encoding. */ +tok_bpe_workspace_t *tok_bpe_workspace_new(void); +void tok_bpe_workspace_free(tok_bpe_workspace_t *ws); + +/* Encode into caller-provided out_ids[0..out_cap-1]. + * Returns 0 on success, -1 on error, -2 if out_cap is too small. + * In all cases *out_n_tokens is set to the number of tokens needed/emitted + * when out_n_tokens is non-NULL. */ +int tok_bpe_encode_into(const tok_bpe_t *tok, + tok_bpe_workspace_t *ws, + const char *text, + int *out_ids, + int out_cap, + int *out_n_tokens); + +/* Same tokenization as tok_bpe_encode(), but reuses ws internally and + * performs only the final returned int[] allocation. */ +int *tok_bpe_encode_with_workspace(const tok_bpe_t *tok, + tok_bpe_workspace_t *ws, + const char *text, + int *out_n_tokens); + +/* Free tokenizer */ +void tok_bpe_free(tok_bpe_t *tok); + +#endif /* TOK_BPE_H */ |
