Instructions to use YourIdentity/MiniCPM5-2B-heretic with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use YourIdentity/MiniCPM5-2B-heretic with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="YourIdentity/MiniCPM5-2B-heretic")
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("YourIdentity/MiniCPM5-2B-heretic")
model = AutoModelForCausalLM.from_pretrained("YourIdentity/MiniCPM5-2B-heretic", device_map="auto")
messages = [
    {"role": "user", "content": "Who are you?"},
]
inputs = tokenizer.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps Settings

vLLM

How to use YourIdentity/MiniCPM5-2B-heretic with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "YourIdentity/MiniCPM5-2B-heretic"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "YourIdentity/MiniCPM5-2B-heretic",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/YourIdentity/MiniCPM5-2B-heretic

SGLang

How to use YourIdentity/MiniCPM5-2B-heretic with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "YourIdentity/MiniCPM5-2B-heretic" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "YourIdentity/MiniCPM5-2B-heretic",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "YourIdentity/MiniCPM5-2B-heretic" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "YourIdentity/MiniCPM5-2B-heretic",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Docker Model Runner
How to use YourIdentity/MiniCPM5-2B-heretic with Docker Model Runner:
```
docker model run hf.co/YourIdentity/MiniCPM5-2B-heretic
```

MiniCPM5-2B-heretic / reproduce /README.md

YourIdentity

Upload reproduce/README.md with huggingface_hub

df677fb verified 9 days ago

preview code

Raw

History Blame

3.17 kB

Reproduction guide

This directory contains the necessary information and assets to reproduce the results obtained during this Heretic run.

Local code

This system installed Heretic from a local directory or wheel. Uncommitted or experimental code may have been executed.

Reproducibility cannot be guaranteed in this environment.

Models

Base model: openbmb/MiniCPM5-2B (Commit: 12a3808)

Datasets

Good prompts: mlabonne/harmless_alpaca (Commit: 02c6a92)
Bad prompts: mlabonne/harmful_behaviors (Commit: 01cead0)

Selected trial

Trial number: 191
Refusals: 6/100 (baseline: 99/100)
KL divergence: 0.0307 (baseline: 0 (by definition))

Environment

Heretic: v2.0.0.dev0 (Origin: Local)
PyTorch: 2.14.0+cu132
Other dependencies: See requirements.txt.

Contents of this directory

requirements.txt: The exact versions of all Python packages.
config.toml: The exact configuration used, including the RNG seed.
openbmb--MiniCPM5-2B.jsonl: The Optuna study journal containing the history of all trials.
SHA256SUMS: Cryptographic hashes for all weight files.
reproduce.json: A machine-readable file containing all reproducibility information.

How to reproduce

You can automate this process, including all verification steps, by downloading the reproduce.json file and running heretic --reproduce reproduce.json.

Install the exact version of Heretic indicated in the Environment section above, from its original source.
Install the packages listed in requirements.txt: pip install -r requirements.txt
Install the correct version of PyTorch: pip install torch==2.14.0+cu132 --index-url https://download.pytorch.org/whl/cu132
Place the provided config.toml in your working directory.
Run Heretic without any additional arguments: heretic
Wait for the run to finish, then select trial 191 and export the model.
Verify that the weight files have been exactly reproduced by comparing their SHA-256 hashes against those in SHA256SUMS: sha256sum -c SHA256SUMS (or look at the hashes online if you uploaded to Hugging Face)

To use the included Optuna study journal openbmb--MiniCPM5-2B.jsonl, place it in the checkpoints directory (usually checkpoints/) before running Heretic.

This allows you to export other models from the Pareto front, or to run additional trials without having to re-run the stored trials.