Downloads · 30 days
4.2K
100% of all-time downloads
Contrastive-LM/CLM-v0.1-8B
CLM-v0.1-8B is a text ranking model from Contrastive-LM. Use it for the text ranking task on the model card, and read the license before you ship it in a product. It is set up for contrastive-lm. The card lists the license as apache-2.0.
<p align="center" <img alt="CLM v0.1" src="https://raw.githubusercontent.com/Contrastive-LM/CLM/main/assets/logo.png" width="45%" </p
Downloads · 30 days
4.2K
100% of all-time downloads
All-time downloads
4.2K
Public
Repo size
75.8 MB
Likes
756
Trending 84
Click a slice to open those files.
.pt75.6 MB · 100%
From the Hugging Face model README
Contrastive Language Model (CLM) is a new class of System One model trained with a contrastive learning objective that connects states and actions. CLM-8B consists of two small projection heads (a state head and an action head) on top of a frozen Qwen3-8B encoder trained with a bidirectional InfoNCE loss.
contrastive-lm packagepip install contrastive-lm
# 1. encoder (Qwen3-8B embeddings)
vllm serve Qwen/Qwen3-8B --served-model-name qwen3-8b --runner pooling --max-model-len 2048 --port 8090 &
# 2. API + playground at http://localhost:8700/ (fetches CLM_v0.1-8B.pt into ~/.cache/clm/)
clm-serve
Ask typed questions about a state:
from clm import CLMClient, Choice, Noul, Score
client = CLMClient() # http://127.0.0.1:8700 by default
r = client.system_one(
state="Customer: my invoice was charged twice and nobody answers the phone!",
questions={
"urgency": Noul(instructions="Is this urgent?"),
"department": Choice(instructions="Which team should handle this?",
criteria={"billing": "Charges, invoices, refunds",
"technical": "Bugs and outages"}),
"frustration": Score(instructions="How frustrated is the customer?",
criteria=["Calm", "Frustrated", "Very angry"]),
},
)
print(r.answers["department"].choice) # billing
print(r.answers["department"].probabilities) # {'billing': 0.93878, 'technical': 0.06122}
Or rank free-form candidates (best-of-N solutions, tool names, next moves):
from clm import Engine
engine = Engine(emb_url="http://127.0.0.1:8090/v1/embeddings")
engine.rank("What causes tides on Earth?",
["The Moon's gravitational pull.", "Photosynthesis in plants.", "Because the Earth is round."])
# [{'rank': 1, 'candidate': "The Moon's gravitational pull.", 'prob': 0.993}, ...]
Only the heads are trained, so fine-tuning is cheap. This checkpoint is the starting point for the DeepSWE and Terminal-Bench heads.
git clone https://github.com/Contrastive-LM/CLM.git && cd CLM && pip install -e .
hf download Contrastive-LM/deepswe-clm-heads-8k heldout_tasks.json --local-dir heads/deepswe
python train/finetune.py --task clm --init-ckpt "$(clm-download)" --out-dir runs/deepswe \
--holdout-tasks heads/deepswe/heldout_tasks.json --batch 512
See the fine-tuning guide.
clm-serve also serves a web playground at http://localhost:8700/.
@misc{kwok2026contrastivelanguagemodels,
title={Contrastive Language Models: A System One Model for Fast and Generalizable Decision-Making},
author={Jacky Kwok and Hangoo Kang and Tarun Suresh and Jon Saad-Falcon and Marco Pavone and Christopher Ré and Azalia Mirhoseini},
year={2026},
note={Notion Blog},
url={https://contrastive-lm.notion.site}
}
The CLM-8B weights are released under the Apache 2.0 License. The base encoder Qwen3-8B is also Apache 2.0.