File size: 3,390 Bytes
f5b5185
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# Reproduction guide

This directory contains the necessary information and assets to reproduce the results obtained during this Heretic run.
> [!IMPORTANT]
> **Git installation**
>
> This system installed Heretic from a Git repository: https://github.com/p-e-w/heretic.git @ 66a952b49b00bfd1854bdad769fee5fb225b53be
>
> To reproduce the model, you must install Heretic from this exact repository and commit.


## Models

- **Base model:** [xtools-at/Qwen3.5-4B-MultiDistill-Megamix-8xMerge](https://huggingface.co/xtools-at/Qwen3.5-4B-MultiDistill-Megamix-8xMerge) (Commit: [`f03e5d9`](https://huggingface.co/xtools-at/Qwen3.5-4B-MultiDistill-Megamix-8xMerge/commit/f03e5d9e1603ca871380f435b5fea8f315a12259))

## Datasets

- [mlabonne/harmful_behaviors](https://huggingface.co/datasets/mlabonne/harmful_behaviors) (Commit: [`01cead0`](https://huggingface.co/datasets/mlabonne/harmful_behaviors/commit/01cead01398926d81f7c52bdb790ee8cf77ebba7))
- [mlabonne/harmless_alpaca](https://huggingface.co/datasets/mlabonne/harmless_alpaca) (Commit: [`02c6a92`](https://huggingface.co/datasets/mlabonne/harmless_alpaca/commit/02c6a92cfcf11bb0c387334f8146d149d65b587f))

## Selected trial

- **Trial number:** 50
- **Refusals:** 3/100 (baseline: 95/100)
- **KL divergence:** 0.0883 (baseline: 0 *(by definition)*)

## Environment

- **Heretic:** v2.0.0.dev0 (Origin: Git (https://github.com/p-e-w/heretic.git @ 66a952b49b00bfd1854bdad769fee5fb225b53be))
- **PyTorch:** 2.11.0+cu130
- **Other dependencies:** See [`requirements.txt`](requirements.txt).

## Contents of this directory

- [`requirements.txt`](requirements.txt): The exact versions of all Python packages.
- [`config.toml`](config.toml): The exact configuration used, including the RNG seed.
- [`xtools-at--Qwen3--5-4B-MultiDistill-Megamix-8xMerge.jsonl`](xtools-at--Qwen3--5-4B-MultiDistill-Megamix-8xMerge.jsonl): The Optuna study journal containing the history of all trials.
- [`SHA256SUMS`](SHA256SUMS): Cryptographic hashes for all weight files.
- [`reproduce.json`](reproduce.json): A machine-readable file containing all reproducibility information.

## How to reproduce

> [!TIP]
> You can automate this process, including all verification steps, by downloading the `reproduce.json` file and running
> `heretic --reproduce reproduce.json`.

1. Install the exact version of Heretic indicated in the **Environment** section above, from its original source.
1. Install the packages listed in `requirements.txt`: `pip install -r requirements.txt`
1. Install the correct version of PyTorch: `pip install torch==2.11.0+cu130 --index-url https://download.pytorch.org/whl/cu130`
1. Place the provided `config.toml` in your working directory.
1. Run Heretic without any additional arguments: `heretic`
1. Wait for the run to finish, then select trial **50** and export the model.
1. 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)

> [!TIP]
> To use the included Optuna study journal `xtools-at--Qwen3--5-4B-MultiDistill-Megamix-8xMerge.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.