chatunify 0.1.0

Convert any sentence or chat messages array to the official chat template for OpenAI, Mistral, and Qwen models.

chatunify

Convert any sentence or chat messages array into the official chat template for OpenAI, Mistral, and Qwen models.

Installation

pip install chatunify

Quick Start

from chatunify import apply_template

# Plain string — auto-wrapped as a user message
result = apply_template("Hello!", model="gpt-4o")
result = apply_template("Hello!", model="mistral-large-latest")
result = apply_template("Hello!", model="qwen2.5-72b-instruct")

# Full messages array
messages = [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What is the capital of France?"},
]
result = apply_template(messages, model="mistral-large-latest")

Supported Models

Provider	Model name patterns	Template
OpenAI	gpt-*, o1, o3, o4, chatgpt-*	JSON messages array (API format)
Mistral V1	mistral-7b-v0.1	<s> [INST] user [/INST] assistant</s>
Mistral V2	mistral-7b-v0.2, mixtral-*, mistral-small/medium	<s>[INST] user[/INST] assistant</s>
Mistral V3	mistral-large, mistral-nemo, codestral, *-2407+	<s>[INST]user[/INST]assistant</s>
Qwen	qwen*, qwq*	ChatML <|im_start|>role\ncontent<|im_end|>

Template Outputs

OpenAI

Returns a pretty-printed JSON string of the messages array — the canonical OpenAI API input format.

[
  {"role": "system", "content": "You are helpful."},
  {"role": "user", "content": "Hello!"}
]

Mistral (V3 / Tekken)

<s>[INST]You are helpful.

Hello![/INST]

Qwen (ChatML)

<|im_start|>system
You are helpful.<|im_end|>
<|im_start|>user
Hello!<|im_end|>
<|im_start|>assistant

API

apply_template(input, model)

Parameter	Type	Description
input	str or list[dict]	Plain string or list of {"role": ..., "content": ...} dicts
model	str	Model name (e.g. "gpt-4o", "mistral-large-latest", "qwen2.5-72b-instruct")

Returns: str — the formatted prompt string.

detect_provider(model)

Returns (provider, variant) tuple for a given model name. Useful for debugging routing.

from chatunify import detect_provider

detect_provider("gpt-4o")               # ("openai", None)
detect_provider("mistral-large-latest") # ("mistral", "v3")
detect_provider("qwen2.5-72b-instruct") # ("qwen", None)

Running Tests

python tests/test_templates.py