Instructions to use plantwaterer/oenogarum with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use plantwaterer/oenogarum with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="plantwaterer/oenogarum") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("plantwaterer/oenogarum") model = AutoModelForMultimodalLM.from_pretrained("plantwaterer/oenogarum", device_map="auto") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] inputs = processor.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=256) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use plantwaterer/oenogarum with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "plantwaterer/oenogarum" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "plantwaterer/oenogarum", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/plantwaterer/oenogarum
- SGLang
How to use plantwaterer/oenogarum 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 "plantwaterer/oenogarum" \ --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": "plantwaterer/oenogarum", "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 "plantwaterer/oenogarum" \ --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": "plantwaterer/oenogarum", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use plantwaterer/oenogarum with Docker Model Runner:
docker model run hf.co/plantwaterer/oenogarum
oenogarum
oenogarum is a fine-tune of google/gemma-4-31B-it that answers multiple-choice
decision questions with a probability for each option. It includes a calibrated last-layer head (vbll_head.safetensors,
vbll_head.json) whose output is the answer. For ordinary multiple-choice questions that output is the softmax of the option
letters' logits at the answer position, divided by one fitted temperature (T = 1.080); no posterior is involved. For yes / no
questions, a Bayesian last-layer residual on the model's hidden state (a Laplace posterior, integrated over) adjusts the two
logits.
Inference engines. The repository includes these Decision Index engines; all use the same weights and head:
lenavg_bayes_engine:LenAvgBayesEngine(lenavg_bayes_engine.py, withlenavg_engine.pyandoavg_engine.py): length-adaptive option-order averaging. For a request whose length L (defined under Usage) is at most 939, every question is also scored with its options in other orders, and the results are averaged; longer requests use the single pass. Adds a binary Bayesian correction on averaged yes/no predictions and retains the existing binary posterior on unaveraged yes/no. Ordinary choices use native scores with temperature calibration; their current Bayesian correction controls are zero.lenavg_engine:LenAvgEngine: the same averaging without the correction on averaged yes / no questions.dikit_engine:DikitEngine: the single pass (one forward pass per question).
config.json's jev_requires_head block holds training-time labels (for example
"readout": "posterior_predictive"); the engines only check that the block is present, and the head's behaviour is as
described above.
Two parts of the model are not optional:
- Attention. In the full-attention layers, each prompt's tokens attend to every token of the same prompt; the sliding-window
layers stay causal (window 1,024). transformers' stock attention would run the full-attention layers causally and give different
answers, so the model is served with the
jev_memattention function infullft_mem.py. It registers with transformers' attention interface and runs on PyTorch SDPA (memory-efficient and flash kernels). The engine refuses any other attention. - The head. The letter logits on their own are not the model's answer.
The weights (model-*.safetensors, vbll_head.safetensors) are hosted here on the Hugging Face Hub; the GitHub mirror,
treewaterer/oenogarum, holds the code and this card only.
Usage
The engines are lenavg_bayes_engine.py, lenavg_engine.py and oavg_engine.py on top of the single-pass engine dikit_engine.py, with garas_vbll_engine.py, vbll_core.py,
fullft_mem.py, garas_engine.py and garas_core.py. They need the Decision Index kit:
pip install "git+https://github.com/apolinario/decision-index@9eb2dbe2a358004c8782c66e40a83ac07b953fec"
REPO=$(python -c "from huggingface_hub import snapshot_download; print(snapshot_download('plantwaterer/oenogarum'))")
PYTHONPATH="$REPO" python -m decision_index run --engine lenavg_bayes_engine:LenAvgBayesEngine --option model="$REPO" --compact --out runs/oenogarum
For the single pass, use --engine dikit_engine:DikitEngine instead.
In Python:
import sys
from huggingface_hub import snapshot_download
repo = snapshot_download("plantwaterer/oenogarum")
sys.path.insert(0, repo)
from lenavg_bayes_engine import LenAvgBayesEngine # needs the decision_index kit installed
engine = LenAvgBayesEngine(model=repo) # bf16 on "cuda"; the head runs on the CPU
response, _ = engine(
"The forecast gives a 70% chance of heavy rain this afternoon. The match is outdoors, on grass.",
{"plan": {"type": "choice", "instructions": "What should the organisers do?",
"criteria": {"play": "Play as planned", "indoors": "Move it indoors", "postpone": "Postpone it"}},
"rain": {"type": "noul", "instructions": "Is heavy rain likely?"}})
print(response["answers"])
The inference procedure is as follows:
- Prompts: one prompt per question, with the model's chat template and the options lettered A-Z a-z. A choice question's
options are shown in one fixed non-identity order derived from a hash of the request. Yes / no questions use the options
YesandNo; when the request gives their definitions (itscriteria), they are shown asYes: <definition>/No: <definition>. - Read-out: one forward pass per prompt. The final hidden state and the option letters' logits (fp32, with the model's logit soft-cap) go through the head, on the CPU in float64, which gives the probabilities.
- Order averaging (
lenavg_bayes_engine:LenAvgBayesEngine):- Which requests: L = the sum over the request's questions of [len(state) + len(instructions) + the sum over the question's
criteria of (len(str(key)) + len(str(value)))], with Python's
len(). A string state counts its characters; a dictionary state counts its top-level keys, not its text; a missing state counts 0. The state is counted once per question. A request is averaged if and only if L <= 939; otherwise every question takes the single pass described above. - Choice questions with up to 52 options: scored in 4 option orders, the engine's own order and 3 re-letterings
numpy.random.default_rng(20261021 + 1000 * j + K).permutation(K)for j = 1, 2, 3 (K options). For each order the head's output (the softmax of the letters' logits divided by T = 1.080) is mapped back to the options; the 4 vectors are averaged with equal weight, then raised to the power 1 / 0.95438 and renormalised. (0.95438 here and 0.93738 below are fixed constants of the engine, fitted when the averaging was built for allec and used unchanged here.) - Yes / no: the native letter softmax of the base order and of the swapped order (
Nofirst), averaged, then raised to the power 1 / 0.93738 and renormalised (p). Then the binary Bayesian correction: the head's yes / no readout is computed from the base prompt's hidden state and the log of the averaged native probabilities, once with its fitted residual and posterior variance and once with both switched off (beta = 0, infl = 0); the difference of the two log-odds is added to the log-odds of p. No extra temperature. - More than 52 options: the single pass.
- The re-lettered prompts of a request are packed into the same forward passes as its other prompts.
- Which requests: L = the sum over the request's questions of [len(state) + len(instructions) + the sum over the question's
criteria of (len(str(key)) + len(str(value)))], with Python's
- Batching: the prompts of one request run in packed rows of up to 32,768 tokens, each prompt with its own positions, so a prompt only attends to itself.
- More than 52 options: handled in two rounds.
- No truncation: a request that does not fit 32,768 tokens is reported as unsupported.
Requirements: one GPU with at least 75 GB (the bf16 weights are 62 GB). Tested on 1 x H100 80GB and 1 x RTX PRO 6000 (96 GB) with torch 2.14.1 (CUDA 13.0), transformers 5.12.1, huggingface_hub, safetensors and numpy. bf16 results differ slightly between GPU types.
Training
oenogarum is the uniform average (equal weights, in fp32) of three fine-tunes of google/gemma-4-31B-it that differ only in their random seed. Each was trained for 600 updates on the same 38,400 decision questions: a sample drawn in proportion to the composition of our full pool of about 276,000 decision questions, restricted to questions of at most 8,192 tokens. On 24,718 of the questions the training target mixes the label with the predicted distribution of a parent model, with weight 0.15; the parent is the base model google/gemma-4-31B-it for 17,334 questions and our earlier fine-tune garas for 7,384. The attention, renderer and optimiser settings are those of allec. The averaged model's head was then fitted anew on its own hidden states, on the same head fit and calibration data as allec's head.
Evaluation
Decision Index 0.3, public panel (37 benchmarks), with order averaging (lenavg_bayes_engine:LenAvgBayesEngine). The run used
this repository's weights, head and engines, with the kit's runner and scorer at commit 9eb2dbe2, in bf16. The full public suite ran as
8 row shards on single H100 80GB GPUs, merged without changes. This is our own run of the public kit, not a leaderboard entry. The run
files are at plantwaterer/oenogarum-decision-index. 94,198 of the 140,620
requests (67%) were averaged.
| public index | knowledge | language | retrieval | tools | arts | |
|---|---|---|---|---|---|---|
| board rule (the test item listed below counted as wrong) | 62.80 | 52.32 | 65.98 | 64.59 | 77.34 | 51.51 |
| as scored | 62.80 | 52.32 | 65.98 | 64.59 | 77.34 | 51.51 |
140,620 requests were run and 140,178 scored after the official exclusions; all of them were answered (0 unsupported, 0 errors). Nothing was truncated. The listed trained-on test item was answered correctly; counting it as wrong lowers the index by 0.0004.
Comparisons (pre-registered; paired bootstraps over the suite's test items with the board's own metrics, 95% intervals; they do not cover variation between training runs):
- against allec with the same engine (62.03): +0.77 points (+0.41 to +1.16);
- with the single pass (
dikit_engine:DikitEngine), these weights and head score 62.37, against allec's single pass (61.60): +0.76 points (+0.38 to +1.16).
The averaging of three seeds was decided after seeing the first seed's single-pass score (62.04); the comparisons above were registered after that and before the other two seeds were trained. The first launch of the registered comparison stopped before computing anything (a file missing on the machine that ran it) and was relaunched unchanged.
Latency (our measurement; the board measures on its own private sample): the kit runner's per-request wall time for
lenavg_bayes_engine:LenAvgBayesEngine with these weights on 1 x RTX PRO 6000, one request at a time, on 1,000 requests of the public
suite (100 drawn from each tenth of the length L, so the sample includes the longest requests); all 1,000 were answered:
| median | mean | 80th percentile | 95th percentile |
|---|---|---|---|
| 227 ms | 609 ms | 566 ms | 2,094 ms |
These are sample statistics, not a per-request bound: the slowest request in the sample took 26.1 s. A second pass over the same sample gave the same figures within 1% (median 226 ms, mean 607 ms).
Overlap with evaluation data
No test split of any benchmark was used. The head's fit and calibration data include train-split rows of CLINC150, GSM8K, Amazon ESCI, BANKING77 and WinoGrande; the training data include Lichess puzzles (a different dataset from ChessBench's).
An audit of the training text, the head's data included, against the Decision Index public suite found 1 test item that is an
exact or near-exact duplicate of a CLINC150 train-split utterance in the head's fit data: 5:CLINC150+OOS:CLINC150+OOS:test:1591.
It is counted as wrong in the board-rule number above, as the board does for train-split duplicates of test items (see the
Contamination section of the Decision Index methodology).
Licence
The weights and the head are released under Apache-2.0, and the base model, google/gemma-4-31B-it, is Apache-2.0. The training data come from the sources below, under the licences and terms listed. Some of these sources carry use conditions that apply to the data itself; they are repeated here: US Census PUMS (never use the data to identify any person or household), NVD (not endorsed or certified), California DMHC (modified; not official government data), MITRE CVE / CWE (copyright notices below) and XNLI (CC BY-NC 4.0, non-commercial; its translations are part of AmericasNLI).
Data attribution
oenogarum was trained on decision questions built from the public data sources below, plus synthetic questions generated by the author (no third-party data). Thanks to everyone who builds and maintains them. Records were reformatted, and many were modified (fields selected, text clipped, identifiers masked), so none of the material should be read as an official copy of its source.
Open data and public records
- GDELT Project: event data. Data from The GDELT Project, https://www.gdeltproject.org/.
- Wikipedia: article text from the English Wikipedia dump of 2023-11-01, via
wikimedia/wikipedia
20231101.en, by Wikipedia contributors. Licensed CC BY-SA 3.0/4.0 and GFDL. https://en.wikipedia.org/ - Wikipedia Articles for Deletion: deletion debates by English Wikipedia contributors (CC BY-SA 3.0/4.0, GFDL), via the AfD corpus of Mayfield & Black (2019), https://github.com/emayfield/AFD_Decision_Corpus (the repository's code is GPL-3.0; the corpus files are distributed separately).
- Wikidata: structured data (CC0 1.0), and Requests-for-deletion discussions by the Wikidata contributors (CC BY-SA 4.0). https://www.wikidata.org/
- Swiss Judgment Prediction XL: rcds/swiss_judgment_prediction_xl (Rasiah et al., 2023), CC BY-SA 4.0. Decisions of the Swiss Federal Supreme Court, anonymised by the court.
- NHTSA Office of Defects Investigation investigations and complaints (public domain), https://static.nhtsa.gov/odi/ffdd/
- OSHA Severe Injury Reports and enforcement data, US Department of Labor (public domain), https://www.osha.gov/severe-injury-reports
- NTSB aviation accident database (public domain), https://data.ntsb.gov/avdata
- openFDA enforcement reports and device recalls, CC0 1.0, https://open.fda.gov/
- ClinicalTrials.gov (US National Library of Medicine), via the ClinicalTrials.gov API v2; data processed by ClinicalTrials.gov on 2026-10-01. Modified: selected registration fields only, free text clipped, trial ids masked, study-status sentences removed. Some ClinicalTrials.gov data may be subject to third-party copyright outside the United States.
- ClinVar (NCBI): Landrum et al., Nucleic Acids Research 2018, PMID 29165669.
- Orphanet inheritance data, CC BY 4.0, https://www.orpha.net/
- CIViC (civicdb.org), CC0 1.0: Griffith et al., Nature Genetics 2017, PMID 28138153.
- California Department of Managed Health Care, "DMHC IMR Data, 2001 - Current", CC BY, https://data.ca.gov/dataset/independent-medical-review-imr-determinations-trend. Modified; not official government data.
- NOAA / NWS Storm Prediction Center text products (public domain), via the Iowa Environmental Mesonet, Iowa State University.
- LIGO / Virgo / KAGRA public alerts and the GWOSC event catalogue, CC BY 4.0, by the LIGO Scientific, Virgo and KAGRA Collaborations. This model uses data obtained from the Gravitational Wave Open Science Center (gwosc.org), a service of the LIGO Scientific Collaboration, the Virgo Collaboration and KAGRA.
- USGS PAGER and ComCat (public domain). Population exposure is from ORNL LandScan (CC BY 4.0).
- National Vulnerability Database (NIST, public domain) and CVE records (CVE Terms of Use; Copyright The MITRE Corporation). CWE: Copyright 2006-2026, The MITRE Corporation; CWE is a trademark of The MITRE Corporation. This product uses the NVD API but is not endorsed or certified by the NVD.
- American Community Survey PUMS, US Census Bureau (CC0 1.0), with task definitions from folktables (Ding et al., 2021; MIT). Never to be used to identify any person or household.
- OpenReview reviews and scores, CC BY 4.0 (titles and abstracts: CC0 1.0), https://openreview.net/
- Lichess open database, CC0 1.0, https://database.lichess.org/
- Amazon ESCI shopping queries, amazon-science/esci-data (Reddy et al., 2022), Apache-2.0. Copyright Amazon.com, Inc. or its affiliates.
- SWE-rebench: nebius/SWE-rebench-openhands-trajectories (Trofimova et al., 2025), CC BY 4.0.
- Open-Jev: ZefanCai/Open-Jev, CC0 1.0.
- LLM Bayesian Teaching Data: Qiu, L. (2025), Zenodo, doi:10.5281/zenodo.17677329, CC BY 4.0.
Research datasets
| dataset | reference | licence |
|---|---|---|
| BANKING77 | Casanueva et al., 2020 | CC BY 4.0 |
| CLINC150 | Larson et al., 2019 | CC BY 3.0 |
| GoEmotions | Demszky et al., 2020 | Apache-2.0 |
| GSM8K | Cobbe et al., 2021 | MIT |
| HelpSteer2 | Wang et al., 2024 | CC BY 4.0 |
| Measuring Hate Speech | Kennedy et al., 2020 | CC BY 4.0 |
| IBM Debater ArgQ-Rank-30kArgs | Gretz et al., 2019 | CC BY 3.0 |
| BBQ | Parrish et al., 2022 | CC BY 4.0 |
| CaSiNo | Chawla et al., 2021 | CC BY 4.0 |
| Circa | Louis et al., 2020 | CC BY 4.0 (dataset card; its README links CC BY-SA 4.0) |
| CodeContests | Li et al., 2022 | CC BY 4.0 |
| CosmosQA | Huang et al., 2019 | CC BY 4.0 |
| CommonsenseQA | Talmor et al., 2019 | MIT |
| e-CARE | Du et al., 2022 | MIT |
| Social IQa | Sap et al., 2019 | CC BY 4.0 |
| WinoGrande | Sakaguchi et al., 2019 | CC BY (code Apache-2.0) |
| MedMCQA | Pal et al., 2022 | Apache-2.0 |
| PubMedQA | Jin et al., 2019 | MIT |
| Stanford Politeness Corpus, via ConvoKit | Danescu-Niculescu-Mizil et al., 2013 | CC BY 4.0 |
| Scruples | Lourie et al., 2021 | Apache-2.0 |
| TabFact | Chen et al., 2020 | CC BY 4.0 |
| QASPER | Dasigi et al., 2021 | CC BY 4.0 |
| CUAD | Hendrycks et al., 2021 | CC BY 4.0 |
| TyDi QA | Clark et al., 2020 | Apache-2.0 (the Wikipedia text: CC BY-SA) |
Through tasksource (Sileo, 2024), each dataset under its own licence as recorded on its dataset page:
Community synthetic datasets
- tasksource/procedural-typed-decisions (tasksource, Sileo, 2024), Apache-2.0
- frontier-infra/jebadiah-synth-v2, Apache-2.0
- kaivoss/system-one-270m-data, Apache-2.0
- vagmi/jevlite_dataset, CC BY-SA 4.0
- mghafiri/decision-model-scenarios, MIT
- Downloads last month
- 179